Acheter la capacité provisionnée (POST provisioned-capacity) - Amazon S3 Glacier
RequêtesRéponsesExemplesSections connexes

Cette page est réservée aux clients existants du service S3 Glacier utilisant Vaults et l'original REST API 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 Amazon S3API, 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 chiffrement optionnelles avancées, 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.

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.

Note

Il existe une limite de deux unités de capacité provisionnées par Compte AWS.

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

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

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.

Name (Nom) Description

x-amz-capacity-id

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

Type : chaîne

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.

Code Description HTTP Status Code Type
LimitExceededException Retournée si la requête donnée dépasse la limite du compte pour les unités de capacité provisionnée. 400 Bad Request Client

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