upload-archive

Описание

Эта операция добавляет архив в хранилище. Это синхронная операция, и для успешного загрузки ваши данные надежно сохраняются. Amazon S3 Glacier возвращает идентификатор архива в заголовке x-amz-archive-id ответа.

Для доступа к данным в Amazon S3 Glacier необходимо использовать идентификатор архива. После загрузки архива следует сохранить возвращенный идентификатор архива, чтобы позже можно было восстановить или удалить архив. Помимо сохранения идентификатора архива, вы также можете его индексировать и присвоить ему понятное имя для улучшения поиска. Вы также можете использовать необязательное поле описания архива, чтобы указать, как к архиву обращаются во внешнем индексе архивов, например, таком, который вы можете создать в Amazon DynamoDB. Вы также можете получить инвентаризацию хранилища, чтобы получить список идентификаторов архивов в хранилище. Для получения дополнительной информации см. InitiateJob .

Вы должны предоставить хэш дерева SHA256 данных, которые вы загружаете. Сведения о вычислении хэша дерева SHA256 см. в разделе Вычисление контрольных сумм .

Вы можете необязательно указать описание архива длиной до 1024 печатных ASCII-символов. Вы можете получить описание архива, когда вы либо восстанавливаете архив, либо получаете инвентаризацию хранилища. Для получения дополнительной информации см. InitiateJob . Amazon Glacier не интерпретирует описание каким-либо образом. Описание архива необязательно уникально. Вы не можете использовать описание для поиска или сортировки списка архивов.

Архивы неизменяемы. После загрузки архива вы не можете изменить архив или его описание.

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

Справочная информация и базовый REST API см. в руководстве Amazon Glacier Developer Guide, в разделах Загрузка архива в Amazon Glacier и Загрузка архива.

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

Синопсис

  upload-archive
--vault-name <value>
--account-id <value>
[--archive-description <value>]
[--checksum <value>]
[--body <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]

Параметры

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

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

--archive-description (строка)

--checksum (строка)

--body (потоковая область данных)

--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
• текст
• таблица
• 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.

Примеры

Следующая команда загружает архив в текущей папке с именем archive.zip в хранилище с именем my-vault:

aws glacier upload-archive --account-id - --vault-name my-vault --body archive.zip

Вывод:

{
    "archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
    "checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67",
    "location": "/0123456789012/vaults/my-vault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw"
}

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

Чтобы получить загруженный архив, инициируйте процесс получения с помощью команды aws glacier initiate-job.

Вывод

location -> (строка)

checksum -> (строка)

archiveId -> (строка)