Spec-Zone.ru › AWS CLI v2

[ aws . elasticache ]

describe-update-actions

Описание

Возвращает подробности о действиях обновления.

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

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

Синтаксис

  describe-update-actions
[--service-update-name <value>]
[--replication-group-ids <value>]
[--cache-cluster-ids <value>]
[--engine <value>]
[--service-update-status <value>]
[--service-update-time-range <value>]
[--update-action-status <value>]
[--show-node-level-update-status | --no-show-node-level-update-status]
[--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]

Параметры

--service-update-name (строка)

Уникальный идентификатор обновления службы

--replication-group-ids (список)

Идентификаторы групп репликации

(строка)

Синтаксис:

"string" "string" ...

--cache-cluster-ids (список)

Идентификаторы кластеров кэша

(строка)

Синтаксис:

"string" "string" ...

--engine (строка)

Двигатель Elasticache, к которому применяется обновление. Либо Valkey, Redis OSS, или Memcached.

--service-update-status (список)

Статус обновления службы

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  available
  cancelled
  expired

--service-update-time-range (структура)

Диапазон времени, указанный для поиска обновлений службы, которые находятся в доступном статусе

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

Начальная точка диапазона времени фильтра

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

Конечная точка диапазона времени фильтра

Сокращенный синтаксис:

StartTime=timestamp,EndTime=timestamp

Синтаксис JSON:

{
  "StartTime": timestamp,
  "EndTime": timestamp
}

--update-action-status (список)

Статус действия обновления.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  not-applied
  waiting-to-start
  in-progress
  stopping
  stopped
  complete
  scheduling
  scheduled
  not-applicable

--show-node-level-update-status | --no-show-node-level-update-status (булево)

Указывает, следует ли включать статус обновления на уровне узла в ответ

--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
  • таблица
  • yaml
  • yaml-поток

--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.

Для описания действий обновления

Следующий пример describe-update-actions возвращает подробности о действиях обновления.

aws elasticache describe-update-actions

Вывод:

{
    "UpdateActions": [
        {
            "ReplicationGroupId": "mycluster",
            "ServiceUpdateName": "elc-20191007-001",
            "ServiceUpdateReleaseDate": "2019-10-09T16:00:00Z",
            "ServiceUpdateSeverity": "important",
            "ServiceUpdateStatus": "available",
            "ServiceUpdateRecommendedApplyByDate": "2019-11-08T15:59:59Z",
            "ServiceUpdateType": "security-update",
            "UpdateActionAvailableDate": "2019-12-05T19:15:19.995Z",
            "UpdateActionStatus": "complete",
            "NodesUpdated": "9/9",
            "UpdateActionStatusModifiedDate": "2019-12-05T19:15:20.461Z",
            "SlaMet": "n/a",
            "Engine": "redis"
        },
        {
            "CacheClusterId": "my-memcached-cluster",
            "ServiceUpdateName": "elc-20191007-001",
            "ServiceUpdateReleaseDate": "2019-10-09T16:00:00Z",
            "ServiceUpdateSeverity": "important",
            "ServiceUpdateStatus": "available",
            "ServiceUpdateRecommendedApplyByDate": "2019-11-08T15:59:59Z",
            "ServiceUpdateType": "security-update",
            "UpdateActionAvailableDate": "2019-12-04T18:26:05.349Z",
            "UpdateActionStatus": "complete",
            "NodesUpdated": "1/1",
            "UpdateActionStatusModifiedDate": "2019-12-04T18:26:05.352Z",
            "SlaMet": "n/a",
            "Engine": "redis"
        },
        {
            "ReplicationGroupId": "my-cluster",
            "ServiceUpdateName": "elc-20191007-001",
            "ServiceUpdateReleaseDate": "2019-10-09T16:00:00Z",
            "ServiceUpdateSeverity": "important",
            "ServiceUpdateStatus": "available",
            "ServiceUpdateRecommendedApplyByDate": "2019-11-08T15:59:59Z",
            "ServiceUpdateType": "security-update",
            "UpdateActionAvailableDate": "2019-11-26T03:36:26.320Z",
            "UpdateActionStatus": "complete",
            "NodesUpdated": "4/4",
            "UpdateActionStatusModifiedDate": "2019-12-04T22:11:12.664Z",
            "SlaMet": "n/a",
            "Engine": "redis"
        },
        {
            "ReplicationGroupId": "my-cluster2",
            "ServiceUpdateName": "elc-20191007-001",
            "ServiceUpdateReleaseDate": "2019-10-09T16:00:00Z",
            "ServiceUpdateSeverity": "important",
            "ServiceUpdateStatus": "available",
            "ServiceUpdateRecommendedApplyByDate": "2019-11-08T15:59:59Z",
            "ServiceUpdateType": "security-update",
            "UpdateActionAvailableDate": "2019-11-26T01:26:01.617Z",
            "UpdateActionStatus": "complete",
            "NodesUpdated": "3/3",
            "UpdateActionStatusModifiedDate": "2019-11-26T01:26:01.753Z",
            "SlaMet": "n/a",
            "Engine": "redis"
        }
    ]
}

