**Cette page est réservée aux clients existants du service Amazon Glacier utilisant Vaults et l'API REST d'origine datant de 2012.**

Si vous recherchez des solutions de stockage d'archives, nous vous recommandons d'utiliser les classes de stockage Amazon 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 [classes de stockage Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (service autonome d'origine basé sur un coffre-fort) n'accepte plus de nouveaux clients. Amazon Glacier est un service autonome doté de son propre service APIs qui stocke les données dans des coffres-forts et qui se distingue des classes de stockage Amazon S3 et Amazon S3 Glacier. Vos données existantes resteront sécurisées et accessibles indéfiniment dans Amazon Glacier. Aucune migration n'est requise. Pour un stockage d'archivage à long terme et à faible coût AWS , nous [recommandons les classes de stockage Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), qui offrent une expérience client supérieure avec des compartiments S3, une Région AWS disponibilité totale APIs, des coûts réduits et AWS une intégration des services. Si vous souhaitez des fonctionnalités améliorées, envisagez de migrer vers les classes de stockage Amazon S3 Glacier en suivant nos [conseils relatifs aux AWS solutions pour le transfert de données depuis les coffres-forts Amazon Glacier vers les classes de stockage Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-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.

# Opérations de récupération des données
<a name="data-retrieval-policy-operations"></a>

Les opérations liées à la récupération de données disponibles dans Amazon Glacier sont les suivantes.

**Topics**
+ [Obtention de la stratégie d'extraction de données (GET policy)](api-GetDataRetrievalPolicy.md)
+ [Répertorier la capacité provisionnée (GET provisioned-capacity)](api-ListProvisionedCapacity.md)
+ [Acheter la capacité provisionnée (POST provisioned-capacity)](api-PurchaseProvisionedCapacity.md)
+ [Définition de stratégie d'extraction de données (PUT policy)](api-SetDataRetrievalPolicy.md)

# Obtention de la stratégie d'extraction de données (GET policy)
<a name="api-GetDataRetrievalPolicy"></a>

## Description
<a name="api-GetDataRetrievalPolicy-description"></a>

Cette opération renvoie la politique de récupération de données actuelle pour la AWS région Compte AWS et la région spécifiées dans la `GET` demande. Pour plus d'informations sur les stratégies d'extraction de données, consultez la section [Politiques de récupération des données Amazon Glacier](data-retrieval-policy.md).

## Requêtes
<a name="api-GetDataRetrievalPolicy-requests"></a>

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
<a name="api-GetDataRetrievalPolicy-requests-syntax"></a>

```
1. GET /AccountId/policies/data-retrieval HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**Note**  
La `AccountId` valeur est l' Compte AWS ID. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. Vous pouvez spécifier un Compte AWS identifiant ou éventuellement un seul « `-` » (trait d'union), auquel cas Amazon Glacier utilise l' Compte AWS identifiant 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
<a name="api-GetDataRetrievalPolicy-requests-parameters"></a>

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

### En-têtes de demande
<a name="api-GetDataRetrievalPolicy-requests-headers"></a>

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](api-common-request-headers.md).

### Corps de la requête
<a name="api-GetDataRetrievalPolicy-requests-elements"></a>

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

## Réponses
<a name="api-GetDataRetrievalPolicy-responses"></a>

### Syntaxe
<a name="api-GetDataRetrievalPolicy-responses-syntax"></a>

```
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
<a name="api-GetDataRetrievalPolicy-responses-headers"></a>

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](api-common-response-headers.md).

### Corps de la réponse
<a name="api-GetDataRetrievalPolicy-responses-elements"></a>

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'existe actuellement qu'une seule règle, qui contient un champ Stratégie et éventuellement un BytesPerHour champ.  
*Type* : tableau

**Stratégie**  
Le type de stratégie d'extraction de données.  
*Type* : chaîne  
Valeurs valides : `BytesPerHour`\$1`FreeTier`\$1`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 de récupération des données Amazon Glacier](data-retrieval-policy.md).

### Erreurs
<a name="api-GetDataRetrievalPolicy-responses-errors"></a>

Pour plus d'informations sur les exceptions et les messages d'erreur d'Amazon Glacier, consultez[Réponses d’erreur](api-error-responses.md).

## Exemples
<a name="api-GetDataRetrievalPolicy-examples"></a>

L'exemple suivant montre comment obtenir une stratégie d'extraction de données.

### Exemple de requête
<a name="api-GetDataRetrievalPolicy-example-request"></a>

Dans cet exemple, une demande `GET` est envoyée à l'URI de l'emplacement d'une stratégie.

```
1. GET /-/policies/data-retrieval HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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
<a name="api-GetDataRetrievalPolicy-example-response"></a>

Une réponse positive affiche la stratégie d'extraction de données dans le corps de la réponse au format JSON. 

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 85
 6.  
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.            "BytesPerHour":10737418240,
13.            "Strategy":"BytesPerHour"
14.           }
15.        ]
16.     }
17. }
```

## Sections connexes
<a name="related-sections-GetDataRetrievalPolicy"></a>

 
+ [Définition de stratégie d'extraction de données (PUT policy)](api-SetDataRetrievalPolicy.md)

 
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)

# Répertorier la capacité provisionnée (GET provisioned-capacity)
<a name="api-ListProvisionedCapacity"></a>

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](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options). 

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](#api-ListProvisionedCapacity-example1-response).

## Syntaxe de la requête
<a name="api-ListProvisionedCapacity-RequestSyntax"></a>

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.

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

 

**Note**  
La `AccountId` valeur est l' Compte AWS ID. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. Vous pouvez spécifier un Compte AWS identifiant ou éventuellement un seul « `-` » (trait d'union), auquel cas Amazon Glacier utilise l' Compte AWS identifiant 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
<a name="api-ListProvisionedCapacity-RequestParameters"></a>

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

## En-têtes de demande
<a name="api-ListProvisionedCapacity-requests-headers"></a>

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](api-common-request-headers.md).

## Corps de la requête
<a name="api-ListProvisionedCapacity-requests-elements"></a>

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

## Réponses
<a name="api-ListProvisionedCapacity-responses"></a>

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

### Syntaxe de la réponse
<a name="api-ListProvisionedCapacity-ResponseSyntax"></a>

```
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
<a name="api-ListProvisionedCapacity-headers"></a>

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](api-common-response-headers.md).

