Add Tags To Vault (POST tags add)

Mit dieser Operation werden einem Tresor die angegebenen Tags hinzugefügt. Jedes Tag besteht aus einem Schlüssel und einem Wert. Jeder Tresor kann bis zu 50 Tags aufweisen. Wenn Ihre Anforderung eine Überschreitung des Tag-Grenzwerts für den Tresors zur Folge hätte, löst der Vorgang den Fehler LimitExceededException aus.

Wenn ein Tag bereits im Tresor unter dem angegebenen Schlüssel vorhanden ist, wird der vorhandene Schlüsselwert überschrieben. Weitere Informationen zu Tags erhalten Sie unter Markieren von Amazon S3 Glacier -Ressourcen.

Anforderungssyntax

Um einem Tresor Tags hinzuzufügen, senden Sie eine HTTP-POST-Anforderung an den URI der Tags, wie im folgenden Syntaxbeispiel gezeigt.

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

Anmerkung

DieAccountIdvalue ist derAWS-KontoID. Dieser Wert muss mitAWS-KontoID, die mit den zum Signieren der Anforderung verwendeten Anmeldeinformationen verknüpft ist. Sie können entweder einenAWS-KontoID oder optional ein einzelnes '-'(Bindestrich), in diesem Fall verwendet Amazon S3 GlacierAWS-KontoID, die mit den zum Signieren der Anforderung verwendeten Anmeldeinformationen verknüpft ist. Wenn Sie Ihre Konto-ID angeben, nehmen Sie keine Bindestriche ('-') in die ID ein.

Anfrageparameter

Name	Beschreibung	Erforderlich
operation=add	Ein einziger Abfragezeichenfolgeparameter operation mit dem Wert add zur Unterscheidung von Remove Tags From Vault (POST tags remove).	Ja

Anforderungsheader

Für diesen Vorgang werden ausschließlich Anforderungs-Header verwendet, die für alle Vorgänge gelten. Weitere Informationen über allgemeine Anforderungs-Header finden Sie unter Häufig verwendete Anforderungsheader.

Anforderungstext

Der Anfragestext enthält die folgenden JSON-Felder.

Tags

Die Tags, die dem Tresor hinzugefügt werden sollen. Jedes Tag besteht aus einem Schlüssel und einem Wert. Der Wert kann auch eine leere Zeichenfolge sein.

Type: Zeichenfolge-zu-Zeichenfolge-Zuweisung

Einschränkungen der Länge: Mindestlänge 1. Die maximale Länge beträgt 10 Zeichen.

Erforderlich: Ja

Antworten

Wenn die Anfrage erfolgreich ist, gibt der Service die HTTP-Antwort 204 No Content zurück.

Syntax

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

Antwort-Header

Für diesen Vorgang werden ausschließlich Antwort-Header verwendet, die für die meisten Antworten gelten. Weitere Informationen über allgemeine Antwort-Header finden Sie unter Allgemeine Antwort-Header.

Antworttext

Dieser Vorgang gibt keinen Antworttext zurück.

Fehler

Weitere Informationen über Amazon S3 Glacier -Ausnahmen und -Fehlermeldungen finden Sie unterFehlermeldungenaus.

Beispiele

Beispielanfrage

Das folgende Beispiel zeigt die HTTP-POST-Anforderung mit den Tags, die dem Tresor hinzugefügt werden sollen.

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

Beispielantwort

Wenn die Anforderung erfolgreich war, gibt S3 Glacier einenHTTP 204 No Contentsiehe folgendes Beispiel.

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

Zugehörige Abschnitte

• List Tags For Vault (GET tags)

• Remove Tags From Vault (POST tags remove)

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen Amazon -SDKs finden Sie unter:

• AWS Command Line Interface