Diese Seite ist nur für Bestandskunden des S3 Glacier-Dienstes bestimmt, die Vaults und die ursprüngliche 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 Vault Access Policy (GET access-policy)
Beschreibung
Durch diesen Vorgang wird die im Tresor festgelegte access-policy
-Unterressource abgerufen. Weitere Informationen zum Festlegen dieser Unterressource finden Sie unter Set Vault Access Policy (PUT access-policy). Wenn auf dem Tresor keine Zugriffsrichtlinie eingerichtet ist, gibt die Operation einen 404 Not
found
-Fehler zurück. Weitere Informationen zu Tresorzugriffsrichtlinien finden Sie unter Richtlinien für den Tresorzugriff.
Anforderungen
Um die aktuelle Tresorzugriffsrichtlinie zurückzugeben, senden Sie eine HTTP-GET
-Anfrage an den URI der Unterressource access-policy
des Tresors.
Syntax
GET /
AccountId
/vaults/vaultName
/access-policy 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 des Kontos, dem der Tresor gehört. Sie können entweder eine AWS-Konto ID oder optional ein einzelnes '-
' (Bindestrich) angeben. In diesem Fall verwendet Amazon S3 Glacier die AWS-Konto ID, die den Anmeldeinformationen zugeordnet ist, die zum Signieren der Anfrage verwendet wurden. Wenn Sie eine Konto-ID verwenden, darf die ID keine Bindestriche („-“) enthalten.
Anforderungsparameter
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
Als Antwort gibt Amazon S3 Glacier (S3 Glacier) die Tresorzugriffsrichtlinie im JSON-Format im Antworttext zurück.
Syntax
HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: length { "Policy": "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.
- Richtlinie
-
Die Tresorzugriffsrichtlinie als eine JSON-Zeichenfolge, die "\" als Escape-Zeichen verwendet.
Typ: Zeichenfolge
Fehler
Weitere Informationen über Ausnahmen und Fehlermeldungen in Amazon S3 Glacier finden Sie unter Fehlermeldungen.
Beispiele
Das folgende Beispiel zeigt, wie eine Tresorzugriffsrichtlinie abgerufen wird.
Beispielanfrage
In diesem Beispiel wird eine GET
-Anforderung an den URI der access-policy
-Unterressource eines Tresors gesendet.
GET /-/vaults/examplevault/access-policy 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 Antwort erfolgreich war, gibt S3 Glacier die Tresorzugriffsrichtlinie als JSON-Zeichenfolge im Antworttext zurück. Die zurückgegebene JSON-Zeichenfolge verwendet „\“ als Escape-Zeichen, wie in den Beispielen Set Vault Access Policy (PUT access-policy) gezeigt. Das folgende Beispiel zeigt die zurückgegebene JSON-Zeichenfolge zur besseren Lesbarkeit allerdings ohne als Escape-Zeichen.
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: length
{
"Policy": "
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "allow-time-based-deletes",
"Principal": {
"AWS": "999999999999"
},
"Effect": "Allow",
"Action": "glacier:Delete*",
"Resource": [
"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
],
"Condition": {
"DateGreaterThan": {
"aws:CurrentTime": "2018-12-31T00:00:00Z"
}
}
}
]
}
"
}
Zugehörige Abschnitte
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen Amazon SDKs finden Sie im Folgenden: