get-job-output

Описание

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

Вы можете загрузить весь вывод задания или часть вывода, указав диапазон байтов. В случае задания по извлечению архива, в зависимости от указанного вами диапазона байтов, Amazon S3 Glacier (Glacier) возвращает контрольную сумму для части данных. Вы можете вычислить контрольную сумму на стороне клиента и проверить совпадение значений, чтобы убедиться, что загруженная часть данных является правильной.

Идентификатор задания не истекает в течение как минимум 24 часов после завершения задания Glacier. Это касается и диапазона байтов. Для заданий по извлечению архивов и инвентаризации вы должны проверить загруженный размер по сравнению с размером, возвращённым в заголовках ответа Get Job Output.

Для заданий по извлечению архивов вы также должны проверить, соответствует ли размер ожидаемому. Если вы загружаете часть вывода, ожидаемый размер основывается на диапазоне байтов, который вы указали. Например, если вы указываете диапазон bytes=0-1048575, вы должны проверить, что размер вашей загрузки составляет 1 048 576 байтов. Если вы загружаете весь архив, ожидаемый размер — это размер архива при его загрузке в Amazon S3 Glacier. Ожидаемый размер также возвращается в заголовках ответа Get Job Output.

В случае задания по извлечению архива, в зависимости от указанного вами диапазона байтов, Glacier возвращает контрольную сумму для части данных. Чтобы убедиться, что загруженная часть данных является корректной, вычислите контрольную сумму на клиенте, проверьте соответствие значений и проверьте, что размер соответствует ожидаемому.

Идентификатор задания не истекает не менее 24 часов после завершения работы Glacier. То есть вы можете загрузить результат задания в течение 24 часов после завершения задания Amazon Glacier.

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

Для концептуальной информации и базового REST API см. Загрузка инвентаризации хранилища, Загрузка архива и Get Job Output.

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

Синтаксис

  get-job-output
--account-id <value>
--vault-name <value>
--job-id <value>
[--range <value>]
<outfile>
[--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 (строка)

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

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

--range (строка)

outfile (строка) Имя файла, в котором будет сохранено содержимое

Глобальные параметры

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

Примеры

Следующая команда сохраняет вывод задания инвентаризации хранилища в файл в текущей директории с именем output.json:

aws glacier get-job-output --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW output.json

job-id доступен в выводе команды aws glacier list-jobs. Обратите внимание, что имя выходного файла — позиционный аргумент, который не имеет префикса имени параметра. Amazon Glacier требует аргумент идентификатора учётной записи при выполнении операций, но вы можете использовать дефис для указания используемой учётной записи.

Вывод:

{
    "status": 200,
    "acceptRanges": "bytes",
    "contentType": "application/json"
}

output.json:

{"VaultARN":"arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault","InventoryDate":"2015-04-07T00:26:18Z","ArchiveList":[{"ArchiveId":"kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw","ArchiveDescription":"multipart upload test","CreationDate":"2015-04-06T22:24:34Z","Size":3145728,"SHA256TreeHash":"9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67"}]}

Вывод

body -> (потоковый блок)

checksum -> (строка)

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

contentRange -> (строка)

acceptRanges -> (строка)

contentType -> (строка)

archiveDescription -> (строка)