### Corps de la réponse
<a name="api-ListProvisionedCapacity-body"></a>

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

**CapacityId**  <a name="Glacier-ListProvisionedCapacity-response"></a>
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
<a name="api-ListProvisionedCapacity-errors"></a>

Pour plus d'informations sur les exceptions et les messages d'erreur d'Amazon Glacier, consultez[Réponses d’erreur](api-error-responses.md).

## Exemples
<a name="api-ListProvisionedCapacity-examples"></a>

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

### Exemple de requête
<a name="api-ListProvisionedCapacity-example1-request"></a>

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é.

```
1. GET /123456789012/priority-capacity HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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
<a name="api-ListProvisionedCapacity-example1-response"></a>

Si la demande aboutit, Amazon Glacier (Amazon Glacier) renvoie un `HTTP 200 OK` contenant la liste des unités de capacité allouées au compte, comme indiqué dans 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.

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:02:00 GMT
 4. Content-Type: application/json
 5. Content-Length: length
 6. 
 7. {
 8.    "ProvisionedCapacityList",
 9.       {
10.          "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z",
11.          "StartDate": "2017-01-31T14:26:33.031Z",
12.          "ExpirationDate": "2017-02-28T14:26:33.000Z",
13.       },
14.       {
15.          "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z",
16.          "StartDate": "2016-12-13T20:11:51.095Z"",
17.          "ExpirationDate": "2017-01-13T20:11:51.000Z" ",
18.       },
19.       ...
20. }
```

## Sections connexes
<a name="api-ListProvisionedCapacity-related-sections"></a>

 
+ [Acheter la capacité provisionnée (POST provisioned-capacity)](api-PurchaseProvisionedCapacity.md)

# Acheter la capacité provisionnée (POST provisioned-capacity)
<a name="api-PurchaseProvisionedCapacity"></a>

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 extractions accélérées peuvent être effectuées toutes les cinq minutes et fournit un débit de récupération allant jusqu'à 150 MB/s  %. Pour plus d'informations sur la capacité allouée, consultez [Options de récupération des archives](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options). 

**Note**  
Il y a une limite de deux unités de capacité provisionnées par. Compte AWS

## Requêtes
<a name="api-PurchaseProvisionedCapacity-requests"></a>

Pour acheter une unité de capacité provisionnée pour Compte AWS envoyer une `POST` requête HTTP à l'URI de capacité provisionnée.

### Syntaxe
<a name="api-PurchaseProvisionedCapacity-requests-syntax"></a>

```
1. POST /AccountId/provisioned-capacity HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. x-amz-glacier-version: 2012-06-01
```

 

**Note**  
La `AccountId` valeur est l' Compte AWS ID. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. Vous pouvez spécifier un Compte AWS identifiant ou éventuellement un seul « `-` » (trait d'union), auquel cas Amazon Glacier utilise l' Compte AWS identifiant 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
<a name="api-PurchaseProvisionedCapacity-requestParameters"></a>

#### En-têtes de demande
<a name="api-PurchaseProvisionedCapacity-requests-headers"></a>

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](api-common-request-headers.md).

#### Corps de la requête
<a name="api-PurchaseProvisionedCapacity-requests-elements"></a>

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

## Réponses
<a name="api-PurchaseProvisionedCapacity-responses"></a>

Si la demande d'opération aboutit, le service renvoie une réponse HTTP `201 Created`.

### Syntaxe
<a name="api-PurchaseProvisionedCapacity-response-syntax"></a>

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

### En-têtes de réponse
<a name="api-PurchaseProvisionedCapacity-responses-headers"></a>

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](api-common-response-headers.md).


|  Nom  |  Description | 
| --- | --- | 
|  `x-amz-capacity-id`   |  L'ID qui identifie l'unité de capacité provisionnée. Type : Chaîne  | 

### Corps de la réponse
<a name="api-PurchaseProvisionedCapacity-responses-elements"></a>

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

### Erreurs
<a name="api-PurchaseProvisionedCapacity-responses-errors"></a>

Cette opération inclut l'erreur ou les erreurs suivantes, en plus des erreurs possibles communes à toutes les opérations Amazon Glacier. Pour plus d'informations sur les erreurs Amazon Glacier et obtenir la liste des codes d'erreur, consultez[Réponses d’erreur](api-error-responses.md).


| 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
<a name="api-PurchaseProvisionedCapacity-examples"></a>

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

### Exemple de requête
<a name="api-PurchaseProvisionedCapacity-example-request"></a>

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

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

### Exemple de réponse
<a name="api-PurchaseProvisionedCapacity-example-response"></a>

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

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

## Sections connexes
<a name="api-PurchaseProvisionedCapacity-related-sections"></a>

 
+ [Répertorier la capacité provisionnée (GET provisioned-capacity)](api-ListProvisionedCapacity.md)

# Définition de stratégie d'extraction de données (PUT policy)
<a name="api-SetDataRetrievalPolicy"></a>

## Description
<a name="api-SetDataRetrievalPolicy-description"></a>

Cette opération définit puis met en œuvre une politique de récupération de données dans la AWS région spécifiée dans la `PUT` demande. Vous pouvez définir une politique par AWS région pour un Compte AWS. La stratégie est appliquée en quelques minutes dans le cadre d'une opération `PUT` réussie. 

 L'opération de définition de stratégie n'a pas d'incidence sur les tâches d'extraction qui étaient en cours avant l'application de la stratégie. Pour plus d'informations sur les stratégies d'extraction de données, consultez la section [Politiques de récupération des données Amazon Glacier](data-retrieval-policy.md). 

## Requêtes
<a name="api-SetDataRetrievalPolicy-requests"></a>

### Syntaxe
<a name="api-SetDataRetrievalPolicy-requests-syntax"></a>

Pour définir une stratégie d'extraction de données, envoyez une demande HTTP PUT à l'URI de stratégie d'extraction de données, comme illustré dans l'exemple de syntaxe suivant.

```
 1. PUT /AccountId/policies/data-retrieval HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. Content-Length: Length
 6. x-amz-glacier-version: 2012-06-01
 7. 			
 8. {
 9.   "Policy":
10.     {
11.       "Rules":[
12.          {
13.              "Strategy": String,
14.              "BytesPerHour": Number          
15.          }
16.        ]
17.     }
18. }
```

 

