Spec-Zone.ru › AWS CLI v2

[ aws . devops-guru ]

list-events

Описание

Возвращает список событий, испущенных ресурсами, которые анализируются DevOps Guru. Вы можете использовать фильтры для указания, какие события будут возвращены.

См. также: Документацию API AWS

list-events это постраничная операция. Для получения всего набора результатов могут быть отправлены несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничностью, аргумент --query должен извлекать данные из результатов следующих выражений запроса: Events

Синтаксис

  list-events
--filters <value>
[--account-id <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--filters (структура)

Объект ListEventsFilters, используемый для указания, какие события нужно вернуть.

InsightId -> (строка)

Идентификатор инсайта, относящегося к событиям, для которых вы хотите выполнить фильтрацию.

EventTimeRange -> (структура)

Диапазон времени, в течение которого должны произойти отфильтрованные события.

FromTime -> (метка времени)

Время начала события.

ToTime -> (метка времени)

Время окончания события.

EventClass -> (строка)

Класс событий, которые вы хотите отфильтровать, например, изменение инфраструктуры, развертывание или изменение схемы.

EventSource -> (строка)

Источник Amazon Web Services, который испустил события, для которых вы хотите выполнить фильтрацию.

DataSource -> (строка)

Источник, AWS_CLOUD_TRAIL или AWS_CODE_DEPLOY , событий, которые вы хотите получить.

ResourceCollection -> (структура)

Коллекция ресурсов Amazon Web Services, поддерживаемых DevOps Guru. Два типа поддерживаемых коллекций ресурсов Amazon Web Services — это стеки Amazon Web Services CloudFormation и ресурсы Amazon Web Services, содержащие одинаковые теги Amazon Web Services. DevOps Guru можно настроить на анализ ресурсов Amazon Web Services, определенных в стеках или помеченных одинаковым тегом ключ . Вы можете указать до 500 стеков Amazon Web Services CloudFormation.

CloudFormation -> (структура)

Массив имен стеков Amazon Web Services CloudFormation. Стек определяет ресурсы Amazon Web Services, которые анализирует DevOps Guru. Вы можете указать до 500 стеков Amazon Web Services CloudFormation.

StackNames -> (список)

Массив имен стеков CloudFormation.

(строка)

Tags -> (список)

Теги Amazon Web Services, используемые ресурсами в коллекции ресурсов.

Теги помогают вам идентифицировать и организовывать ресурсы Amazon Web Services. Многие службы Amazon Web Services поддерживают теги, поэтому вы можете назначать один и тот же тег ресурсам из разных служб, чтобы указать, что ресурсы связаны. Например, вы можете назначить один и тот же тег ресурсу таблицы Amazon DynamoDB, который вы назначаете функции Lambda. Дополнительную информацию об использовании тегов см. в документе «Рекомендации по использованию тегов».

Каждый тег Amazon Web Services имеет две части.

  • Ключ тега (например, CostCenter , Environment , Project или Secret ). Ключи тегов чувствительны к регистру.
  • Необязательное поле, известное как значение тега (например, 111122223333 , Production или имя команды). Пропуск значения тега эквивалентно использованию пустой строки. Значения тегов, так же как и ключи тегов, чувствительны к регистру.

Вместе они известны как пары ключ -значение.

Предупреждение

Строка, используемая в качестве ключа в теге, который вы используете для определения охвата ресурсов, должна начинаться с префикса Devops-guru- . Ключ тега может быть DevOps-Guru-deployment-application или devops-guru-rds-application . При создании ключа регистр символов в ключе может быть любым. После создания ключа он чувствителен к регистру. Например, DevOps Guru работает с ключом, названным devops-guru-rds и ключом, названным DevOps-Guru-RDS , и они действуют как два разных ключа. Возможные пары ключ /значение в вашем приложении могут быть Devops-Guru-production-application/RDS или Devops-Guru-production-application/containers .

(структура)

Коллекция тегов Amazon Web Services.

Теги помогают вам идентифицировать и организовывать ресурсы Amazon Web Services. Многие службы Amazon Web Services поддерживают теги, поэтому вы можете назначать один и тот же тег ресурсам из разных служб, чтобы указать, что ресурсы связаны. Например, вы можете назначить один и тот же тег ресурсу таблицы Amazon DynamoDB, который вы назначаете функции Lambda. Дополнительную информацию об использовании тегов см. в документе «Рекомендации по использованию тегов».

Каждый тег Amazon Web Services имеет две части.

  • Ключ тега (например, CostCenter , Environment , Project или Secret ). Ключи тегов чувствительны к регистру.
  • Необязательное поле, известное как значение тега (например, 111122223333 , Production или имя команды). Пропуск значения тега эквивалентно использованию пустой строки. Значения тегов, так же как и ключи тегов, чувствительны к регистру.

Вместе они известны как пары ключ -значение.

Предупреждение

Строка, используемая в качестве ключа в теге, который вы используете для определения охвата ресурсов, должна начинаться с префикса Devops-guru- . Ключ тега может быть DevOps-Guru-deployment-application или devops-guru-rds-application . При создании ключа регистр символов в ключе может быть любым. После создания ключа он чувствителен к регистру. Например, DevOps Guru работает с ключом, названным devops-guru-rds и ключом, названным DevOps-Guru-RDS , и они действуют как два разных ключа. Возможные пары ключ /значение в вашем приложении могут быть Devops-Guru-production-application/RDS или Devops-Guru-production-application/containers .

AppBoundaryKey -> (строка)

Ключ тега Amazon Web Services, используемый для идентификации ресурсов Amazon Web Services, которые анализирует DevOps Guru. Все ресурсы Amazon Web Services в вашей учетной записи и регионе, помеченные этим ключом, составляют границу приложения и анализа DevOps Guru.

Предупреждение

Строка, используемая в качестве ключа в теге, который вы используете для определения охвата ресурсов, должна начинаться с префикса Devops-guru- . Ключ тега может быть DevOps-Guru-deployment-application или devops-guru-rds-application . При создании ключа регистр символов в ключе может быть любым. После создания ключа он чувствителен к регистру. Например, DevOps Guru работает с ключом, названным devops-guru-rds и ключом, названным DevOps-Guru-RDS , и они действуют как два разных ключа. Возможные пары ключ /значение в вашем приложении могут быть Devops-Guru-production-application/RDS или Devops-Guru-production-application/containers .

TagValues -> (список)

Значения в коллекции тегов Amazon Web Services.

Значение тега — это необязательное поле, используемое для сопоставления строки с ключом тега (например, 111122223333 , Production или имя команды). Пара ключ и значение — это пара ключ тега. Пропуск значения тега эквивалентно использованию пустой строки. Значения тегов, так же как и ключи тегов, чувствительны к регистру. Вы можете указать не более 256 символов для значения тега.

(строка)

Синтаксис JSON:

{
  "InsightId": "string",
  "EventTimeRange": {
    "FromTime": timestamp,
    "ToTime": timestamp
  },
  "EventClass": "INFRASTRUCTURE"|"DEPLOYMENT"|"SECURITY_CHANGE"|"CONFIG_CHANGE"|"SCHEMA_CHANGE",
  "EventSource": "string",
  "DataSource": "AWS_CLOUD_TRAIL"|"AWS_CODE_DEPLOY",
  "ResourceCollection": {
    "CloudFormation": {
      "StackNames": ["string", ...]
    },
    "Tags": [
      {
        "AppBoundaryKey": "string",
        "TagValues": ["string", ...]
      }
      ...
    ]
  }
}

--account-id (строка)

Идентификатор учетной записи Amazon Web Services.

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные JSON. Передача произвольных двоичных значений с помощью предоставленного значения JSON невозможна, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Маркер для указания, где начать постраничную обработку. Это NextToken из ранее усеченного ответа.

Примеры использования см. в разделе Постраничность в руководстве пользователя AWS CLI.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-службы. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-службы, извлекая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-службы.

Примеры использования см. в разделе Постраничность в руководстве пользователя AWS CLI.

--max-items (целое число)

Общее количество элементов, которые нужно вернуть в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для возобновления постраничной обработки укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken непосредственно вне AWS CLI.

Примеры использования см. в разделе Постраничность в руководстве пользователя AWS CLI.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. При предоставлении значения output он проверит входные данные команды и вернет образец выходного JSON для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (boolean)

Включить отладку логирования.

--endpoint-url (string)

Переопределить стандартный URL команды заданным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI проверяет SSL-сертификаты. Этот параметр переопределяет стандартное поведение проверки SSL-сертификатов.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команд.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определённый профиль из файла ключей.

--region (string)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/выключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (boolean)

Не подписывать запросы. Ключи доступа не будут загружены, если этот параметр указан.

--ca-bundle (string)

Файл с сертификатом CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде строки, закодированной в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и использовать содержимое файла напрямую независимо от настроек cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного формата cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (boolean)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (boolean)

Автоматически запрашивать входные параметры CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическую запрос входных параметров CLI.

Вывод

Events -> (список)

Список запрошенных событий.

(структура)

Событие ресурса Amazon Web Services. События и метрики ресурсов Amazon Web Services анализируются DevOps Guru для выявления аномального поведения и предоставления рекомендаций по улучшению операционных решений.

ResourceCollection -> (структура)

Коллекция поддерживаемых DevOps Guru ресурсов Amazon Web Services. Два типа поддерживаемых коллекций ресурсов Amazon Web Services — стеки Amazon Web Services CloudFormation и ресурсы Amazon Web Services с одинаковым тегом. DevOps Guru может быть настроен на анализ ресурсов Amazon Web Services, определённых в стеках или имеющих тот же тег. Вы можете указать до 500 стеков Amazon Web Services CloudFormation.

CloudFormation -> (структура)

Массив имён стеков Amazon Web Services CloudFormation. Стеки определяют ресурсы Amazon Web Services, которые анализирует DevOps Guru. Вы можете указать до 500 стеков Amazon Web Services CloudFormation.

StackNames -> (список)

Массив имён стеков CloudFormation.

(строка)

Tags -> (список)

Теги Amazon Web Services, используемые ресурсами в коллекции ресурсов.

Теги помогают идентифицировать и организовать ваши ресурсы Amazon Web Services. Многие сервисы Amazon Web Services поддерживают теги, поэтому вы можете назначить один и тот же тег ресурсам из разных сервисов, чтобы указать, что они связаны. Например, вы можете назначить один и тот же тег ресурсу таблицы Amazon DynamoDB и функции Lambda. Дополнительную информацию об использовании тегов можно найти в техническом документе «Рекомендации по использованию тегов».

У каждого тега Amazon Web Services есть две части.

  • Ключ тега (например, CostCenter , Environment , Project или Secret ). Ключи тегов чувствительны к регистру.
  • Необязательное поле, известное как значение тега (например, 111122223333 , Production или имя команды). Пропуск значения тега эквивалентен использованию пустой строки. Значения тегов, как и ключи, чувствительны к регистру.

Вместе они известны как пары «ключ-значение».

Предупреждение

Строка, используемая в качестве ключа тега для определения охвата ресурсов, должна начинаться с префикса Devops-guru- . Ключ тега может быть DevOps-Guru-deployment-application или devops-guru-rds-application . При создании ключа регистр символов в ключе может быть любым. После создания ключ чувствителен к регистру. Например, DevOps Guru работает с ключом devops-guru-rds и ключом DevOps-Guru-RDS, и они действуют как два разных ключа. Возможные пары «ключ-значение» в вашем приложении могут быть Devops-Guru-production-application/RDS или Devops-Guru-production-application/containers.

(структура)

Коллекция тегов Amazon Web Services.

Теги помогают идентифицировать и организовать ваши ресурсы Amazon Web Services. Многие сервисы Amazon Web Services поддерживают теги, поэтому вы можете назначить один и тот же тег ресурсам из разных сервисов, чтобы указать, что они связаны. Например, вы можете назначить один и тот же тег ресурсу таблицы Amazon DynamoDB и функции Lambda. Дополнительную информацию об использовании тегов можно найти в техническом документе «Рекомендации по использованию тегов».

У каждого тега Amazon Web Services есть две части.

  • Ключ тега (например, CostCenter , Environment , Project или Secret ). Ключи тегов чувствительны к регистру.
  • Необязательное поле, известное как значение тега (например, 111122223333 , Production или имя команды). Пропуск значения тега эквивалентен использованию пустой строки. Значения тегов, как и ключи, чувствительны к регистру.

Вместе они известны как пары «ключ-значение».

Предупреждение

Строка, используемая в качестве ключа тега для определения охвата ресурсов, должна начинаться с префикса Devops-guru- . Ключ тега может быть DevOps-Guru-deployment-application или devops-guru-rds-application . При создании ключа регистр символов в ключе может быть любым. После создания ключ чувствителен к регистру. Например, DevOps Guru работает с ключом devops-guru-rds и ключом DevOps-Guru-RDS, и они действуют как два разных ключа. Возможные пары «ключ-значение» в вашем приложении могут быть Devops-Guru-production-application/RDS или Devops-Guru-production-application/containers.

AppBoundaryKey -> (строка)

Ключ тега Amazon Web Services, используемый для идентификации ресурсов Amazon Web Services, которые анализирует DevOps Guru. Все ресурсы Amazon Web Services в вашей учётной записи и регионе, помеченные этим ключом, составляют границу приложения и анализа DevOps Guru.

Предупреждение

Строка, используемая в качестве ключа тега для определения охвата ресурсов, должна начинаться с префикса Devops-guru- . Ключ тега может быть DevOps-Guru-deployment-application или devops-guru-rds-application . При создании ключа регистр символов в ключе может быть любым. После создания ключ чувствителен к регистру. Например, DevOps Guru работает с ключом devops-guru-rds и ключом DevOps-Guru-RDS, и они действуют как два разных ключа. Возможные пары «ключ-значение» в вашем приложении могут быть Devops-Guru-production-application/RDS или Devops-Guru-production-application/containers.

TagValues -> (список)

Значения в коллекции тегов Amazon Web Services.

Значение тега — необязательное поле, используемое для сопоставления строки с ключом тега (например, 111122223333 , Production или имя команды). Пара «ключ-значение» — это пара тега. Пропуск значения тега эквивалентен использованию пустой строки. Значения тегов, как и ключи, чувствительны к регистру. Для значения тега можно указать максимум 256 символов.

(строка)

Id -> (строка)

Идентификатор события.

Time -> (метка времени)

Метка времени, указывающая момент возникновения события.

EventSource -> (строка)

Источник Amazon Web Services, который породил событие.

Name -> (строка)

Название события.

DataSource -> (строка)

Источник, AWS_CLOUD_TRAIL или AWS_CODE_DEPLOY, где DevOps Guru обнаружил событие.

EventClass -> (строка)

Класс события. Класс указывает, к чему относится событие, например, к изменению инфраструктуры, развертыванию или изменению схемы.

Resources -> (список)

Объект, содержащий информацию о ресурсе, который породил событие.

(структура)

Ресурс Amazon Web Services, который породил событие. События и метрики ресурсов Amazon Web Services анализируются DevOps Guru для выявления аномального поведения и предоставления рекомендаций по улучшению операционных решений.

Type -> (строка)

Тип ресурса, который породил событие.

Name -> (строка)

Имя ресурса, который породил событие.

Arn -> (строка)

Amazon Resource Name (ARN) ресурса, который породил событие.

NextToken -> (строка)

Токен постраничной навигации для получения следующей страницы результатов для данной операции. Если больше страниц нет, это значение равно null.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API