Spec-Zone.ru › AWS CLI v2

[ aws . storagegateway ]

create-tape-with-barcode

Описание

Создает виртуальную ленту, используя собственный штрихкод. Вы записываете данные на виртуальную ленту, а затем архивируете ее. Штрихкод уникален и не может быть повторно использован, если он уже был использован на ленте. Это относится к штрихкодам, используемым на удаленных лентах. Эта операция поддерживается только в типе шлюза лент.

Примечание

Хранилище кэша должно быть выделено для шлюза, прежде чем вы сможете создать виртуальную ленту. Используйте операцию AddCache, чтобы добавить хранилище кэша к шлюзу.

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

Синтаксис

  create-tape-with-barcode
--gateway-arn <value>
--tape-size-in-bytes <value>
--tape-barcode <value>
[--kms-encrypted | --no-kms-encrypted]
[--kms-key <value>]
[--pool-id <value>]
[--worm | --no-worm]
[--tags <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]

Параметры

--gateway-arn (строка)

Уникальный Amazon Resource Name (ARN), представляющий шлюз, с которым будет связана виртуальная лента. Используйте операцию ListGateways для возврата списка шлюзов для вашей учетной записи и региона Amazon Web Services.

--tape-size-in-bytes (целое число)

Размер виртуальной ленты в байтах, которую вы хотите создать.

Примечание

Размер должен быть кратен гигабайту (1024*1024*1024 байта).

--tape-barcode (строка)

Штрихкод, который вы хотите назначить ленте.

Примечание

Штрихкоды не могут быть повторно использованы. Это включает штрихкоды, используемые для лент, которые были удалены.

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

Установите значение true, чтобы использовать шифрование Amazon S3 на стороне сервера с собственным ключом KMS, или false, чтобы использовать ключ, управляемый Amazon S3. Необязательно.

Допустимые значения: true | false

--kms-key (строка)

Amazon Resource Name (ARN) симметричного ключа управления мастер-ключами (CMK) клиента, используемого для шифрования на стороне сервера Amazon S3. Шлюз хранения не поддерживает асимметричные CMK. Это значение может быть установлено только при условии, что KMSEncrypted имеет значение true. Необязательно.

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

Идентификатор пула, в который вы хотите добавить свою ленту для архивирования. Лента в этом пуле архивируется в классе хранилища S3, связанном с пулом. Когда вы используете свое приложение резервного копирования для извлечения ленты, лента архивируется непосредственно в класс хранения (S3 Glacier или S3 Deep Archive), соответствующий пулу.

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

Установите значение TRUE, если создаваемая лента должна быть настроена как лента с одноразовым записью и многократным чтением (WORM).

--tags (список)

Список до 50 тегов, которые можно назначить виртуальной ленте, имеющей штрихкод. Каждый тег — пара ключ-значение.

Примечание

Допустимые символы для ключа и значения — буквы, пробелы и цифры, представимые в формате UTF-8, а также следующие специальные символы: + - = . _ : / @. Максимальная длина ключа тега — 128 символов, а максимальная длина значения тега — 256.

(структура)

Пара ключ-значение, которая помогает вам управлять, фильтровать и искать свои ресурсы. Разрешенные символы: буквы, пробелы и цифры, представимые в UTF-8, а также следующие символы: + - = . _ : /.

Ключ -> (строка)

Ключ тега. Ключ не может начинаться с aws:.

Значение -> (строка)

Значение ключа тега.

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

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "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 (boolean)

Включить отладку.

--endpoint-url (string)

Переопределить URL команды заданным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определённый профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/выключить цветной вывод.

  • on
  • off
  • auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот параметр предоставлен.

--ca-bundle (string)

Файл с корневым сертификатом для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — 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 (boolean)

Отключить вывод страницы для вывода.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Вывод

TapeARN -> (string)

Уникальное имя ресурса Amazon (ARN), представляющее виртуальную ленту, которая была создана.

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

Spec-Zone.ru

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