List Provisioned Capacity (GET provisioned-capacity)

Dieser Vorgang führt die bereitgestellten Kapazitätseinheiten für das angegebene AWS-Konto auf. Weitere Informationen über bereitgestellte Kapazität finden Sie unter Archiv-Abrufoptionen.

Eine bereitgestellte Kapazitätseinheit ist ab dem Datum und der Uhrzeit des Kaufs (dem Startdatum), einen Monat lang gültig. Die Einheit läuft am Ablaufdatum ab, das auf die nächste Sekunde gerundet genau einen Monat nach dem Startdatum liegt.

Wenn das Startdatum der 31. Tag eines Monats ist, dann ist der letzte Tag des nächsten Monats das Ablaufdatum. Beispiel: Ist das Startdatum der 31. August, dann ist der 30. September das Ablaufdatum. Ist das Startdatum der 31. Januar, dann ist der 28. Februar das Ablaufdatum. Diese Funktionalität wird im Beispielantwort veranschaulicht.

Anforderungssyntax

Wenn Sie die bereitgestellte Abrufkapazität für ein Konto aufführen möchten, senden Sie eine HTTP GET-Anfrage an den URI der bereitgestellten Kapazität, wie im folgenden Syntax-Beispiel verdeutlicht wird.

GET /AccountId/provisioned-capacity 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
{
   "ProvisionedCapacityList": 
      {
         "CapacityId" : "string",
         "StartDate" : "string"
         "ExpirationDate" : "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.

CapacityId

Die ID, mit der die bereitgestellte Kapazitätseinheit identifiziert wird.

Typ: Zeichenfolge.

StartDate

Das Datum (Coordinated Universal Time – UTC), an dem die bereitgestellte Kapazitätseinheit gekauft wurde.

Typ: Zeichenfolge. Eine Zeichenfolgendarstellung im ISO 8601-Datumsformat, zum Beispiel 2013-03-20T17:03:43.221Z.

ExpirationDate

Das Datum (Coordinated Universal Time – UTC), an dem die bereitgestellte Kapazitätseinheit abläuft wurde.

Typ: Zeichenfolge. Eine Zeichenfolgendarstellung im ISO 8601-Datumsformat, zum Beispiel 2013-03-20T17:03:43.221Z.

Fehler

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

Beispiele

Es folgt ein Beispiel für das Aufführen der bereitgestellten Kapazitätseinheiten für ein Konto.

Beispielanfrage

In diesem Beispiel wird eine GET-Anfrage gesendet, um eine Liste der bereitgestellten Kapazitätseinheiten für das angegebene Konto abzurufen.

GET /123456789012/priority-capacity 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 bereitgestellten Kapazitätseinheiten für das Konto zurück, wie im folgenden Beispiel dargestellt.

Die zuerst angeführte bereitgestellte Kapazitätseinheit ist ein Beispiel einer Einheit mit dem 31. Januar 2017 als Startdatum und dem 28. Februar 2017 als Ablaufdatum. Wie bereits erwähnt, ist das Ablaufdatum bei einem Startdatum am 31. Tag eines Monats der letzte Tag des nächsten Monats.

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

{
   "ProvisionedCapacityList",
      {
         "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z",
         "StartDate": "2017-01-31T14:26:33.031Z",
         "ExpirationDate": "2017-02-28T14:26:33.000Z",
      },
      {
         "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z",
         "StartDate": "2016-12-13T20:11:51.095Z"",
         "ExpirationDate": "2017-01-13T20:11:51.000Z" ",
      },
      ...
}

Zugehörige Abschnitte

• Purchase Provisioned Capacity (POST provisioned-capacity)