Répertorier la capacité provisionnée (GET provisioned-capacity) - Amazon S3 Glacier
Syntaxe de la requêteParamètres de demandeEn-têtes de demandeCorps de la requêteRéponsesExemplesSections connexes

Cette page s'adresse uniquement aux clients existants du service S3 Glacier utilisant Vaults et l'API REST d'origine datant de 2012.

Si vous recherchez des solutions de stockage d'archives, nous vous conseillons d'utiliser les classes de stockage S3 Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour en savoir plus sur ces options de stockage, consultez les sections Classes de stockage S3 Glacier et Stockage de données à long terme à l'aide des classes de stockage S3 Glacier dans le guide de l'utilisateur Amazon S3. Ces classes de stockage utilisent l'API Amazon S3, sont disponibles dans toutes les régions et peuvent être gérées au sein de la console Amazon S3. Ils offrent des fonctionnalités telles que l'analyse des coûts de stockage, Storage Lens, des fonctionnalités de sécurité, notamment de multiples options de cryptage, etc.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Répertorier la capacité provisionnée (GET provisioned-capacity)

Cette opération répertorie les unités de capacité provisionnées pour le Compte AWS spécifié. Pour plus d'informations sur la capacité allouée, consultez Options de récupération des archives.

Une unité de capacité provisionnée dure un mois à compter de la date et de l'heure d'achat, qui correspondent à la date de début. L'unité expire à la date d'expiration, ce qui correspond à exactement un mois après la date de début, à la seconde près.

Si la date de début est le 31e jour du mois, la date d'expiration correspond au dernier jour du mois suivant. Par exemple, si la date de début est le 31 août, la date d'expiration est le 30 septembre. Si la date de début est le 31 janvier, la date d'expiration est le 28 février. Vous pouvez voir cette fonctionnalité sous Exemple de réponse.

Syntaxe de la requête

Pour afficher la capacité de récupération provisionnée pour un compte, envoyez une demande HTTP GET à l'URI de capacité provisionnée, comme illustré dans l'exemple de syntaxe suivant.

GET /AccountId/provisioned-capacity HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

Note

La valeur de AccountId est l'ID de Compte AWS. Cette valeur doit correspondre à l'ID de Compte AWS associé aux informations d'identification utilisées pour signer la demande. Vous pouvez spécifier un ID de Compte AWS ou éventuellement un simple « - » (trait d'union), auquel cas Amazon S3 Glacier utilise l'ID de Compte AWS associé aux informations d'identification utilisées pour signer la demande. Si vous spécifiez votre ID de compte, n'incluez pas de traits d'union (« - ») dans l'ID.

Paramètres de demande

Cette opération n'utilise pas les paramètres de demande.

En-têtes de demande

Cette opération utilise uniquement les en-têtes de demande qui sont communs à toutes les opérations. Pour plus d'informations sur les en-têtes de demande communs, consultez En-têtes de demande communs.

Corps de la requête

Cette opération n'a pas de corps de demande.

Réponses

Si l'opération aboutit, le service renvoie une réponse HTTP 200 OK.

Syntaxe de la réponse

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"
      }
}

En-têtes de réponse

Cette opération utilise uniquement les en-têtes de réponse qui sont communs à la plupart des réponses. Pour plus d'informations sur les en-têtes de réponse communs, consultez En-têtes de réponse communs.

Corps de la réponse

Le corps de la réponse contient les champs JSON suivants.

CapacityId

L'ID qui identifie l'unité de capacité provisionnée.

Type : chaîne.

StartDate

Date d'achat de la capacité provisionnée, fuseau horaire UTC.

Type : chaîne. Représentation sous forme de chaîne au format de date ISO 8601, par exemple 2013-03-20T17:03:43.221Z.

ExpirationDate

Date d'expiration de la capacité provisionnée, fuseau horaire UTC.

Type : chaîne. Représentation sous forme de chaîne au format de date ISO 8601, par exemple 2013-03-20T17:03:43.221Z.

Erreurs

Pour en savoir plus sur les exceptions et les messages d'erreur Amazon S3 Glacier, consultez Réponses d'erreur.

Exemples

L'exemple suivant répertorie les unités de capacité provisionnée pour un compte.

Exemple de requête

Dans cet exemple, une requête GET est envoyée pour récupérer la liste des unités de capacité provisionnée pour le compte spécifié.

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

Exemple de réponse

Si la demande aboutit, Amazon S3 Glacier (S3 Glacier) renvoie HTTP 200 OK avec la liste des unités de capacité provisionnées pour le compte, comme l'illustre l'exemple suivant.

L'unité de capacité provisionnée répertoriée en premier est un exemple d'unité avec une date de début correspondant au 31 janvier 2017 et une date d'expiration correspondant au 28 février 2017. Comme stipulé auparavant, si la date de début est le 31e jour du mois, la date d'expiration correspond au dernier jour du mois suivant.

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" ",
      },
      ...
}