Amazon Forecast ya no está disponible para nuevos clientes. Los clientes actuales de Amazon Forecast pueden seguir utilizando el servicio con normalidad. [Más información](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

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.

# CreateExplainabilityExport
<a name="API_CreateExplainabilityExport"></a>

Exporta un recurso de Explicabilidad creado por la operación [CreateExplainability](API_CreateExplainability.md). Los archivos exportados se exportan a un bucket de Amazon Simple Storage Service (Amazon S3).

Debe especificar un [DataDestination](API_DataDestination.md) objeto que incluya un bucket de Amazon S3 y un rol AWS Identity and Access Management (IAM) que Amazon Forecast pueda asumir para acceder al bucket de Amazon S3. Para obtener más información, consulte [Configuración de permisos para Amazon Forecast](aws-forecast-iam-roles.md).

**nota**  
El `Status` del trabajo de exportación debe estar `ACTIVE` antes de poder acceder a la exportación en su bucket de Amazon S3. Utilice la operación [DescribeExplainabilityExport](API_DescribeExplainabilityExport.md) para obtener el estado.

## Sintaxis de la solicitud
<a name="API_CreateExplainabilityExport_RequestSyntax"></a>

```
{
   "Destination": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "ExplainabilityArn": "string",
   "ExplainabilityExportName": "string",
   "Format": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## Parámetros de la solicitud
<a name="API_CreateExplainabilityExport_RequestParameters"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Destination](#API_CreateExplainabilityExport_RequestSyntax) **   <a name="forecast-CreateExplainabilityExport-request-Destination"></a>
El destino de un trabajo de exportación. Proporcione una ruta S3, una función AWS Identity and Access Management (IAM) que permita a Amazon Forecast acceder a la ubicación y una clave AWS Key Management Service (KMS) (opcional).   
Tipo: objeto [DataDestination](API_DataDestination.md)  
Obligatorio: sí

 ** [ExplainabilityArn](#API_CreateExplainabilityExport_RequestSyntax) **   <a name="forecast-CreateExplainabilityExport-request-ExplainabilityArn"></a>
El Nombre de recurso de Amazon (ARN) de la Explicabilidad que exportar.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obligatorio: sí

 ** [ExplainabilityExportName](#API_CreateExplainabilityExport_RequestSyntax) **   <a name="forecast-CreateExplainabilityExport-request-ExplainabilityExportName"></a>
Un nombre único para la exportación de Explicabilidad.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.  
Patrón: `^[a-zA-Z][a-zA-Z0-9_]*`   
Obligatorio: sí

 ** [Format](#API_CreateExplainabilityExport_RequestSyntax) **   <a name="forecast-CreateExplainabilityExport-request-Format"></a>
El formato de los datos exportados, CSV o PARQUET.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 7.  
Patrón: `^CSV|PARQUET$`   
Obligatorio: no

 ** [Tags](#API_CreateExplainabilityExport_RequestSyntax) **   <a name="forecast-CreateExplainabilityExport-request-Tags"></a>
Los metadatos opcionales le ayudan a categorizar y organizar sus recursos. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario. Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.  
Se aplican las siguientes restricciones a las etiquetas:  
+ Para cada recurso, cada clave de etiqueta debe ser única y solo debe tener un valor.
+ Número máximo de etiquetas por recurso: 50
+ Longitud máxima de la clave: 128 caracteres Unicode en UTF-8
+ Longitud máxima del valor: 256 caracteres Unicode en UTF-8
+ Los caracteres aceptados son letras y números, espacios representables en UTF-8 y \$1 - = . \$1 : / @. Si se utiliza el esquema de etiquetado en otros servicios y recursos, también se aplican las limitaciones de caracteres de dichos servicios. 
+ Los prefijos clave no pueden incluir ninguna combinación en mayúsculas o minúsculas de `aws:` o `AWS:`. Los valores pueden tener este prefijo. Si el valor de una etiqueta tiene `aws` como prefijo pero la clave no, Forecast la considera una etiqueta de usuario y se contabilizará en el límite de 50 etiquetas. Las etiquetas que tengan solo el prefijo de clave de `aws` no cuentan para el límite de etiquetas por recurso. Las claves de etiquetas que tienen este prefijo no se pueden editar ni eliminar.
Tipo: matriz de objetos [Tag](API_Tag.md)  
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.  
Obligatorio: no

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

```
{
   "ExplainabilityExportArn": "string"
}
```

## Elementos de respuesta
<a name="API_CreateExplainabilityExport_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.

 ** [ExplainabilityExportArn](#API_CreateExplainabilityExport_ResponseSyntax) **   <a name="forecast-CreateExplainabilityExport-response-ExplainabilityExportArn"></a>
Nombre de recurso de Amazon (ARN) de la exportación.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 256.  
Patrón: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

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

 ** InvalidInputException **   
No podemos procesar la solicitud porque incluye un valor no válido o un valor que supera el rango válido.  
Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado el límite en el número de recursos por cuenta.  
Código de estado HTTP: 400

 ** ResourceAlreadyExistsException **   
Ya existe un recurso con este nombre. Inténtelo de nuevo con un nombre diferente.  
Código de estado HTTP: 400

 ** ResourceInUseException **   
El recurso especificado está en uso.  
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
No podemos encontrar un recurso con ese nombre de recurso de Amazon (ARN). Compruebe el ARN e inténtelo de nuevo.  
Código de estado HTTP: 400

## Véase también
<a name="API_CreateExplainabilityExport_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/forecast-2018-06-26/CreateExplainabilityExport) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateExplainabilityExport) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateExplainabilityExport) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateExplainabilityExport) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateExplainabilityExport) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateExplainabilityExport) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateExplainabilityExport) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateExplainabilityExport) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateExplainabilityExport) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateExplainabilityExport)