describe-replace-root-volume-tasks
Описание
Описывает задачу замены корневого тома. Дополнительную информацию см. в разделе Замена корневого тома в руководстве пользователя Amazon EC2.
См. также: Документацию API AWS
describe-replace-root-volume-tasks является постраничной операцией. Для получения всего набора результатов могут быть вызваны несколько API-запросов. Вы можете отключить постраничную загрузку, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответ на постраничную загрузку, аргумент --query должен извлечь данные из результатов следующих выражений запроса: ReplaceRootVolumeTasks
Синтаксис
describe-replace-root-volume-tasks
[--replace-root-volume-task-ids <value>]
[--filters <value>]
[--dry-run | --no-dry-run]
[--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]
Параметры
--replace-root-volume-task-ids (список)
Идентификатор задачи замены корневого тома для просмотра.
(строка)
Синтаксис:
"string" "string" ...
--filters (список)
Фильтр для использования:
-
instance-id- Идентификатор экземпляра, для которого была создана задача замены корневого тома.
(структура)
Пара имя-значение фильтра, используемая для возвращения более конкретного списка результатов из операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определенным критериям, таким как теги, атрибуты или идентификаторы.
Если вы указываете несколько фильтров, фильтры объединяются с AND , и запрос возвращает только результаты, соответствующие всем указанным фильтрам.
Дополнительную информацию см. в разделе Список и фильтрация с помощью командной строки и API в руководстве пользователя Amazon EC2.
Имя -> (строка)
Значения -> (список)
Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, значения объединяются с OR , и запрос возвращает все результаты, соответствующие любому из указанных значений.
(строка)
Сокращенный синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "string",
"Values": ["string", ...]
}
...
]
--dry-run | --no-dry-run (логическое значение)
DryRunOperation . В противном случае это UnauthorizedOperation .--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
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Выражение JMESPath для использования при фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- включено
- выключено
- автоматически
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл сертификата CA для использования при проверке сертификатов SSL. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 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.
Пример 1: Просмотр информации о конкретной задаче замены корневого тома
Следующий пример описывает задачу замены корневого тома replacevol-0111122223333abcd.
aws ec2 describe-replace-root-volume-tasks \
--replace-root-volume-task-ids replacevol-0111122223333abcd
Вывод:
{
"ReplaceRootVolumeTasks": [
{
"ReplaceRootVolumeTaskId": "replacevol-0111122223333abcd",
"Tags": [],
"InstanceId": "i-0123456789abcdefa",
"TaskState": "succeeded",
"StartTime": "2022-03-14T15:16:28Z",
"CompleteTime": "2022-03-14T15:16:52Z"
}
]
}
Дополнительную информацию см. в разделе Замена корневого тома в руководстве пользователя Amazon Elastic Compute Cloud.
Пример 2: Просмотр информации обо всех задачах замены корневого тома для конкретного экземпляра
Следующий пример описывает все задачи замены корневого тома для экземпляра i-0123456789abcdefa.
aws ec2 describe-replace-root-volume-tasks \
--filters Name=instance-id,Values=i-0123456789abcdefa
Вывод:
{
"ReplaceRootVolumeTasks": [
{
"ReplaceRootVolumeTaskId": "replacevol-0111122223333abcd",
"Tags": [],
"InstanceId": "i-0123456789abcdefa",
"TaskState": "succeeded",
"StartTime": "2022-03-14T15:06:38Z",
"CompleteTime": "2022-03-14T15:07:03Z"
},
{
"ReplaceRootVolumeTaskId": "replacevol-0444455555555abcd",
"Tags": [],
"InstanceId": "i-0123456789abcdefa",
"TaskState": "succeeded",
"StartTime": "2022-03-14T15:16:28Z",
"CompleteTime": "2022-03-14T15:16:52Z"
}
]
}
Дополнительную информацию см. в разделе Замена корневого тома в руководстве пользователя Amazon Elastic Compute Cloud.
Вывод
ReplaceRootVolumeTasks -> (список)
Информация о задаче замены корневого тома.
(структура)
Информация о задаче замены корневого тома.
ReplaceRootVolumeTaskId -> (строка)
InstanceId -> (строка)
TaskState -> (строка)
Состояние задачи. Задача может находиться в одном из следующих состояний:
-
pending- создаётся том для замены. -
in-progress- исходный том отсоединяется, а том для замены подключается. -
succeeded- том для замены успешно подключён к экземпляру, и экземпляр доступен. -
failing- задача замены терпит неудачу. -
failed- задача замены завершилась неудачно, но исходный корневой том всё ещё подключён. -
failing-detached- задача замены терпит неудачу. Возможен случай, когда у экземпляра нет подключённого корневого тома. -
failed-detached- задача замены завершилась неудачно, и у экземпляра нет подключённого корневого тома.
StartTime -> (строка)
CompleteTime -> (строка)
Tags -> (список)
Теги, назначенные задаче.
(структура)
Описание тега.
Key -> (строка)
Ключ тега.
Ограничения: ключи тегов чувствительны к регистру и принимают максимум 127 символов Юникода. Не могут начинаться с aws:.
Value -> (строка)
Значение тега.
Ограничения: значения тегов чувствительны к регистру и принимают максимум 256 символов Юникода.
ImageId -> (строка)
SnapshotId -> (строка)
DeleteReplacedRootVolume -> (булево)
NextToken -> (строка)
null, если больше элементов возвращать не нужно.
© Copyright 2025, Amazon Web Services. Created using Sphinx.