Remove Tags From Vault (POST tags remove)

Questa operazione consente di rimuovere uno o più tag dal set di tag associato a un vault. Per ulteriori informazioni sui tag, consulta Assegnazione di tag alle risorse Amazon S3 Glacier.

Questa operazione è idempotente. L'operazione riuscirà anche se non vi sono tag associati al vault.

Sintassi della richiesta

Per rimuovere tag da un vault, devi inviare una richiesta HTTP POST all'URI dei tag come illustrato nell'esempio di sintassi seguente.

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

Il valore di AccountId è l'ID dell'Account AWS. Questo valore deve corrispondere all'ID dell'Account AWS associato alle credenziali utilizzate per firmare la richiesta. Puoi specificare l'ID dell'Account AWS o eventualmente un "-" (trattino), nel qual caso Amazon S3 Glacier utilizza l'ID dell'Account AWS associato alle credenziali utilizzate per firmare la richiesta. Se specifichi l'ID del tuo account, non devi includere trattini ("-") nell'ID.

Parametri della richiesta

Nome	Descrizione	Obbligatorio
operation=remove	Un singolo parametro di stringa di query operation con un valore remove per differenziarlo da Add Tags To Vault (POST tags add).	Sì

Intestazioni di richiesta

Questa operazione utilizza solo le intestazioni richiesta che sono comuni a tutte le operazioni. Per informazioni sulle intestazioni richiesta comuni, consulta Intestazioni di richiesta comuni.

Corpo della richiesta

Il corpo della richiesta contiene i campi JSON descritti di seguito.

TagKeys

Un elenco delle chiavi di tag. Ogni tag corrispondente viene rimosso dal vault.

Tipo: matrice di stringhe

Vincolo di lunghezza: l'elenco deve contenere almeno 1 elemento e al massimo 10.

Required: Yes

Risposte

Se l'operazione viene riesce, il servizio invia una risposta HTTP 204 No Content con un corpo HTTP vuoto.

Sintassi

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

Intestazioni di risposta

Questa operazione utilizza solo le intestazioni di risposta che sono comuni alla maggior parte delle risposte. Per informazioni sulle intestazioni di risposta comuni, consulta Intestazioni di risposta comuni.

Corpo della risposta

Questa operazione non restituisce un corpo della risposta.

Errori

Per informazioni sulle eccezioni e i messaggi di errore di Amazon S3 Glacier, consulta Risposte agli errori.

Esempi

Richiesta di esempio

L'esempio seguente invia una richiesta HTTP POST per rimuovere i tag specificati.

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"
   ]        
}

Risposta di esempio

Se la richiesta ha esito positivo, Amazon S3 Glacier (S3 Glacier) restituisce HTTP 204 No Content, come mostrato nell'esempio seguente.

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

Sezioni correlate

• Add Tags To Vault (POST tags add)

• List Tags For Vault (GET tags)

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli Amazon SDK specifici del linguaggio, consulta quanto segue:

• AWS Command Line Interface