Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Crea una configurazione a più livelli.

Una configurazione a più livelli consente lo spostamento automatico dei dati di backup su un livello di storage più economico in base all'età degli oggetti di backup nel backup vault.

Ogni archivio può avere solo una configurazione su più livelli specifica del vault, oltre a qualsiasi configurazione globale che si applica a tutti gli archivi.

## Sintassi della richiesta
<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" 
   }
}
```

## Parametri della richiesta URI:
<a name="API_CreateTieringConfiguration_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_CreateTieringConfiguration_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [CreatorRequestId](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-CreatorRequestId"></a>
Si tratta di una stringa univoca che identifica la richiesta e consente di ritentare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Questo parametro è facoltativo. Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.).   
▬Tipo: stringa  
Obbligatorio: no

 ** [TieringConfiguration](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfiguration"></a>
Una configurazione a più livelli deve contenere una `TieringConfigurationName` stringa univoca creata dall'utente e deve contenere una e. `BackupVaultName` `ResourceSelection` Facoltativamente, puoi includere una `CreatorRequestId` stringa.  
`TieringConfigurationName`è una stringa univoca che è il nome della configurazione di tiering. Non può essere modificato dopo la creazione e deve essere composto solo da caratteri alfanumerici e caratteri di sottolineatura.  
Tipo: oggetto [TieringConfigurationInputForCreate](API_TieringConfigurationInputForCreate.md)  
Obbligatorio: sì

 ** [TieringConfigurationTags](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfigurationTags"></a>
I tag da assegnare alla configurazione a più livelli.  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

## Sintassi della risposta
<a name="API_CreateTieringConfiguration_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateTieringConfiguration_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [CreationTime](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-CreationTime"></a>
Data e ora di creazione di una configurazione a più livelli, in formato Unix e Coordinated Universal Time (UTC). Il valore di `CreationTime` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 12:11:30.087.  
Tipo: Timestamp

 ** [TieringConfigurationArn](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationArn"></a>
Un Amazon Resource Name (ARN) che identifica in modo univoco la configurazione di tiering creata.  
Tipo: String

 ** [TieringConfigurationName](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationName"></a>
Questa stringa univoca è il nome della configurazione di tiering.  
Il nome non può essere modificato dopo la creazione. Il nome può contenere solo caratteri alfanumerici e caratteri di sottolineatura. La lunghezza massima è 200.  
Tipo: String

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

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

 ** AlreadyExistsException **   
La risorsa richiesta esiste già.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Codice di stato HTTP: 400

 ** ConflictException **   
 AWS Backup non può eseguire l'azione richiesta finché non termina l'esecuzione di un'azione precedente. Riprova più tardi.    
 ** Context **   
  
 ** Type **   

Codice di stato HTTP: 400

 ** InvalidParameterValueException **   
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.    
 ** Context **   
  
 ** Type **   

Codice di stato HTTP: 400

 ** LimitExceededException **   
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.    
 ** Context **   
  
 ** Type **   

Codice di stato HTTP: 400

 ** MissingParameterValueException **   
Indica che manca un parametro obbligatorio.    
 ** Context **   
  
 ** Type **   

Codice di stato HTTP: 400

 ** ServiceUnavailableException **   
La richiesta non è riuscita a causa di un errore temporaneo del server.    
 ** Context **   
  
 ** Type **   

Codice di stato HTTP: 500

## Vedi anche
<a name="API_CreateTieringConfiguration_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateTieringConfiguration)