Si vous débutez dans le stockage d'archives dans Amazon Simple Storage Service (Amazon S3), nous vous recommandons dans un premier temps de vous familiariser avec les classes de stockage S3 Glacier dans Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval et S3 Glacier Deep Archive. Pour plus d'informations, consultez les sections Classes de stockage S3 Glacier et Classes de stockage pour l'archivage d'objets dans le guide de l'utilisateur Amazon S3.

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.

Acheter la capacité provisionnée (POST provisioned-capacity)

Cette opération achète une unité de capacité provisionnée pour un Compte AWS.

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.

La capacité provisionnée garantit que la capacité de récupération pour les récupérations rapides est disponible lorsque vous en avez besoin. Chaque unité de capacité garantit qu'au moins trois récupérations rapides peuvent être effectuées toutes les cinq minutes et fournit jusqu'à 150 Mo/s du débit de récupération. Pour plus d'informations sur la capacité allouée, consultez Options de récupération des archives.

Requêtes

Pour acheter une unité de capacité provisionnée pour un Compte AWS, envoyez une demande HTTP POST à l'URI de capacité provisionnée.

Syntaxe

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

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 la demande d'opération aboutit, le service renvoie une réponse HTTP 201 Created.

Syntaxe

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-capacity-id: CapacityId

En-têtes de réponse

Une réponse positive comprend les en-têtes de réponse suivants, en plus de ceux communs à toutes les opérations. 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

Cette opération ne renvoie pas de corps de réponse.

Erreurs

Cette opération inclut la ou les erreurs suivantes, en plus des erreurs possibles communes à toutes les opérations Amazon S3 Glacier. Pour en savoir plus sur les erreurs Amazon S3 Glacier et pour obtenir la liste des codes d'erreur, consultez Réponses d'erreur.

Exemples

L'exemple suivant illustre le cas d'un achat de capacité provisionnée pour un compte.

Exemple de requête

L'exemple suivant envoie une demande HTTP POST pour acheter une unité de capacité provisionnée.

POST /123456789012/provisioned-capacity HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Content-Length: length
x-amz-glacier-version: 2012-06-01

Exemple de réponse

Si la demande aboutit, Amazon S3 Glacier (S3 Glacier) renvoie une réponse HTTP 201 Created, comme dans l'exemple suivant.

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
x-amz-capacity-id: zSaq7NzHFQDANTfQkDen4V7z

Sections connexes