Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Crea una configuración de estratificación.

Una configuración por niveles permite el movimiento automático de los datos de respaldo a un nivel de almacenamiento de menor costo en función de la antigüedad de los objetos respaldados en la bóveda de respaldo.

Cada almacén solo puede tener una configuración de estratificación específica para cada almacén, además de cualquier configuración global que se aplique a todos los almacenes.

## Sintaxis de la solicitud
<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" 
   }
}
```

## Parámetros de solicitud del URI
<a name="API_CreateTieringConfiguration_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_CreateTieringConfiguration_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [CreatorRequestId](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-CreatorRequestId"></a>
Se trata de una cadena única que identifica la solicitud y permite volver a intentar las solicitudes fallidas sin correr el riesgo de ejecutar la operación dos veces. Este parámetro es opcional. Si se utiliza, este parámetro debe contener de 1 a 50 caracteres alfanuméricos o “-\$1”. caracteres.  
Tipo: cadena  
Requerido: no

 ** [TieringConfiguration](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfiguration"></a>
Una configuración por niveles debe contener una `TieringConfigurationName` cadena única que usted cree y debe contener una `BackupVaultName` y. `ResourceSelection` Si lo desea, puede incluir una `CreatorRequestId` cadena.  
`TieringConfigurationName`Es una cadena única que es el nombre de la configuración de estratificación. No se puede cambiar después de la creación y debe constar únicamente de caracteres alfanuméricos y guiones bajos.  
Tipo: objeto [TieringConfigurationInputForCreate](API_TieringConfigurationInputForCreate.md)  
Obligatorio: sí

 ** [TieringConfigurationTags](#API_CreateTieringConfiguration_RequestSyntax) **   <a name="Backup-CreateTieringConfiguration-request-TieringConfigurationTags"></a>
Las etiquetas que se van a asignar a la configuración de organización por niveles.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateTieringConfiguration_ResponseSyntax"></a>

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

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

## Elementos de respuesta
<a name="API_CreateTieringConfiguration_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-CreationTime"></a>
La fecha y la hora en que se creó una configuración de organización por niveles, en formato Unix y en hora universal coordinada (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [TieringConfigurationArn](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva la configuración de estratificación creada.  
Tipo: cadena

 ** [TieringConfigurationName](#API_CreateTieringConfiguration_ResponseSyntax) **   <a name="Backup-CreateTieringConfiguration-response-TieringConfigurationName"></a>
Esta cadena única es el nombre de la configuración de estratificación.  
El nombre no se puede cambiar después de crear el plan. El nombre consta de únicamente de caracteres alfanuméricos y guiones bajos. La longitud máxima es 200.  
Tipo: cadena

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

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ConflictException **   
 AWS Backup no puede realizar la acción que ha solicitado hasta que termine de realizar una acción anterior. Inténtelo de nuevo más tarde.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** InvalidParameterValueException **   
Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CreateTieringConfiguration_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateTieringConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateTieringConfiguration)