Set Data Retrieval Policy (PUT policy)

Beschreibung

Durch diese Operation wird eine Richtlinie für den Datenabruf in der AWS-Region, die in der PUT-Anforderung angegeben wurde, eingerichtet und dann umgesetzt. Sie können eine Richtlinie pro AWS-Region für ein AWS-Konto einrichten. Die Richtlinie wird bei einer erfolgreichen PUT-Operation innerhalb weniger Minuten umgesetzt.

Die Operation zur Einrichtung der Richtlinie wirkt sich nicht auf Abrufaufträge aus, die in Bearbeitung waren, bevor die Richtlinie umgesetzt wurde. Weitere Informationen zu Datenabrufrichtlinien finden Sie unter Richtlinien für den Datenabruf in S3 Glacier.

Anforderungen

Syntax

Senden Sie eine HTTP-PUT-Anfrage an den URI der Datenabrufrichtlinie, um eine Datenabrufrichtlinie einzurichten. Orientieren Sie sich dabei an dem folgenden Syntaxbeispiel.

PUT /AccountId/policies/data-retrieval HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01
			
{
  "Policy":
    {
      "Rules":[
         {
             "Strategy": String,
             "BytesPerHour": Number          
         }
       ]
    }
}

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

Der Anforderungstext enthält die folgenden JSON-Felder.

BytesPerHour

Die Höchstanzahl an Bytes, die in einer Stunde abgerufen werden können.

Dieses Feld ist nur dann ein Pflichtfeld, wenn der Wert im Strategy-Feld BytesPerHour ist. Ihre PUT-Operation wird abgelehnt, wenn das Strategy-Feld nicht auf BytesPerHour festgelegt ist und Sie dieses Feld festlegen.

Typ: Zahl

Erforderlich: Ja, wenn das Strategie-Feld auf BytesPerHour festgelegt ist. Ansonsten nein.

Gültige Werte: Mindestganzzahlwert 1. Höchstganzzahlwert 2^63 - 1 inklusive.

Regeln

Die Richtlinienregel. Obwohl es sich hierbei um einen Listentyp handelt, darf nur eine einzige Regel angezeigt sein, die ein Strategy-Feld und optional ein BytesPerHour-Feld enthält.

Typ: Array

Required: Yes

Strategie

Der Typ der einzurichtenden Datenabrufrichtlinie.

Typ: Zeichenfolge

Required: Yes

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.

Antworten

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

Im folgenden Beispiel wird eine HTTP-PUT-Anfrage gesendet, mit dem Strategy-Feld festgelegt auf BytesPerHour.

PUT /-/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
			
{
  "Policy":
    {
      "Rules":[
         {
             "Strategy":"BytesPerHour",
             "BytesPerHour":10737418240       
          }
       ]
    }
}

Im folgenden Beispiel wird eine HTTP-PUT-Anfrage gesendet, mit dem Strategy-Feld festgelegt auf FreeTier.

PUT /-/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
			
{
  "Policy":
    {
      "Rules":[
         {
             "Strategy":"FreeTier"   
          }
       ]
    }
}

Im folgenden Beispiel wird eine HTTP-PUT-Anfrage gesendet, mit dem Strategy-Feld festgelegt auf None.

PUT /-/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
			
{
  "Policy":
    {
      "Rules":[
         {
             "Strategy":"None"   
          }
       ]
    }
}

Beispielantwort

Falls die Anforderung erfolgreich war, legt Amazon S3 Glacier (S3 Glacier) die Richtlinie fest und gibt 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

• Get Data Retrieval Policy (GET policy)

• Initiate Job (POST jobs)