Esta página é somente para clientes atuais do serviço Amazon Glacier que usam Vaults e a API REST original de 2012.
Se você estiver procurando por soluções de armazenamento de arquivos, recomendamos usar as classes de armazenamento Amazon 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 as classes de armazenamento do Amazon Glacier
O Amazon Glacier (serviço autônomo original baseado em cofre) não aceitará mais novos clientes a partir de 15 de dezembro de 2025, sem impacto para os clientes existentes. O Amazon Glacier é um serviço independente APIs que armazena dados em cofres e é diferente das classes de armazenamento Amazon S3 e Amazon S3 Glacier. Seus dados existentes permanecerão seguros e acessíveis no Amazon Glacier indefinidamente. Nenhuma migração é necessária. Para armazenamento de arquivamento de baixo custo e longo prazo, AWS recomenda as classes de armazenamento Amazon S3 Glacier
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á.
Complete Multipart Upload (POST uploadID)
Descrição
Você chama essa operação de upload de várias partes para informar ao Amazon Glacier (Amazon Glacier) que todas as partes do arquivo foram carregadas e que o Amazon Glacier agora pode montar o arquivo a partir das partes carregadas.
Para obter informações sobre o multipart upload, consulte Fazer upload de arquivos grandes em partes (Multipart Upload).
Depois de montar e salvar o arquivo no cofre, o Amazon Glacier retorna o ID de arquivamento do recurso de arquivamento recém-criado. Depois de fazer upload de um arquivo, você deve salvar o ID do arquivo retornado para recuperar o arquivo mais tarde.
Na solicitação, você deve incluir o hash da SHA256 árvore computada de todo o arquivo que você carregou. Para obter informações sobre como calcular um hash de SHA256 árvore, consulteComputar somas de verificação. No lado do servidor, o Amazon Glacier também constrói o hash da SHA256 árvore do arquivo montado. Se os valores corresponderem, o Amazon Glacier salva o arquivo no cofre; caso contrário, ele retornará um erro e a operação falhará. A operação List Parts (GET uploadID) retorna uma lista de partes cujo upload foi feito para um multipart upload específico. Ela inclui informações da soma de verificação de cada parte carregada que podem ser usadas para depurar um problema de soma de verificação inválida.
Além disso, o Amazon Glacier também verifica se há intervalos de conteúdo ausentes. Ao fazer upload de partes, você especifica valores de intervalo identificando onde cada parte fica na montagem final do arquivo. Ao montar o arquivo final, o Amazon Glacier verifica se há intervalos de conteúdo ausentes e, se houver intervalos de conteúdo ausentes, o Amazon Glacier retornará um erro e a operação Complete Multipart Upload falhará.
Complete Multipart Upload é uma operação idempotente. Depois do primeiro complete multipart upload bem-sucedido, se você chamar a operação novamente dentro de um curto período, a operação será bem-sucedida e retornará o mesmo ID do arquivo. Isso será útil se você enfrentar um problema de rede ou receber um erro de servidor 500, quando poderá repetir a solicitação Complete Multipart Upload e obter o mesmo ID de arquivo sem criar arquivos duplicados. No entanto, depois que o multipart upload for concluído, você não poderá chamar a operação List Parts, e o multipart upload não será exibido na resposta List Multipart Uploads, mesmo se for possível uma conclusão idempotente.
Solicitações
Para concluir um upload em várias partes, você envia uma solicitação HTTP POST para o URI do ID de upload que o Amazon Glacier criou em resposta à sua solicitação de início de upload em várias partes. Esse é o mesmo URI usado por você ao fazer upload das partes. Além dos cabeçalhos comuns obrigatórios, você deve incluir o resultado do hash da SHA256 árvore de todo o arquivo e o tamanho total do arquivo em bytes.
Sintaxe
POST /AccountId/vaults/VaultName/multipart-uploads/uploadIDHost: glacier.Region.amazonaws.com Date:dateAuthorization:SignatureValuex-amz-sha256-tree-hash:SHA256 tree hash of the archivex-amz-archive-size:ArchiveSize in bytesx-amz-glacier-version: 2012-06-01
nota
O AccountId valor é o Conta da AWS ID da conta proprietária do cofre. Você pode especificar um Conta da AWS ID ou, opcionalmente, um único '-' (hífen). Nesse caso, o Amazon Glacier usa Conta da AWS o ID 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 da solicitação
Essa 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 |
|---|---|---|
x-amz-archive-size
|
O tamanho total, em bytes, de todo o arquivo. Esse valor deve ser a soma de todos os tamanhos das partes individuais cujo upload você fez. Tipo: string Padrão: nenhum Restrições: nenhuma |
Sim |
x-amz-sha256-tree-hash
|
O hash da SHA256 árvore de todo o arquivo. É o haxixe da SHA256 árvore do haxixe das partes individuais. Se o valor especificado na solicitação não corresponder ao hash da SHA256 árvore do arquivo final montado, conforme calculado pelo Amazon Glacier, o Amazon Glacier retornará um erro e a solicitação falhará. Tipo: string Padrão: nenhum Restrições: nenhuma |
Sim |
Elementos da solicitação
Essa operação não usa elementos de solicitação.
Respostas
O Amazon Glacier (Amazon Glacier) cria SHA256 um hash de árvore de todo o arquivo. Se o valor corresponder ao hash da SHA256 árvore de todo o arquivo especificado na solicitação, o Amazon Glacier adicionará o arquivo ao cofre. Em resposta, ele retorna o cabeçalho Location HTTP com o caminho de URL do recurso de arquivo recém-adicionado. Se o tamanho do arquivo ou o SHA256 que você enviou na solicitação não corresponder, o Amazon Glacier retornará um erro e o upload permanecerá incompleto. Será possível tentar novamente a operação Complete Multipart Upload depois com valores corretos, quando você poderá criar um arquivo com êxito. Se um upload de várias partes não for concluído, eventualmente o Amazon Glacier recuperará o ID de upload.
Sintaxe
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date 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 arquivo recém-criado. Esse URL inclui o ID de arquivamento gerado pelo Amazon Glacier. Tipo: String |
x-amz-archive-id
|
O ID do arquivo. Esse valor também está incluído como parte do cabeçalho Tipo: string |
Campos de resposta
Essa operação não retorna um corpo de resposta.
Exemplo
Exemplo de solicitação
Neste exemplo, uma solicitação HTTP POST é enviada para o URI que foi retornado por uma solicitação Initiate Multipart Upload. A solicitação especifica o hash da SHA256 árvore de todo o arquivo e o tamanho total do arquivo.
POST /-/vaults/examplevault/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE HTTP/1.1 Host: glacier.us-west-2.amazonaws.com z-amz-Date: 20170210T120000Z x-amz-sha256-tree-hash:1ffc0f54dd5fdd66b62da70d25edacd0 x-amz-archive-size:8388608 x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Exemplo de resposta
O exemplo de resposta a seguir mostra que o Amazon Glacier criou com sucesso um arquivo a partir das partes que você carregou. A resposta inclui o ID de arquivo com caminho completo.
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Location: /111122223333/vaults/examplevault/archives/NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId x-amz-archive-id: NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId
Agora você pode enviar solicitações HTTP para o URI do recurso/arquivo recém-adicionado. Por exemplo, você pode enviar uma solicitação GET para recuperar o arquivo.
Seções relacionadas
