Diese Seite richtet sich nur an Bestandskunden des S3 Glacier-Dienstes, die Vaults und das Original REST API von 2012 verwenden.
Wenn Sie nach Archivspeicherlösungen suchen, empfehlen wir die Verwendung der S3 Glacier-Speicherklassen in Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval und S3 Glacier Deep Archive. Weitere Informationen zu diesen Speicheroptionen finden Sie unter S3 Glacier-Speicherklassen
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.
Get Data Retrieval Policy (GET policy)
Beschreibung
Dieser Vorgang gibt die aktuelle Richtlinie für den Datenabruf für das AWS-Konto und die AWS-Region zurück, die in der GET
-Anforderung angegeben sind. Weitere Informationen zu Datenabrufrichtlinien finden Sie unter Richtlinien für den Datenabruf in S3 Glacier.
Anforderungen
Senden Sie eine HTTP-GET
-Anforderung an den URI der Richtlinie für den Datenabruf, damit die aktuelle Datenabruf-Richtlinie zurückgegeben wird. Orientieren Sie sich dabei an dem folgenden Syntaxbeispiel.
Syntax
GET /
AccountId
/policies/data-retrieval 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
Syntax
HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: length { "Policy": { "Rules":[ { "BytesPerHour": Number, "Strategy": 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.
- BytesPerHour
-
Die Höchstanzahl an Bytes, die in einer Stunde abgerufen werden können.
Dieses Feld ist nur vorhanden, wenn der Wert im Strategy-Feld
BytesPerHour
ist.Typ: Zahl
- Regeln
-
Die Richtlinienregel. Obwohl es sich hierbei um einen Listentyp handelt, wird nur eine einzige Regel angezeigt, die ein Strategy-Feld und optional ein BytesPerHour-Feld enthält.
Typ: Array
- Strategie
-
Der Typ der Richtlinie für den Datenabruf.
Typ: Zeichenfolge
Gültige Werte:
BytesPerHour
|FreeTier
|None
.BytesPerHour
entspricht der Auswahl von Max Retrieval Rate (Max. Abrufrate) in der Konsole.FreeTier
entspricht der Auswahl von Free Tier Only (Nur kostenloses Kontingent) in der Konsole.None
entspricht der Auswahl von No Retrieval Policy (Keine Abrufrichtlinie) in der Konsole. Weitere Informationen zur Auswahl von Datenabrufrichtlinien in der Konsole finden Sie unter Richtlinien für den Datenabruf in S3 Glacier.
Fehler
Weitere Informationen über Ausnahmen und Fehlermeldungen in Amazon S3 Glacier finden Sie unter Fehlermeldungen.
Beispiele
Das folgende Beispiel demonstriert, wie eine Richtlinie für den Datenabruf abgerufen wird.
Beispielanfrage
In diesem Beispiel wird eine GET
-Anforderung an den URI für den Speicherort der Richtlinie gesendet.
GET /-/policies/data-retrieval 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
Falls die Anforderung erfolgreich beantwortet wird, wird die Richtlinie für den Datenabruf im Antworttext im JSON-Format angezeigt.
HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Content-Type: application/json Content-Length: 85 { "Policy": { "Rules":[ { "BytesPerHour":10737418240, "Strategy":"BytesPerHour" } ] } }
Zugehörige Abschnitte