**Note**  
La `AccountId` valeur est l' Compte AWS ID. Cette valeur doit correspondre à l' Compte AWS ID associé aux informations d'identification utilisées pour signer la demande. Vous pouvez spécifier un Compte AWS identifiant ou éventuellement un seul « `-` » (trait d'union), auquel cas Amazon Glacier utilise l' Compte AWS identifiant 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
<a name="api-SetDataRetrievalPolicy-requests-parameters"></a>

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

### En-têtes de demande
<a name="api-SetDataRetrievalPolicy-requests-headers"></a>

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](api-common-request-headers.md).

### Corps de la requête
<a name="api-SetDataRetrievalPolicy-requests-elements"></a>

Le corps de la demande contient les champs JSON suivants.

 

**BytesPerHour**  
Nombre maximal d'octets pouvant être extraits en une heure.  
Ce champ n'est obligatoire que si la valeur du champ Strategy est `BytesPerHour`. Votre opération PUT est refusée si la valeur du champ Strategy n'est pas `BytesPerHour` et que vous définissez ce champ.  
*Type* : nombre  
*Obligatoire* : oui, si la valeur du champ Stratégie est `BytesPerHour`. Dans le cas contraire, ce champ n'est pas obligatoire.  
*Valeurs valides* : la valeur d'entier minimale est 1. La valeur d'entier maximale est comprise entre 2^63 et 1 (inclus).

**Règles**  
Règle de stratégie. Bien qu'il s'agisse d'un type de liste, il ne doit actuellement y avoir qu'une seule règle, qui contient un champ Stratégie et éventuellement un BytesPerHour champ.  
*Type* : tableau  
*Obligatoire* : oui

**Stratégie**  
Type de stratégie d'extraction de données à définir.  
*Type* : chaîne  
*Obligatoire* : oui  
Valeurs valides : `BytesPerHour`\$1`FreeTier`\$1`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 de récupération des données Amazon Glacier](data-retrieval-policy.md).

## Réponses
<a name="api-SetDataRetrievalPolicy-responses"></a>

### Syntaxe
<a name="api-SetDataRetrievalPolicyresponse-syntax"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```

### En-têtes de réponse
<a name="api-SetDataRetrievalPolicy-responses-headers"></a>

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](api-common-response-headers.md).

### Corps de la réponse
<a name="api-SetDataRetrievalPolicy-responses-elements"></a>

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

### Erreurs
<a name="api-SetDataRetrievalPolicy-responses-errors"></a>

Pour plus d'informations sur les exceptions et les messages d'erreur d'Amazon Glacier, consultez[Réponses d’erreur](api-error-responses.md).

## Exemples
<a name="api-SetDataRetrievalPolicy-examples"></a>

### Exemple de requête
<a name="api-SetDataRetrievalPolicy-example-request"></a>

L'exemple suivant envoie une demande HTTP PUT avec la valeur `BytesPerHour` définie pour le champ Strategy. 

```
 1. PUT /-/policies/data-retrieval HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-Date: 20170210T120000Z
 4. x-amz-glacier-version: 2012-06-01
 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"BytesPerHour",
13.              "BytesPerHour":10737418240       
14.           }
15.        ]
16.     }
17. }
```

L'exemple suivant envoie une demande HTTP PUT avec la valeur `FreeTier` définie pour le champ Strategy. 

```
 1. PUT /-/policies/data-retrieval HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-Date: 20170210T120000Z
 4. x-amz-glacier-version: 2012-06-01
 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"FreeTier"   
13.           }
14.        ]
15.     }
16. }
```

L'exemple suivant envoie une demande HTTP PUT avec la valeur `None` définie pour le champ Strategy. 

```
 1. PUT /-/policies/data-retrieval HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-Date: 20170210T120000Z
 4. x-amz-glacier-version: 2012-06-01
 5. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"None"   
13.           }
14.        ]
15.     }
16. }
```

### Exemple de réponse
<a name="api-SetDataRetrievalPolicy-example-response"></a>

Si la demande est acceptée, Amazon Glacier (Amazon Glacier) définit la politique et renvoie un `HTTP 204 No Content` comme indiqué dans l'exemple suivant.

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```

## Sections connexes
<a name="related-sections-SetDataRetrievalPolicy"></a>

 
+ [Obtention de la stratégie d'extraction de données (GET policy)](api-GetDataRetrievalPolicy.md)

 
+ [Lancement d'une tâche (POST jobs)](api-initiate-job-post.md)