Get Vault Access Policy (GET access-policy)

Beschreibung

Dieser Vorgang ruft denaccess-policyim Tresor festgelegte Unterressource — Weitere Informationen zum Festlegen dieser Unterressource finden Sie unterSet Vault Access Policy (PUT access-policy)aus. 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

DieAccountIdvalue ist derAWS-KontoDie ID des -Kontos, das den Tresor besitzt. Führen Sie dazu einen der folgenden Schritte ausAWS-KontoID oder optional ein einzelnes '-'(Bindestrich), in diesem Fall verwendet Amazon S3 GlacierAWS-KontoDie ID ist mit den zum Signieren der Anforderung verwendeten Anmeldeinformationen verknüpft. Wenn Sie eine Konto-ID verwenden, nehmen Sie keine Bindestriche ('-') in die ID ein.

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

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.

Type: String (Zeichenfolge)

Fehler

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

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 Anforderung erfolgreich war, gibt S3 Glacier die Tresorzugriffsrichtlinie als eine 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

• Delete Vault Access Policy (DELETE access-policy)

• Set Vault Access Policy (PUT access-policy)

Weitere Informationen finden Sie unter:

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

• AWS Command Line Interface