Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

bundle-instance

Описание

Архивирует виртуальную машину Windows с хранилищем Amazon instance store.

Во время архивирования архивируется только том корневого устройства (C:). Данные на других томах хранилища экземпляра не сохраняются.

Примечание

Данное действие неприменимо для Linux/Unix экземпляров или экземпляров Windows, которые основаны на Amazon EBS.

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

Синтаксис

  bundle-instance
--instance-id <value>
[--storage <value>]
[--dry-run | --no-dry-run]
[--bucket <value>]
[--prefix <value>]
[--owner-akid <value>]
[--owner-sak <value>]
[--policy <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]

Параметры

--instance-id (строка)

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

По умолчанию: Нет

--storage (структура)

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

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

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

AWSAccessKeyId -> (строка)

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

Bucket -> (строка)

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

Prefix -> (строка)

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

UploadPolicy -> (бинарные данные)

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

UploadPolicySignature -> (строка)

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

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

S3={AWSAccessKeyId=string,Bucket=string,Prefix=string,UploadPolicy=blob,UploadPolicySignature=string}

Синтаксис JSON:

{
  "S3": {
    "AWSAccessKeyId": "string",
    "Bucket": "string",
    "Prefix": "string",
    "UploadPolicy": blob,
    "UploadPolicySignature": "string"
  }
}

--dry-run | --no-dry-run (логическое значение)

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

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

--prefix (строка) Префикс для имён компонентов изображения, хранящихся в Amazon S3.

--owner-akid (строка) Идентификатор ключа доступа владельца ведра Amazon S3.

--owner-sak (строка) Секретный ключ доступа AWS для владельца ведра Amazon S3, указанного в параметре –bucket. Этот параметр необходим для вычисления подписи политики.

--policy (строка) Политика загрузки Amazon S3, предоставляющая Amazon EC2 разрешение на загрузку элементов в Amazon S3 от имени пользователя. Если вы предоставляете этот параметр, вам также необходимо предоставить свой секретный ключ доступа, чтобы мы могли создать для вас подпись политики (секретный ключ доступа не передаётся Amazon EC2). Если вы не предоставляете этот параметр, мы автоматически генерируем политику загрузки. Дополнительную информацию о политиках загрузки можно найти в разделах о построении и подписях политик в руководстве разработчика Amazon Simple Storage Service.

--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-auto-prompt (логическое значение)

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

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

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

Примеры

Примечание

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

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

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

В этом примере экземпляр i-1234567890abcdef0 архивируется в ведро под названием bundletasks. Перед указанием значений для своих идентификаторов ключей доступа, ознакомьтесь и следуйте рекомендациям в разделе «Рекомендации по управлению ключами доступа AWS».

Команда:

aws ec2 bundle-instance --instance-id i-1234567890abcdef0 --bucket bundletasks --prefix winami --owner-akid AK12AJEXAMPLE --owner-sak example123example

Вывод:

{
  "BundleTask": {
    "UpdateTime": "2015-09-15T13:30:35.000Z",
    "InstanceId": "i-1234567890abcdef0",
    "Storage": {
      "S3": {
        "Prefix": "winami",
        "Bucket": "bundletasks"
      }
    },
    "State": "pending",
    "StartTime": "2015-09-15T13:30:35.000Z",
    "BundleId": "bun-294e041f"
  }
}

Вывод

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

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

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