Esta página é somente para clientes existentes do serviço S3 Glacier que usam o Vaults e o original de 2012. REST API
Se você estiver procurando por soluções de armazenamento de arquivamento, sugerimos usar as classes de armazenamento S3 Glacier no Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para saber mais sobre essas opções de armazenamento, consulte Classes de armazenamento S3 Glacier e Armazenamento de dados de longo prazo usando classes
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:DateAuthorization:SignatureValuex-amz-archive-description:Descriptionx-amz-sha256-tree-hash:SHA256 tree hashx-amz-content-sha256:SHA256 linear hashContent-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 (POSTtrabalhos)), 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 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 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
