Remove Tags From Vault (POST tags remove)

Mit dieser Operation werden Tags aus der Gruppe der Tags entfernt, die einem Tresor angefügt sind. Weitere Informationen zu Tags erhalten Sie unter Markieren von Amazon-S3-Glacier-Ressourcen.

Dieser Vorgang ist idempotent. Der Vorgang wird erfolgreich ausgeführt, auch wenn dem Tresor keine Tags angefügt wurden.

Anforderungssyntax

Um Tags aus einem Tresor zu entfernen, senden Sie eine HTTP-POST-Anforderung an den URI der Tags, wie im folgenden Syntaxbeispiel gezeigt.

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

Anmerkung

Der AccountId-Wert ist die AWS-Konto-ID. Dieser Wert muss mit der AWS-Konto-ID übereinstimmen, die mit den zum Signieren der Anforderung verwendeten Anmeldeinformationen verknüpft ist. Sie können entweder eine AWS-Konto-ID oder optional einen einzelnen Bindestrich („-“) angeben. Bei Angabe eines Bindestrichs verwendet Amazon S3 Glacier die AWS-Konto-ID, die mit den zum Signieren der Anforderung verwendeten Anmeldeinformationen verknüpft ist. Wenn Sie Ihre Konto-ID angeben, müssen Sie sie ohne Bindestriche („-“) eingeben.

Anfrageparameter

Name	Beschreibung	Erforderlich
operation=remove	Ein einziger Abfragezeichenfolgeparameter operation mit dem Wert remove zur Unterscheidung von Add Tags To Vault (POST tags add).	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 Anforderungstext enthält die folgenden JSON-Felder.

TagKeys

Eine Liste der Tag-Schlüssel. Alle entsprechenden Tags werden aus dem Tresor entfernt.

Typ: Zeichenfolge-Array

Längenbeschränkung: Mindestens 1 Element in der Liste. Maximal 10 Elemente in der Liste.

Required: Yes

Antworten

Wenn die Aktion erfolgreich ist, gibt der Dienst die HTTP-Antwort 204 No Content mit leerem HTTP-Textinhalt 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 Ausnahmen und Fehlermeldungen in Amazon S3 Glacier finden Sie unter Fehlermeldungen.

Beispiele

Beispielanfrage

Das folgende Beispiel zeigt die HTTP-POST-Anforderung zum Entfernen der angegebenen Tags.

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

Beispielantwort

Falls die Anforderung erfolgreich war, gibt Amazon S3 Glacier (S3 Glacier) HTTP 204 No Content zurück, wie im folgenden Beispiel gezeigt.

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

• Add Tags To Vault (POST tags add)

• List Tags For Vault (GET tags)

Weitere Informationen finden Sie unter:

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

• AWS Command Line Interface