Upload Archive (POST archive) - Amazon S3 Glacier

Se você é novato no Amazon Simple Storage Service (Amazon S3), recomendamos que comece aprendendo mais sobre as classes de armazenamento S3 Glacier no Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para obter mais informações, consulte Classes de armazenamento S3 Glacier e Classes de armazenamento para arquivamento de objetos no Guia do usuário do Amazon S3.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Upload Archive (POST archive)

Descrição

Essa operação adiciona um arquivo a um cofre. Para um upload bem-sucedido, os dados são mantidos de maneira durável. Em resposta, o Amazon S3 Glacier (S3 Glacier) retorna o ID de arquivo no cabeçalho x-amz-archive-id da resposta. Você deve salvar o ID do arquivo retornado, de maneira que possa acessar o arquivo depois.

Você deve fornecer um hash de árvore SHA256 dos dados cujo upload está fazendo. Para obter informações sobre como computar um hash de árvore SHA256, consulte Computar somas de verificação.

nota

O hash da árvore SHA256 só é necessário para a ação Upload Archive (POST archive) ao usar a API. Não é necessário ao usar o AWS CLI.

Ao fazer upload de um arquivo, você pode especificar uma descrição de arquivo de até 1.024 caracteres ASCII imprimíveis. O S3 Glacier retorna a descrição do arquivo quando você recupera o arquivo ou obtém o inventário de cofre. O S3 Glacier não interpreta a descrição de maneira alguma. Uma descrição de arquivo não precisa ser exclusiva. Você não pode usar a descrição para recuperar ou classificar a lista de arquivos.

Exceto para a descrição de arquivo opcional, o S3 Glacier não dá suporte a metadados adicionais dos arquivos. O ID de arquivo é uma sequência de caracteres invisível da qual você não pode inferir nenhum significado sobre o arquivo. Assim, convém manter metadados sobre os arquivos no lado do cliente. Para obter mais informações, consulte Trabalhando com arquivos no Amazon S3 Glacier.

Os arquivos são imutáveis. Depois de fazer upload de um arquivo, você não poderá editar o arquivo nem a descrição.

Solicitações

Para fazer upload de um arquivo, use o método HTTP POST e delimite a solicitação ao sub-recurso archives do cofre no qual você deseja salvar o arquivo. A solicitação deve incluir o tamanho da carga útil do arquivo, a soma de verificação (hash de árvore SHA256) e pode incluir uma descrição do arquivo.

Sintaxe

POST /AccountId/vaults/VaultName/archives Host: glacier.Region.amazonaws.com x-amz-glacier-version: 2012-06-01 Date: Date Authorization: SignatureValue x-amz-archive-description: Description x-amz-sha256-tree-hash: SHA256 tree hash x-amz-content-sha256: SHA256 linear hash Content-Length: Length <Request body.>

nota

O valor de AccountId é o ID de Conta da AWS da conta proprietária do cofre. Você pode especificar um ID de Conta da AWS ou, de forma opcional, um '-' (hífen) único; nesse caso, o Amazon S3 Glacier usa o ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Se você usar um ID de conta, não inclua nenhum hífen ('-') no ID.

Parâmetros de solicitação

Essa implementação da operação não usa parâmetros de solicitação.

Cabeçalhos de solicitação

Essa operação usa os seguintes cabeçalhos de solicitação, além dos cabeçalhos de solicitação que são comuns a todas as operações. Para mais informações sobre os cabeçalhos de solicitação comuns, consulte Cabeçalhos de solicitação comuns.

Name (Nome) Descrição Obrigatório
Content-Length

O tamanho do objeto em bytes. Para obter mais informações, acesse http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13.

Tipo: número

Padrão: nenhum

Restrições: nenhuma

Sim
x-amz-archive-description

A descrição opcional do arquivo cujo upload você está fazendo. Ela pode ser uma descrição em linguagem simples ou algum identificador que você opta por atribuir. A descrição não precisa ser exclusiva entre os arquivos. Quando você recupera um inventário de cofre (consulte Initiate Job (trabalhos POST)), ela inclui essa descrição para cada um dos arquivos retornados em resposta.

Tipo: string

Padrão: nenhum

Restrições: a descrição deve ser menor que ou igual a 1.024 bytes caracteres. Os caracteres permitidos são ASCII 7 bits sem códigos de controle – mais especificamente, valores ASCII 32—126 decimais ou 0x20—0x7E hexadecimais.

Não
x-amz-content-sha256

A soma de verificação SHA256 (um hash linear) da carga útil. Ele não é o mesmo valor especificado por você no cabeçalho x-amz-sha256-tree-hash.

Tipo: string

Padrão: nenhum

Restrições: nenhuma

Sim
x-amz-sha256-tree-hash

A soma de verificação computada pelo usuário, hash de árvore SHA256, da carga útil. Para obter informações sobre como computar o hash de árvore SHA256, consulte Computar somas de verificação. Se calcular uma soma de verificação diferente da carga útil, o S3 Glacier rejeitará a solicitação.

Tipo: string

Padrão: nenhum

Restrições: nenhuma

Sim

Corpo da solicitação

O corpo da solicitação contém os dados cujo upload deve ser feito.

Respostas

Em resposta, o S3 Glacier armazena de maneira durável o arquivo e retorna um caminho de URI para o ID de arquivo.

Sintaxe

HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier Location: Location x-amz-archive-id: ArchiveId

Cabeçalhos de resposta

Uma resposta bem-sucedida inclui os seguintes cabeçalhos de resposta, além dos cabeçalhos de resposta que são comuns a todas as operações. Para mais informações sobre os cabeçalhos de resposta comuns, consulte Cabeçalhos de resposta comuns.

Name (Nome) Descrição
Location

O caminho do URI relativo do recurso de arquivo recém-adicionado.

Tipo: string

x-amz-archive-id

O ID do arquivo. Esse valor também está incluído como parte do cabeçalho Location.

Tipo: string

x-amz-sha256-tree-hash

A soma de verificação do arquivo computada pelo S3 Glacier.

Tipo: string

Corpo da resposta

Essa operação não retorna um corpo de resposta.

Erros

Para obter informações sobre exceções e mensagens de erro do Amazon S3 Glacier, consulte Respostas de erro.

Exemplos

Exemplo de solicitação

O exemplo a seguir mostra uma solicitação para fazer upload de um arquivo.

POST /-/vaults/examplevault/archives HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 x-amz-content-sha256: 7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3 Content-Length: 2097152 x-amz-glacier-version: 2012-06-01 Authorization: Authorization=AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date;x-amz-glacier-version,Signature=16b9a9e220a37e32f2e7be196b4ebb87120ca7974038210199ac5982e792cace <Request body (2097152 bytes).>

Exemplo de resposta

A resposta bem-sucedida abaixo tem um cabeçalho Location onde você pode obter o ID atribuído pelo S3 Glacier ao arquivo.

HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId

Seções relacionadas