list-vaults

Описание

Данная операция перечисляет все хранилища, принадлежащие учетной записи вызывающего пользователя. Список, возвращаемый в ответе, отсортирован по имени хранилища в лексикографическом порядке.

По умолчанию данная операция возвращает не более 10 элементов. Если для перечисления хранилищ требуются дополнительные вызовы, поле ответа marker содержит Amazon Resource Name (ARN) хранилища, с которого следует продолжить перечисление с новым запросом List Vaults; в противном случае поле marker имеет значение null. Для возврата списка хранилищ, начинающегося со специфического хранилища, установите параметр запроса marker в ARN хранилища, полученный из предыдущего запроса List Vaults. Также можно ограничить количество хранилищ, возвращаемых в ответе, указав параметр запроса limit.

Учетная запись AWS имеет полные разрешения для выполнения всех операций (действий). Однако пользователи AWS Identity and Access Management (IAM) по умолчанию не имеют никаких разрешений. Необходимо предоставить им явные разрешения на выполнение определенных действий. Дополнительную информацию см. в разделе Управление доступом с использованием AWS Identity and Access Management (IAM).

Для получения концептуальной информации и базового REST API см. Получение метаданных хранилища в Amazon S3 Glacier и Перечисление хранилищ в Руководстве разработчика Amazon Glacier.

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

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

Синтаксис

  list-vaults
--account-id <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]

Параметры

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

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

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

--page-size (строка)

--max-items (строка)

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

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

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

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

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

Примеры

Следующая команда перечисляет хранилища в учетной записи по умолчанию и регионе:

aws glacier list-vaults --account-id -

Вывод:

{
    "VaultList": [
        {
            "SizeInBytes": 3178496,
            "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
            "LastInventoryDate": "2015-04-07T00:26:19.028Z",
            "VaultName": "my-vault",
            "NumberOfArchives": 1,
            "CreationDate": "2015-04-06T21:23:45.708Z"
        }
    ]
}

Amazon Glacier требует аргумента идентификатора учетной записи при выполнении операций, но вы можете использовать тире для указания используемой учетной записи.

Вывод

VaultList -> (список)

Marker -> (строка)