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.

# CreateTieringConfiguration
<a name="API_CreateTieringConfiguration"></a>

Crée une configuration de hiérarchisation.

Une configuration hiérarchisée permet le transfert automatique des données de sauvegarde vers un niveau de stockage moins coûteux en fonction de l'âge des objets sauvegardés dans le coffre de sauvegarde.

Chaque coffre ne peut avoir qu'une seule configuration hiérarchique spécifique au coffre, en plus de toute configuration globale qui s'applique à tous les coffres-forts.

## Syntaxe de la demande
<a name="API_CreateTieringConfiguration_RequestSyntax"></a>

```
PUT /tiering-configurations HTTP/1.1
Content-type: application/json

{
   "CreatorRequestId": "string",
   "TieringConfiguration": { 
      "BackupVaultName": "string",
      "ResourceSelection": [ 
         { 
            "Resources": [ "string" ],
            "ResourceType": "string",
            "TieringDownSettingsInDays": number
         }
      ],
      "TieringConfigurationName": "string"
   },
   "TieringConfigurationTags": { 
      "string" : "string" 
   }
}
```

## Paramètres de demande URI
<a name="API_CreateTieringConfiguration_RequestParameters"></a>

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_CreateTieringConfiguration_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [CreatorRequestId](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-CreatorRequestId"></a>
Il s'agit d'une chaîne unique qui identifie la demande et permet aux demandes ayant échoué d'être réessayées sans risquer d'exécuter l'opération deux fois. Ce paramètre est facultatif. S'il est utilisé, ce paramètre doit contenir de 1 à 50 caractères alphanumériques ou « -\$1. » caractères.  
Type : chaîne  
Obligatoire : non

 ** [TieringConfiguration](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfiguration"></a>
Une configuration de hiérarchisation doit contenir une `TieringConfigurationName` chaîne unique que vous créez et doit contenir un `BackupVaultName` et`ResourceSelection`. Vous pouvez éventuellement inclure une `CreatorRequestId` chaîne.  
`TieringConfigurationName`Il s'agit d'une chaîne unique qui est le nom de la configuration de hiérarchisation. Elle ne peut pas être modifiée après sa création et elle doit être composée uniquement de caractères alphanumériques et de traits de soulignement.  
Type : objet [TieringConfigurationInputForCreate](API_TieringConfigurationInputForCreate.md)  
Obligatoire : oui

 ** [TieringConfigurationTags](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfigurationTags"></a>
Les balises à attribuer à la configuration de hiérarchisation.  
Type : mappage chaîne/chaîne  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_CreateTieringConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "TieringConfigurationArn": "string",
   "TieringConfigurationName": "string"
}
```

## Eléments de réponse
<a name="API_CreateTieringConfiguration_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [CreationTime](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-CreationTime"></a>
Date et heure de création d'une configuration de hiérarchisation, au format Unix et en temps universel coordonné (UTC). La valeur de `CreationTime` est précise en millisecondes. Par exemple, la valeur 1516925490,087 représente le vendredi 26 janvier 2018 à 00 h 11 m 30,087 s.  
Type : Timestamp

 ** [TieringConfigurationArn](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationArn"></a>
Un Amazon Resource Name (ARN) qui identifie de manière unique la configuration de hiérarchisation créée.  
Type : Chaîne

 ** [TieringConfigurationName](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationName"></a>
Cette chaîne unique est le nom de la configuration de hiérarchisation.  
Le nom ne peut pas être modifié après la création. Le nom comprend uniquement des caractères alphanumériques et des traits de soulignement. La longueur maximale est de 200.  
Type : Chaîne

## Erreurs
<a name="API_CreateTieringConfiguration_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** AlreadyExistsException **   
La ressource demandée existe déjà.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Code d’état HTTP : 400

 ** ConflictException **   
 AWS Backup ne peut pas exécuter l'action que vous avez demandée tant qu'il n'a pas terminé d'exécuter une action précédente. Réessayez ultérieurement.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 400

 ** InvalidParameterValueException **   
Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 400

 ** LimitExceededException **   
Une limite de la demande a été dépassée ; par exemple, le nombre maximum d'éléments autorisés dans une demande.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 400

 ** MissingParameterValueException **   
Indique qu'un paramètre obligatoire est manquant.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 400

 ** ServiceUnavailableException **   
La demande a échoué en raison d'une défaillance temporaire du serveur.    
 ** Context **   
  
 ** Type **   

Code d’état HTTP : 500

## Voir aussi
<a name="API_CreateTieringConfiguration_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateTieringConfiguration)