[ aws . ssm-incidents ]
list-timeline-events
Описание
Отображает события временной шкалы для указанного записи инцидента.
См. также: Документацию API AWS
list-timeline-events это постраничная операция. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничность, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничностью, аргумент --query должен извлекать данные из результатов следующих выражений запроса: eventSummaries
Синтаксис
list-timeline-events
[--filters <value>]
--incident-record-arn <value>
[--sort-by <value>]
[--sort-order <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 (список)
Фильтры событий временной шкалы на основе предоставленных условных значений. Вы можете фильтровать события временной шкалы по следующим ключам:
eventReferenceeventTimeeventType
Обратите внимание на следующее при определении, как использовать фильтры:
- Если вы не указываете фильтр, ответ включает все события временной шкалы.
- Если вы указываете более одного фильтра в одном запросе, ответ возвращает события временной шкалы, которые соответствуют всем фильтрам.
- Если вы указываете фильтр с более чем одним значением, ответ возвращает события временной шкалы, которые соответствуют любому из предоставленных значений.
(структура)
Фильтровать выбор, используя условие.
condition -> (структура помеченных объединений)
Условие принимает значение «до» или «после» заданного времени, равно строке или равно целому числу.
Примечание
Это структура помеченных объединений. Можно установить только один из следующих ключей верхнего уровня:after, before, equals.after -> (метка времени)
before -> (метка времени)
equals -> (структура помеченных объединений)
Значение равно указанной строке или целому числу.
Примечание
Это структура помеченных объединений. Можно установить только один из следующих ключей верхнего уровня:integerValues, stringValues.integerValues -> (список)
Список целых значений, которым соответствует фильтр.
(целое число)
stringValues -> (список)
Список строковых значений, которым соответствует фильтр.
(строка)
key -> (строка)
Синтаксис JSON:
[
{
"condition": {
"after": timestamp,
"before": timestamp,
"equals": {
"integerValues": [integer, ...],
"stringValues": ["string", ...]
}
},
"key": "string"
}
...
]
--incident-record-arn (строка)
--sort-by (строка)
Сортировать события временной шкалы по указанной паре ключ-значение.
Возможные значения:
EVENT_TIME
--sort-order (строка)
Сортирует порядок событий временной шкалы по значению, указанному в поле sortBy.
Возможные значения:
ASCENDINGDESCENDING
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет взята буквально. Это может не быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Токен, указывающий, где начать постраничную обработку. Это NextToken из ранее усеченного ответа.
Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.
--page-size (целое число)
Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, извлекая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.
Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.
--max-items (целое число)
Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для продолжения постраничной обработки предоставьте значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken непосредственно вне AWS CLI.
Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если предоставлено значение без значения или значение input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, он проверит входные данные команды и вернет пример выходного JSON для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Глобальные параметры
--debug (логическое значение)
Включить отладку регистрации.
--endpoint-url (строка)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (логическое значение)
Отключить автоматическую постраничную обработку. Если автоматическая постраничная обработка отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования для вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для использования при фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Использовать определенный регион. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- включить
- выключить
- автоматический
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.
--ca-bundle (строка)
Набор сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — 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 (логическое значение)
Отключить пейджер cli для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматический запрос параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве «Начало работы» в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. раздел Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для отображения событий временной шкалы инцидента
Следующий command-name пример отображает события временной шкалы указанного инцидента.
aws ssm-incidents list-timeline-events \
--incident-record-arn "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
Вывод:
{
"eventSummaries": [
{
"eventId": "8cbcc889-35e1-a42d-2429-d6f100799915",
"eventTime": "2021-05-21T22:36:13.766000+00:00",
"eventType": "SSM Incident Record Update",
"eventUpdatedTime": "2021-05-21T22:36:13.766000+00:00",
"incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
},
{
"eventId": "a2bcc825-aab5-1787-c605-f9bb2640d85b",
"eventTime": "2021-05-21T18:58:46.443000+00:00",
"eventType": "SSM Incident Record Update",
"eventUpdatedTime": "2021-05-21T18:58:46.443000+00:00",
"incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
},
{
"eventId": "5abcc812-89c0-b0a8-9437-1c74223d4685",
"eventTime": "2021-05-21T18:16:59.149000+00:00",
"eventType": "SSM Incident Record Update",
"eventUpdatedTime": "2021-05-21T18:16:59.149000+00:00",
"incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
},
{
"eventId": "06bcc812-8820-405e-4065-8d2b14d29b92",
"eventTime": "2021-05-21T18:16:58+00:00",
"eventType": "SSM Automation Execution Start Failure for Incident",
"eventUpdatedTime": "2021-05-21T18:16:58.689000+00:00",
"incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
},
{
"eventId": "20bcc812-8a94-4cd7-520c-0ff742111424",
"eventTime": "2021-05-21T18:16:57+00:00",
"eventType": "Custom Event",
"eventUpdatedTime": "2021-05-21T18:16:59.944000+00:00",
"incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
},
{
"eventId": "c0bcc885-a41d-eb01-b4ab-9d2de193643c",
"eventTime": "2020-10-01T20:30:00+00:00",
"eventType": "Custom Event",
"eventUpdatedTime": "2021-05-21T22:28:26.299000+00:00",
"incidentRecordArn": "arn:aws:ssm-incidents::111122223333:incident-record/Example-Response-Plan/6ebcc812-85f5-b7eb-8b2f-283e4d844308"
}
]
}
Дополнительную информацию см. в разделе Подробные сведения об инциденте в Руководстве пользователя Incident Manager.
Вывод
eventSummaries -> (список)
Подробные сведения о каждом событии, произошедшем во время инцидента.
(структура)
Подробные сведения о событии временной шкалы во время инцидента.
eventId -> (строка)
eventReferences -> (список)
Список ссылок в TimelineEvent.
(структура помеченных объединений)
Элемент, на который имеется ссылка в TimelineEvent, участвующий в инциденте или каким-либо образом связанный с ним. Вы можете указать Amazon Resource Name (ARN) для ресурса Amazon Web Services или RelatedItem идентификатор.
Примечание
Это структура помеченных объединений. Можно установить только один из следующих ключей верхнего уровня:relatedItemId, resource.relatedItemId -> (строка)
RelatedItem, на который имеется ссылка в TimelineEvent.resource -> (строка)
TimelineEvent.eventTime -> (метка времени)
eventType -> (строка)
Custom Event или Note.eventUpdatedTime -> (метка времени)
incidentRecordArn -> (строка)
nextToken -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.