Esta página é somente para clientes existentes do serviço S3 Glacier que usam o Vaults e a API REST original de 2012.
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á.
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 S3 Glacier (S3 Glacier) cria um recurso de multipart upload e retorna o 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 multipart upload porque o S3 Glacier não exige que especifique o tamanho de todo o arquivo.
Depois de concluir o multipart upload, o S3 Glacier removerá o recurso de multipart upload referenciado pelo ID. O S3 Glacier também removerá o recurso de multipart upload se você cancelar o multipart upload, ou ele 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 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 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 S3 Glacier cria um recurso de multipart upload identificado por um ID e retorna o caminho do URI relativo do ID de multipart upload.
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 do URI relativo do ID de multipart upload criado pelo S3 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 S3 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 S3 Glacier cria um recurso de multipart upload e o adiciona ao sub-recurso multipart-uploads 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