Дополнительная информация: Самообслуживаемые обновления в Amazon ElastiCache в Руководстве пользователя Elasticache.

Вывод

Маркер -> (строка)

Необязательный маркер, возвращённый по предыдущему запросу. Используйте этот маркер для постраничной навигации результатов данной операции. Если этот параметр указан, в ответе будут содержаться только записи, начиная с маркера, до значения, указанного в MaxRecords.

UpdateActions -> (список)

Возвращает список действий по обновлению

(структура)

Статус обновления службы для конкретной группы репликации

ReplicationGroupId -> (строка)

Идентификатор группы репликации

CacheClusterId -> (строка)

Идентификатор кластера кэша

ServiceUpdateName -> (строка)

Уникальный идентификатор обновления службы

ServiceUpdateReleaseDate -> (временная метка)

Дата, когда обновление впервые доступно

ServiceUpdateSeverity -> (строка)

Уровень важности обновления службы

ServiceUpdateStatus -> (строка)

Статус обновления службы

ServiceUpdateRecommendedApplyByDate -> (временная метка)

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

ServiceUpdateType -> (строка)

Отражает характер обновления службы

UpdateActionAvailableDate -> (временная метка)

Дата, когда обновление службы доступно для группы репликации

UpdateActionStatus -> (строка)

Статус действия обновления

NodesUpdated -> (строка)

Прогресс обновления службы в группе репликации

UpdateActionStatusModifiedDate -> (временная метка)

Дата последнего изменения UpdateActionStatus

SlaMet -> (строка)

Если да, все узлы в группе репликации были обновлены к рекомендованной дате применения. Если нет, по крайней мере один узел в группе репликации не был обновлен к рекомендованной дате применения. Если Н/Д, группа репликации была создана после рекомендованной даты применения.

NodeGroupUpdateStatus -> (список)

Статус обновления службы в группе узлов

(структура)

Статус обновления службы в группе узлов

NodeGroupId -> (строка)

Идентификатор группы узлов

NodeGroupMemberUpdateStatus -> (список)

Статус обновления службы на узле группы узлов

(структура)

Статус обновления службы на узле группы узлов

CacheClusterId -> (строка)

Идентификатор кластера кэша

CacheNodeId -> (строка)

Идентификатор узла кластера кэша

NodeUpdateStatus -> (строка)

Статус обновления узла

NodeDeletionDate -> (временная метка)

Дата удаления узла

NodeUpdateStartDate -> (временная метка)

Дата начала обновления для узла

NodeUpdateEndDate -> (временная метка)

Дата окончания обновления для узла

NodeUpdateInitiatedBy -> (строка)

Отражает, было ли обновление инициировано клиентом или применено автоматически

NodeUpdateInitiatedDate -> (временная метка)

Дата, когда триггер обновления

NodeUpdateStatusModifiedDate -> (временная метка)

Дата последнего изменения NodeUpdateStatus

CacheNodeUpdateStatus -> (список)

Статус обновления службы на узле кэша

(структура)

Статус обновления службы на узле кэша

CacheNodeId -> (строка)

Идентификатор узла кластера кэша

NodeUpdateStatus -> (строка)

Статус обновления узла

NodeDeletionDate -> (временная метка)

Дата удаления узла

NodeUpdateStartDate -> (временная метка)

Дата начала обновления для узла

NodeUpdateEndDate -> (временная метка)

Дата окончания обновления для узла

NodeUpdateInitiatedBy -> (строка)

Отражает, было ли обновление инициировано клиентом или применено автоматически

NodeUpdateInitiatedDate -> (временная метка)

Дата, когда триггер обновления

NodeUpdateStatusModifiedDate -> (временная метка)

Дата последнего изменения NodeUpdateStatus

EstimatedUpdateTime -> (строка)

Оценочное время выполнения обновления

Engine -> (строка)

Двигатель Elasticache, к которому применяется обновление. Либо Valkey, Redis OSS или Memcached.

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

Spec-Zone.ru

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