Remove Tags From Vault (POST tags remove) - Amazon S3 Glacier
Sintaxe da solicitaçãoParâmetros de solicitaçãoRespostasExemplosSeções relacionadasConsulte também

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 de armazenamento S3 Glacier no Guia do usuário do Amazon S3. Essas classes de armazenamento usam o Amazon S3API, estão disponíveis em todas as regiões e podem ser gerenciadas no console do Amazon S3. Eles oferecem recursos como análise de custos de armazenamento, lente de armazenamento, recursos avançados de criptografia opcional e muito mais.

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á.

Remove Tags From Vault (POST tags remove)

Essa operação remove uma ou mais tags do conjunto de tags anexado a um cofre. Para ter mais informações sobre tags, consulte Marcação de recursos do Amazon S3 Glacier.

Essa operação é idempotente. A operação será bem-sucedida, mesmo se não houver tags anexadas ao cofre.

Sintaxe da solicitação

Para remover tags de 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=remove HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01
{
   "TagKeys": [
      "string",
      "string"
   ]
}

nota

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

Parâmetros de solicitação

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

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

 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.

TagKeys

Uma lista de chaves de tag. Toda tag correspondente é removida do cofre.

Tipo: matriz de strings

Restrição de tamanho: mínimo de 1 item na lista. Máximo de 10 itens na lista.

Obrigatório: Sim

Respostas

Se a ação for bem-sucedida, o serviço reenviará uma resposta 204 No Content HTTP com um corpo HTTP vazio.

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 S3 Glacier, consulte Respostas de erro.

Exemplos

Exemplo de solicitação

O exemplo a seguir envia uma solicitação HTTP POST para remover as tags especificadas.

POST /-/vaults/examplevault/tags?operation=remove 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
			
{
   "TagsKeys": [
      "examplekey1",
      "examplekey2"
   ]        
}

Exemplo de resposta

Se a solicitação for bem-sucedida, o Amazon S3 Glacier (S3 Glacier) retornará uma resposta HTTP 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 como usar essa API em um dos Amazon SDKs específicos de linguagem, consulte o seguinte: