Spec-Zone.ru › AWS CLI v2

[ aws . storagegateway ]

создание-хранимого-iscsi-тома

Описание

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

Размер создаваемого тома определяется из размера диска. Можно выбрать сохранение существующих данных на диске, создание тома из существующего снимка или создание пустого тома. Если выбран вариант создания пустого тома хранилища, все существующие данные на диске будут удалены.

В запросе необходимо указать шлюз и информацию о диске, на котором создаётся том. В ответ шлюз создаёт том и возвращает информацию о томе, такую как Amazon Resource Name (ARN) тома, его размер и ARN целевого iSCSI-таргета, который инициаторы могут использовать для подключения к целевому тома.

См. также: AWS API Documentation

Синтаксис

  create-stored-iscsi-volume
--gateway-arn <value>
--disk-id <value>
[--snapshot-id <value>]
--preserve-existing-data | --no-preserve-existing-data
--target-name <value>
--network-interface-id <value>
[--kms-encrypted | --no-kms-encrypted]
[--kms-key <value>]
[--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.

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

Уникальный идентификатор локального диска шлюза, настроенного как хранимый том. Используйте ListLocalDisks, чтобы получить список идентификаторов дисков для шлюза.

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

Идентификатор снимка (например, “snap-1122aabb”) снимка для восстановления как нового хранимого тома. Укажите это поле, если вы хотите создать iSCSI-том хранения из снимка; в противном случае не включайте это поле. Для просмотра снимков для вашей учётной записи используйте DescribeSnapshots в справочнике по API Amazon Elastic Compute Cloud.

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

Установите в значение true, если вы хотите сохранить данные на локальном диске. В противном случае установите в значение false, чтобы создать пустой том.

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

--target-name (строка)

Имя целевого iSCSI-таргета, используемого инициатором для подключения к тому и используемого в качестве суффикса для ARN целевого ресурса. Например, указание TargetName как myvolume приводит к ARN целевого ресурса arn:aws:storagegateway:us-east-2:111122223333:gateway/sgw-12A3456B/target/iqn.1997-05.com.amazon:myvolume. Имя целевого ресурса должно быть уникальным для всех томов на одном шлюзе.

Если значение не указано, Storage Gateway использует ранее использованное значение для этого тома в качестве нового имени целевого ресурса.

--network-interface-id (строка)

Сетевой интерфейс шлюза, на котором необходимо экспонировать целевой ресурс iSCSI. Принимаются только IPv4-адреса. Используйте DescribeGatewayInformation, чтобы получить список доступных сетевых интерфейсов на шлюзе.

Допустимые значения: Действительный IP-адрес.

--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. Необязательно.

--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
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

Показать версию данного инструмента.

--color (строка)

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

  • on
  • off
  • auto

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

Вывод

VolumeARN -> (строка)

Amazon Resource Name (ARN) настроенного тома.

VolumeSizeInBytes -> (длинное целое число)

Размер тома в байтах.

TargetARN -> (строка)

Amazon Resource Name (ARN) целевого ресурса тома, который включает имя iSCSI, которое инициаторы могут использовать для подключения к целевому ресурсу.

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

Spec-Zone.ru

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