Spec-Zone.ru › AWS CLI v2

[ aws . storagegateway ]

создание кэшированного iSCSI-тома

Описание

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

Примечание

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

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

Необязательно, вы можете указать ARN существующего тома как SourceVolumeARN для этого кэшированного тома, что создаст точную копию последнего момента восстановления существующего тома. Значение VolumeSizeInBytes должно быть равно или больше размера копируемого тома в байтах.

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

Синтаксис

  create-cached-iscsi-volume
--gateway-arn <value>
--volume-size-in-bytes <value>
[--snapshot-id <value>]
--target-name <value>
[--source-volume-arn <value>]
--network-interface-id <value>
--client-token <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.

--volume-size-in-bytes (длинное целое число)

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

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

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

--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 использует значение, которое ранее использовалось для этого тома, в качестве нового имени целевого узла.

--source-volume-arn (строка)

ARN существующего тома. Указание этого ARN преобразует новый том в точную копию последнего момента восстановления указанного существующего тома. Значение VolumeSizeInBytes для этого нового тома должно быть равно или больше размера существующего тома в байтах.

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

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

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

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

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

--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, и следующие специальные символы: + - = . _ : / @.

(структура)

Пара ключ-значение, которая помогает вам управлять, фильтровать и искать ваши ресурсы. Разрешенные символы: буквы, пробелы и цифры, представленные в 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
  • таблица
  • 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.

Вывод

VolumeARN -> (строка)

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

TargetARN -> (строка)

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

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

Spec-Zone.ru

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