describe-events
Описание
Возвращает события, связанные с экземплярами баз данных, кластерами баз данных, группами параметров баз данных, группами безопасности баз данных, снимками баз данных, снимками кластеров баз данных и прокси RDS за последние 14 дней. События, специфичные для конкретного экземпляра базы данных, кластера баз данных, группы параметров баз данных, группы безопасности баз данных, снимка базы данных, группы снимков кластера баз данных или прокси RDS, могут быть получены путём указания имени в качестве параметра.
Для получения дополнительной информации о работе с событиями, обратитесь к разделу Мониторинг событий Amazon RDS в Руководстве пользователя Amazon RDS и Мониторинг событий Amazon Aurora в Руководстве пользователя Amazon Aurora.
Примечание
По умолчанию RDS возвращает события, сгенерированные в течение последнего часа.См. также: Документация API AWS
describe-events это постраничная операция. Для получения всего набора результатов может потребоваться несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничностью, аргумент --query должен извлекать данные из результатов следующих выражений запроса: Events
Синтаксис
describe-events
[--source-identifier <value>]
[--source-type <value>]
[--start-time <value>]
[--end-time <value>]
[--duration <value>]
[--event-categories <value>]
[--filters <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]
Параметры
--source-identifier (строка)
Идентификатор источника событий, для которого возвращаются события. Если не указано, в ответ включаются все источники.
Ограничения:
- Если указан
SourceIdentifier, также необходимо указатьSourceType. - Если тип источника — экземпляр базы данных, должен быть указан
DBInstanceIdentifier. - Если тип источника — кластер баз данных, должен быть указан
DBClusterIdentifier. - Если тип источника — группа параметров базы данных, должен быть указан
DBParameterGroupName. - Если тип источника — группа безопасности базы данных, должен быть указан
DBSecurityGroupName. - Если тип источника — снимок базы данных, должен быть указан
DBSnapshotIdentifier. - Если тип источника — снимок кластера баз данных, должен быть указан
DBClusterSnapshotIdentifier. - Если тип источника — прокси RDS, должен быть указан
DBProxyName. - Не может оканчиваться на дефис и не может содержать два дефиса подряд.
--source-type (строка)
Источник событий, для которого нужно получить события. Если значение не указано, возвращаются все события.
Возможные значения:
db-instancedb-parameter-groupdb-security-groupdb-snapshotdb-clusterdb-cluster-snapshotcustom-engine-versiondb-proxyblue-green-deployment
--start-time (метка времени)
Начало временного интервала, для которого нужно получить события, указанное в формате ISO 8601. Подробнее о формате ISO 8601 см. на странице Википедии ISO8601.
Пример: 2009-07-08T18:00Z
--end-time (метка времени)
Конец временного интервала, для которого нужно получить события, указанный в формате ISO 8601. Подробнее о формате ISO 8601 см. на странице Википедии ISO8601.
Пример: 2009-07-08T18:00Z
--duration (целое число)
Количество минут, для которых нужно получить события.
По умолчанию: 60
--event-categories (список)
Список категорий событий, которые вызывают уведомления для подписки на уведомления о событиях.
(строка)
Синтаксис:
"string" "string" ...
--filters (список)
В настоящее время этот параметр не поддерживается.
(структура)
Пара имя-значение фильтра, используемая для возвращения более конкретного списка результатов операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определенным критериям, например, идентификаторам. Поддерживаемые фильтры операции describe документированы вместе с операцией describe.
Примечание
В настоящее время в фильтрах не поддерживаются подстановочные знаки.Следующие действия можно отфильтровать:
DescribeDBClusterBacktracksDescribeDBClusterEndpointsDescribeDBClustersDescribeDBInstancesDescribeDBRecommendationsDescribeDBShardGroupsDescribePendingMaintenanceActions
Имя -> (строка)
Значения -> (список)
Одно или несколько значений фильтра. Значения фильтров чувствительны к регистру.
(строка)
Сокращенный синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "string",
"Values": ["string", ...]
}
...
]
--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 (строка)
Включение/отключение цветного вывода.
- on
- off
- auto
--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-auto-prompt (булево)
Автоматически запрашивать параметры входных данных CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическое запрошенie параметров входных данных CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробнее см. руководство для начинающих в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования, характерные для Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для описания событий
Следующий пример describe-events показывает, как получить сведения о событиях, произошедших для указанного экземпляра базы данных.
aws rds describe-events \
--source-identifier test-instance \
--source-type db-instance
Вывод:
{
"Events": [
{
"SourceType": "db-instance",
"SourceIdentifier": "test-instance",
"EventCategories": [
"backup"
],
"Message": "Backing up DB instance",
"Date": "2018-07-31T23:09:23.983Z",
"SourceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance"
},
{
"SourceType": "db-instance",
"SourceIdentifier": "test-instance",
"EventCategories": [
"backup"
],
"Message": "Finished DB Instance backup",
"Date": "2018-07-31T23:15:13.049Z",
"SourceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance"
}
]
}
Вывод
Маркер -> (строка)
MaxRecords.События -> (список)
Список экземпляров Event.
(структура)
Этот тип данных используется в качестве элемента ответа в действии DescribeEvents.
ИсточникИдентификатор -> (строка)
ТипИсточника -> (строка)
Сообщение -> (строка)
КатегорииСобытий -> (список)
Указывает категорию события.
(строка)
Дата -> (метка времени)
ARNИсточника -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.