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á.
Initiate Multipart Upload (POST multipart-uploads)
Descrição
Essa operação inicia um multipart upload (consulte Fazer upload de arquivos grandes em partes (Multipart Upload)). O Amazon Glacier (Amazon Glacier) cria um recurso de upload em várias partes e retorna seu ID na resposta. Você usará esse ID de upload em operações de multipart upload subsequentes.
Ao iniciar um multipart upload, você especifica o tamanho da parte em número de bytes. O tamanho da parte deve ser um mebibyte (MiB) (1024 kibibytes [KiB]) multiplicado por uma potência de 2 — por exemplo, 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB) e assim por diante. O tamanho da parte mínimo permitido é 1 MiB, e o máximo é 4 gibibytes (GiB).
Toda parte cujo upload você faz usando esse ID de upload, exceto a última, deve ter o mesmo tamanho. A última pode ser do mesmo tamanho ou menor. Por exemplo, suponhamos que você queira fazer upload de um arquivo de 16,2 MiB. Se iniciar o multipart upload com um tamanho de parte de 4 MiB, você fará upload de quatro partes de 4 MiB cada e uma parte de 0,2 MiB.
nota
Você não precisa saber o tamanho do arquivo ao iniciar um upload de várias partes porque o Amazon Glacier não exige que você especifique o tamanho geral do arquivo.
Depois de concluir o upload de várias partes, o Amazon Glacier remove o recurso de upload de várias partes referenciado pelo ID. O Amazon Glacier também removerá o recurso de upload de várias partes se você cancelar o upload de várias partes ou poderá ser removido se não houver atividade por um período de 24 horas. O ID ainda poderá estar disponível depois de 24 horas, mas os aplicativos não devem esperar esse comportamento.
Solicitações
Para iniciar um multipart upload, você envia uma solicitação HTTP POST para o URI do sub-recurso multipart-uploads do cofre no qual deseja salvar o arquivo. A solicitação deve incluir o tamanho da parte e pode incluir uma descrição do arquivo.
Sintaxe
POST /AccountId/vaults/VaultName/multipart-uploads Host: glacier.us-west-2.amazonaws.com Date:DateAuthorization:SignatureValuex-amz-glacier-version: 2012-06-01 x-amz-archive-description:ArchiveDescriptionx-amz-part-size:PartSize
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-part-size
|
O tamanho de cada parte, exceto a última, em bytes. A última parte pode ser menor que o tamanho dessa parte. Tipo: string Padrão: nenhum Restrições: o tamanho da parte deve ser um mebibyte (1024 KiB) multiplicado por uma potência de 2 — por exemplo, 1048576 (1 MiB), 2097152 (2 MiB), 4194304 (4 MiB), 8388608 (8 MiB) e assim por diante. O tamanho da parte mínimo permitido é 1 MiB, e o máximo é 4 GiB (4096 MiB). |
Sim |
x-amz-archive-description
|
Descrição do arquivo cujo upload você está fazendo em partes. Ela pode ser uma descrição em linguagem simples ou algum identificador exclusivo que você opta por atribuir. Quando você recupera um inventário de cofre (consulte Initiate Job (trabalhos POST)), o inventário inclui essa descrição para cada um dos arquivos retornados em resposta. Os espaços à esquerda em descrições de arquivo são removidos. Tipo: string Padrão: nenhum Restrições: a descrição deve ser menor que ou igual a 1.024 bytes. 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 |
Corpo da Solicitação
Essa operação não tem um corpo de solicitação.
Respostas
Na resposta, o Amazon Glacier cria um recurso de upload de várias partes identificado por um ID e retorna o caminho relativo do URI do ID de upload de várias partes.
Sintaxe
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Location: Location x-amz-multipart-upload-id: multiPartUploadId
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 relativo do URI do ID de upload de várias partes criado pelo Amazon Glacier. Você pode usar esse caminho do URI para delimitar as solicitações a fim de fazer upload de partes e concluir o multipart upload. Tipo: string |
x-amz-multipart-upload-id
|
O ID do multipart upload. Esse valor também está incluído como parte do cabeçalho 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 Glacier, consulte. Respostas de erro
Exemplo
Exemplo de solicitação
O exemplo a seguir inicia um multipart upload enviando uma solicitação HTTP POST para o URI do sub-recurso multipart-uploads de um cofre chamado examplevault. A solicitação inclui cabeçalhos para especificar o tamanho da parte de 4 MiB (4.194.304 bytes) e a descrição de arquivo opcional.
POST /-/vaults/examplevault/multipart-uploads Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-archive-description: MyArchive-101 x-amz-part-size: 4194304 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 Amazon Glacier cria um recurso de upload de várias partes e o adiciona ao multipart-uploads sub-recurso do cofre. O cabeçalho de resposta Location inclui o caminho do URI relativo para o ID de multipart upload.
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/multipart-uploads/OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE x-amz-multipart-upload-id: OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE
Para obter informações sobre como fazer upload de partes individuais, consulte Upload Part (PUT uploadID).
Seções relacionadas
