List Tags For Vault (GET tags) - Amazon S3 Glacier

Wenn Sie mit dem Archivierungsspeicher in Amazon Simple Storage Service (Amazon S3) noch nicht vertraut sind, empfehlen wir Ihnen, sich zunächst über die S3-Glacier-Speicherklassen in Amazon S3 (S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval und S3 Glacier Deep Archive) zu informieren. Weitere Informationen finden Sie unter S3-Glacier-Speicherklassen und Speicherklassen für die Archivierung von Objekten im Amazon S3-Benutzerhandbuch.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

List Tags For Vault (GET tags)

Diese Operation listet alle Tags auf, die einem Tresor angefügt sind. Die Operation gibt eine leere Zuweisung zurück, wenn keine Tags vorhanden sind. Weitere Informationen zu Tags erhalten Sie unter Markieren von Amazon-S3-Glacier-Ressourcen.

Anforderungssyntax

Um die Tags für einen Tresor aufzulisten, senden Sie eine HTTP-GET-Anfrage an den URI der Tags, wie im folgenden Syntaxbeispiel gezeigt.

GET /AccountId/vaults/vaultName/tags HTTP/1.1 Host: glacier.Region.amazonaws.com Date: Date Authorization: SignatureValue x-amz-glacier-version: 2012-06-01

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

Dieser Vorgang verwendet keine Anforderungsparameter.

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

Dieser Vorgang besitzt keinen Anforderungstext.

Antworten

Wenn die Operation erfolgreich ist, sendet der Service eine HTTP-200 OK-Antwort zurück.

Antwortsyntax

HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "Tags": { "string" : "string", "string" : "string" } }

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

Der Antworttext enthält die folgenden JSON-Felder.

Tags

Die dem Tresor angefügten Tags. Jedes Tag besteht aus einem Schlüssel und einem Wert.

Typ: Zeichenfolge-zu-Zeichenfolge-Zuweisung

Required: Yes

Fehler

Weitere Informationen über Ausnahmen und Fehlermeldungen in Amazon S3 Glacier finden Sie unter Fehlermeldungen.

Beispiele

Beispiel: Auflisten von Tags für einen Tresor

Das folgende Beispiel listet die Tags für einen Tresor auf.

Beispielanfrage

In diesem Beispiel wird eine GET-Anfrage gesendet, um eine Liste von Tags von dem angegebenen Tresor abzurufen.

GET /-/vaults/examplevault/tags HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Beispielantwort

Wenn die Anforderung erfolgreich war, gibt Amazon S3 Glacier (S3 Glacier) HTTP 200 OK mit einer Liste der Tags für den Tresor zurück, wie im folgenden Beispiel dargestellt.

HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT Content-Type: application/json Content-Length: length { "Tags", { "examplekey1": "examplevalue1", "examplekey2": "examplevalue2" } }

Weitere Informationen finden Sie unter:

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