Spec-Zone.ru › AWS CLI v2

[ aws . storagegateway ]

describe-vtl-devices

Описание

Возвращает описание устройств виртуальной библиотеки ленточных накопителей (VTL) для указанного шлюза ленточных накопителей. В ответе Storage Gateway возвращает информацию об устройствах VTL.

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

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

describe-vtl-devices является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничностью, аргумент --query должен извлекать данные из результатов следующих выражений запроса: VTLDevices

Синтаксис

  describe-vtl-devices
--gateway-arn <value>
[--vtl-device-arns <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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.

--vtl-device-arns (список)

Массив строк, где каждая строка представляет собой Amazon Resource Name (ARN) устройства VTL.

Примечание

Все указанные устройства VTL должны принадлежать одному шлюзу. Если устройства VTL не указаны, результат будет содержать все устройства на указанном шлюзе.

(строка)

Синтаксис:

"string" "string" ...

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределяют значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

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

Токен для указания точки начала постраничного извлечения. Это значение NextToken из ранее усеченного ответа.

Примеры использования см. в разделе Постраничная навигация в руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для запроса к службе AWS. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов службы AWS, извлекая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов службы AWS.

Примеры использования см. в разделе Постраничная навигация в руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Для продолжения постраничной навигации предоставьте значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничная навигация в руководстве пользователя AWS Command Line Interface.

--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 для вывода.

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

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

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

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

Вывод

GatewayARN -> (строка)

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

VTLDevices -> (список)

Массив объектов устройств VTL, состоящих из Amazon Resource Name (ARN) устройств VTL.

(структура)

Представляет объект устройства, связанный со шлюзом ленточных накопителей.

VTLDeviceARN -> (строка)

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

VTLDeviceType -> (строка)

Указывает тип устройства, который эмулирует устройство VTL.

VTLDeviceVendor -> (строка)

Указывает производителя устройства, которое эмулирует объект устройства VTL.

VTLDeviceProductIdentifier -> (строка)

Указывает модель устройства, которое эмулирует устройство VTL.

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

Список информации iSCSI об устройстве VTL.

TargetARN -> (строка)

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

NetworkInterfaceId -> (строка)

Идентификатор сетевого интерфейса устройства VTL.

NetworkInterfacePort -> (целое число)

Порт, используемый для связи с целевыми устройствами iSCSI VTL.

ChapEnabled -> (логическое значение)

Указывает, включена ли взаимная аутентификация CHAP для целевого устройства iSCSI.

Marker -> (строка)

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

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

Spec-Zone.ru

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