CreateExplainabilityExport - Amazon Forecast

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

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

Debe especificar un DataDestination 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.

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 para obtener el estado.

Sintaxis de la solicitud

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

Parámetros de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

Destination

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

Obligatorio: sí

ExplainabilityArn

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

Un nombre único para la exportación de Explicabilidad.

Tipo: string

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

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

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 + - = . _ : / @. 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

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

{ "ExplainabilityExportArn": "string" }

Elementos de respuesta

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

El servicio devuelve los datos siguientes en formato JSON.

ExplainabilityExportArn

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

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

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulte lo siguiente: