Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

describe-bundle-tasks

Описание

Описывает указанные задачи создания образов или все ваши задачи создания образов.

Примечание

Завершенные задачи создания образов отображаются в течение ограниченного времени. Если ваша задача создания образа больше не отображается в списке, вы всё ещё можете зарегистрировать AMI из неё. Просто используйте RegisterImage с именем ведра Amazon S3 и именем манифеста образа, которые вы предоставили для задачи создания образа.

Примечание

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

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

Синтаксис

  describe-bundle-tasks
[--bundle-ids <value>]
[--dry-run | --no-dry-run]
[--filters <value>]
[--cli-input-json | --cli-input-yaml]
[--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]

Параметры

--bundle-ids (список)

Идентификаторы задач создания образов.

По умолчанию: описывает все ваши задачи создания образов.

(строка)

Синтаксис:

"string" "string" ...

--dry-run | --no-dry-run (булево)

Проверяет, есть ли у вас необходимые разрешения для действия, без фактического выполнения запроса, и предоставляет ответ об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке будет DryRunOperation . В противном случае, это UnauthorizedOperation .

--filters (список)

Фильтры.

  • bundle-id - Идентификатор задачи создания образа.
  • error-code - Если задача завершилась неудачей, код ошибки, возвращённый.
  • error-message - Если задача завершилась неудачей, возвращённое сообщение об ошибке.
  • instance-id - Идентификатор экземпляра.
  • progress - Уровень завершения задачи в процентах (например, 20%).
  • s3-bucket - Ведро Amazon S3 для хранения AMI.
  • s3-prefix - Начало имени AMI.
  • start-time - Время начала задачи (например, 2013-09-15T17:15:20.000Z).
  • state - Состояние задачи (pending | waiting-for-shutdown | bundling | storing | cancelling | complete | failed ).
  • update-time - Время последнего обновления для задачи.

(структура)

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

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

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

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

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

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

Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, значения объединяются с помощью 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.

--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 (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 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-bundle-tasks

Вывод:

{
  "BundleTasks": [
    {
      "UpdateTime": "2015-09-15T13:26:54.000Z",
      "InstanceId": "i-1234567890abcdef0",
      "Storage": {
        "S3": {
            "Prefix": "winami",
            "Bucket": "bundletasks"
        }
      },
      "State": "bundling",
      "StartTime": "2015-09-15T13:24:35.000Z",
      "Progress": "3%",
      "BundleId": "bun-2a4e041c"
    }
  ]
}

Вывод

BundleTasks -> (список)

Информация о задачах создания образов.

(структура)

Описание задачи создания образа.

InstanceId -> (строка)

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

BundleId -> (строка)

Идентификатор задачи создания образа.

State -> (строка)

Состояние задачи.

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

Время начала задачи.

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

Время последнего обновления задачи.

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

Расположения хранилища Amazon S3.

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

Расположение хранилища Amazon S3.

AWSAccessKeyId -> (строка)

Идентификатор ключа доступа владельца ведра. Перед указанием значения для своего идентификатора ключа доступа ознакомьтесь и следуйте инструкциям в разделе «Рекомендации по работе с учетными записями Amazon Web Services» в Руководстве по администрированию учетных записей.

Bucket -> (строка)

Ведро, в котором нужно хранить AMI. Вы можете указать ведро, которое вам принадлежит, или новое ведро, которое Amazon EC2 создаст от вашего имени. Если вы укажете ведро, принадлежащее другому пользователю, Amazon EC2 вернёт ошибку.

Prefix -> (строка)

Начало имени файла AMI.

UploadPolicy -> (двоичные данные)

Политика загрузки Amazon S3, которая предоставляет Amazon EC2 разрешение на загрузку элементов в Amazon S3 от вашего имени.

UploadPolicySignature -> (строка)

Подпись JSON-документа.

Progress -> (строка)

Уровень завершения задачи в процентах (например, 20%).

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

Если задача завершилась неудачей, описание ошибки.

Code -> (строка)

Код ошибки.

Message -> (строка)

Сообщение об ошибке.

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

Spec-Zone.ru

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