Add Tags To Vault (POST tags add) - Amazon Glacier
Sintaxe da SolicitaçãoParâmetros da solicitaçãoRespostasExemplosSeções relacionadasConsulte também

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, que oferecem uma experiência superior ao cliente com APIs base em buckets S3, disponibilidade Região da AWS total, custos mais baixos e integração de serviços. AWS Se você quiser recursos aprimorados, considere migrar para as classes de armazenamento do Amazon S3 Glacier usando AWS nossa orientação de soluções para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do 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á.

Add Tags To Vault (POST tags add)

Esta operação adiciona as tags especificadas a um cofre. Cada tag é composta de uma chave e de um valor. Cada cofre pode ter até 50 tags. Se a solicitação excedesse o limite de tags do cofre, a operação lançaria o erro LimitExceededException.

Se uma tag já existir no cofre em uma chave especificada, o valor da chave existente será substituído. Para obter mais informações sobre tags, consulte Marcação de recursos do Amazon Glacier.

Sintaxe da Solicitação

Para adicionar tags a um cofre, envie uma solicitação HTTP POST para o URI das tags conforme mostrado no exemplo da sintaxe a seguir.

POST /AccountId/vaults/vaultName/tags?operation=add HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01
			
{
   "Tags": 
      {
         "string": "string",
         "string": "string"
      }        
}

nota

O AccountId valor é o Conta da AWS ID. Esse valor deve corresponder ao Conta da AWS ID associado às credenciais usadas para assinar a solicitação. 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ê especificar o ID da conta, não inclua nenhum hífen ('-') no ID.

Parâmetros da solicitação

Name (Nome) Descrição Obrigatório
operation=add

Um parâmetro de string de consulta única operation com um valor de add para diferenciá-lo de Remove Tags From Vault (POST tags remove).

 Sim

Cabeçalhos de solicitação

Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte Cabeçalhos de solicitação comuns.

Corpo da Solicitação

O corpo da solicitação contém os campos JSON a seguir.

Tags

As tags a serem adicionadas ao cofre. Cada tag é composta de uma chave e de um valor. O valor pode ser uma string vazia.

Tipo: mapa de string para string

Restrições de tamanho: tamanho mínimo de 1. Tamanho máximo 10.

Obrigatório: Sim

Respostas

Se a solicitação de operação for bem-sucedida, o serviço retornará uma resposta 204 No Content HTTP.

Sintaxe

HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date

Cabeçalhos de resposta

Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte Cabeçalhos de resposta comuns.

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

Exemplos

Exemplo de solicitação

O exemplo a seguir envia uma solicitação HTTP POST com as tags a serem adicionadas ao cofre.

POST /-/vaults/examplevault/tags?operation=add HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Content-Length: length
x-amz-glacier-version: 2012-06-01
			
{
  "Tags": 
    {
       "examplekey1": "examplevalue1",
       "examplekey2": "examplevalue2"
    }        
}

Exemplo de resposta

Se a solicitação for bem-sucedida, o Amazon Glacier retornará umHTTP 204 No Content, conforme mostrado no exemplo a seguir.

HTTP/1.1 204 No Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT

Consulte também

Para obter mais informações sobre o uso dessa API em uma das linguagens específicas da Amazon SDKs, consulte o seguinte: