Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

describe-reserved-instances-modifications

Описание

Описывает изменения, внесенные в ваши Зарезервированные экземпляры. Если не указан ни один параметр, возвращается информация обо всех ваших запросах изменения Зарезервированных экземпляров. Если указан идентификатор изменения, возвращается только информация об определённом изменении.

Дополнительную информацию см. в руководстве пользователя Amazon EC2, раздел Изменение зарезервированных экземпляров.

Примечание

Порядок элементов в ответе, включая элементы во вложенных структурах, может меняться. Приложения не должны предполагать, что элементы появляются в определённом порядке.

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

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

Синтаксис

  describe-reserved-instances-modifications
[--reserved-instances-modification-ids <value>]
[--filters <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <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]

Параметры

--reserved-instances-modification-ids (список)

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

(строка)

Синтаксис:

"string" "string" ...

--filters (список)

Один или несколько фильтров.

  • client-token - Идентификатор идемпотентности для запроса изменения.
  • create-date - Время создания запроса на изменение.
  • effective-date - Время, когда изменение вступит в силу.
  • modification-result.reserved-instances-id - Идентификатор Зарезервированных экземпляров, созданных в рамках запроса на изменение. Этот идентификатор доступен только тогда, когда статус изменения равен fulfilled.
  • modification-result.target-configuration.availability-zone - Доступная зона для новых Зарезервированных экземпляров.
  • modification-result.target-configuration.availability-zone-id - Идентификатор доступной зоны для новых Зарезервированных экземпляров.
  • modification-result.target-configuration.instance-count - Количество новых Зарезервированных экземпляров.
  • modification-result.target-configuration.instance-type - Тип экземпляра новых Зарезервированных экземпляров.
  • reserved-instances-id - Идентификатор изменённых Зарезервированных экземпляров.
  • reserved-instances-modification-id - Идентификатор запроса на изменение.
  • status - Статус запроса на изменение Зарезервированных экземпляров (processing | fulfilled | failed).
  • status-message - Причина статуса.
  • update-date - Время последнего обновления запроса на изменение.

(структура)

Пара имя-значение фильтра, используемая для возврата более специфического списка результатов из операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определённым критериям, таким как теги, атрибуты или идентификаторы.

Если вы указываете несколько фильтров, фильтры объединяются с помощью AND, и запрос возвращает только результаты, которые соответствуют всем указанным фильтрам.

Дополнительную информацию см. в руководстве пользователя Amazon EC2, раздел Список и фильтрация с помощью CLI и API.

Имя -> (строка)

Имя фильтра. Имена фильтров чувствительны к регистру.

Значения -> (список)

Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, значения объединяются с помощью OR, и запрос возвращает все результаты, которые соответствуют любому из указанных значений.

(строка)

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

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, раздел Посторінковка.

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

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве пользователя AWS CLI, раздел Начало работы.

Если не указано иное, все примеры используют правила цитирования, аналогичные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. раздел Использование кавычек со строками в руководстве пользователя AWS CLI.

Для описания изменений Зарезервированных экземпляров

В этом примере команды описываются все запросы изменения Зарезервированных экземпляров, которые были отправлены для вашей учетной записи.

Команда:

aws ec2 describe-reserved-instances-modifications

Вывод:

{
    "ReservedInstancesModifications": [
        {
            "Status": "fulfilled",
            "ModificationResults": [
                {
                    "ReservedInstancesId": "93bbbca2-62f1-4d9d-b225-16bada29e6c7",
                    "TargetConfiguration": {
                        "AvailabilityZone": "us-east-1b",
                        "InstanceType": "m1.large",
                        "InstanceCount": 3
                    }
                },
                {
                     "ReservedInstancesId": "1ba8e2e3-aabb-46c3-bcf5-3fe2fda922e6",
                     "TargetConfiguration": {
                         "AvailabilityZone": "us-east-1d",
                         "InstanceType": "m1.xlarge",
                         "InstanceCount": 1
                     }
                 }
            ],
            "EffectiveDate": "2015-08-12T17:00:00.000Z",
            "CreateDate": "2015-08-12T17:52:52.630Z",
            "UpdateDate": "2015-08-12T18:08:06.698Z",
            "ClientToken": "c9adb218-3222-4889-8216-0cf0e52dc37e:
            "ReservedInstancesModificationId": "rimod-d3ed4335-b1d3-4de6-ab31-0f13aaf46687",
            "ReservedInstancesIds": [
                {
                    "ReservedInstancesId": "b847fa93-e282-4f55-b59a-1342f5bd7c02"
                }
            ]
        }
    ]
}

Вывод

NextToken -> (строка)

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

ReservedInstancesModifications -> (список)

Информация о модификации резервированных экземпляров.

(структура)

Описывает модификацию резервированного экземпляра.

ClientToken -> (строка)

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

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

Время создания запроса на модификацию.

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

Время, когда модификация вступит в силу.

ModificationResults -> (список)

Содержит целевые конфигурации вместе с соответствующими новыми идентификаторами резервированных экземпляров.

(структура)

Описывает запрос(ы) на модификацию.

ReservedInstancesId -> (строка)

Идентификатор резервированных экземпляров, созданных в рамках запроса на модификацию. Это поле доступно только при выполнении модификации.

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

Целевые конфигурации резервированных экземпляров, предоставленные в рамках запроса на модификацию.

AvailabilityZone -> (строка)

Зона доступности для измененных резервированных экземпляров.

InstanceCount -> (целое число)

Количество измененных резервированных экземпляров.

Примечание

Это обязательное поле для запроса.

InstanceType -> (строка)

Тип экземпляра для измененных резервированных экземпляров.

Platform -> (строка)

Сетевая платформа измененных резервированных экземпляров.

Scope -> (строка)

Применяется ли резервированный экземпляр к экземплярам в регионе или к экземплярам в конкретной зоне доступности.

AvailabilityZoneId -> (строка)

Идентификатор зоны доступности.

ReservedInstancesIds -> (список)

Идентификаторы одного или нескольких резервированных экземпляров.

(структура)

Описывает идентификатор резервированного экземпляра.

ReservedInstancesId -> (строка)

Идентификатор резервированного экземпляра.

ReservedInstancesModificationId -> (строка)

Уникальный идентификатор модификации резервированного экземпляра.

Status -> (строка)

Статус запроса на модификацию резервированных экземпляров.

StatusMessage -> (строка)

Причина статуса.

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

Время последнего обновления запроса на модификацию.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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