Spec-Zone.ru › AWS CLI v2

[ aws . storagegateway ]

создать-ленты

Описание

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

Примечание

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

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

Синтаксис

  create-tapes
--gateway-arn <value>
--tape-size-in-bytes <value>
--client-token <value>
--num-tapes-to-create <value>
--tape-barcode-prefix <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 байт).

--client-token (строка)

Уникальный идентификатор, используемый для повторной попытки запроса. Если вы повторяете запрос, используйте тот же ClientToken, что и в исходном запросе.

Примечание

Использование того же ClientToken предотвращает создание ленты несколько раз.

--num-tapes-to-create (целое число)

Количество виртуальных лент, которые вы хотите создать.

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

Префикс, который вы добавляете к штрих-коду виртуальной ленты, которую вы создаёте. Этот префикс делает штрих-код уникальным.

Примечание

Длина префикса должна быть от 1 до 4 символов и должна состоять из заглавных букв от A до Z.

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

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

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

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

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

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

Идентификатор пула, в который вы хотите добавить свою ленту для архивирования. Лента в этом пуле архивируется в хранилище S3, связанном с пулом. Когда вы используете приложение резервного копирования для извлечения ленты, лента архивируется непосредственно в хранилище (S3 Glacier или S3 Glacier 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 (логическое значение)

Включить отладочную запись журнала.

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

Вывод

TapeARNs -> (список)

Список уникальных Amazon Resource Names (ARN), которые представляют виртуальные ленты, которые были созданы.

(строка)

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

Spec-Zone.ru

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