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
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.
Obtention de la stratégie d'extraction de données (GET policy)
Description
Cette opération renvoie la politique d'extraction de données actuelle pour le Compte AWS et la région AWS spécifiés dans la demande GET
. Pour plus d'informations sur les stratégies d'extraction de données, consultez la section Politiques d'extraction de données S3 Glacier.
Requêtes
Pour obtenir la stratégie actuelle d'extraction de données, envoyez une demande HTTP GET
à l'URI de la stratégie d'extraction de données, comme illustré dans l'exemple de syntaxe suivant.
Syntaxe
GET /
AccountId
/policies/data-retrieval 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
Syntaxe
HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: length { "Policy": { "Rules":[ { "BytesPerHour": Number, "Strategy": 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.
- BytesPerHour
-
Nombre maximal d'octets pouvant être extraits en une heure.
Ce champ sera présent uniquement si la valeur du champ Stratégie est
BytesPerHour
.Type : nombre
- Règles
-
Règle de stratégie. Bien qu'il s'agisse d'un type de liste, il n'y a à l'heure actuelle qu'une seule règle, qui contient un champ Strategy et éventuellement un champ BytesPerHour.
Type : tableau
- Stratégie
-
Le type de stratégie d'extraction de données.
Type : chaîne
Valeurs valides :
BytesPerHour
|FreeTier
|None
.BytesPerHour
équivaut à sélectionner Taux d'extraction max. dans la console.FreeTier
équivaut à sélectionner Offre gratuite uniquement dans la console.None
équivaut à sélectionner No Retrieval Policy (Pas de stratégie d'extraction) dans la console. Pour plus d'informations sur la sélection de stratégies d'extraction de données dans la console, consultez la section Politiques d'extraction de données S3 Glacier.
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 montre comment obtenir une stratégie d'extraction de données.
Exemple de requête
Dans cet exemple, une demande GET
est envoyée à l'URI de l'emplacement d'une stratégie.
GET /-/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
Exemple de réponse
Une réponse positive affiche la stratégie d'extraction de données dans le corps de la réponse au format JSON.
HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:00:00 GMT Content-Type: application/json Content-Length: 85 { "Policy": { "Rules":[ { "BytesPerHour":10737418240, "Strategy":"BytesPerHour" } ] } }
Sections connexes