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. # CreateDataset Crea un conjunto de datos de Amazon Forecast **importante** 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/) La información sobre el conjunto de datos que permite a Forecast comprender cómo consumir los datos para el entrenamiento de modelos. Esta incluye lo siguiente: + * `DataFrequency` *: con qué frecuencia se recopilan los datos históricos de series temporales. + * `Domain` * y * `DatasetType` *: cada conjunto de datos tiene un dominio de conjunto de datos asociado y un tipo dentro del dominio. Amazon Forecast proporciona una lista de dominios y tipos predefinidos dentro de cada dominio. Para cada dominio y tipo de conjunto de datos dentro del dominio, Amazon Forecast requiere que los datos tengan un conjunto mínimo de campos predefinidos. + * `Schema` *: un esquema especifica los campos del conjunto de datos, incluidos el nombre del campo y el tipo de datos. Después de crear un conjunto de datos, importe sus datos de entrenamiento en él y añádalo a un grupo de conjuntos de datos. Usa el grupo de conjuntos de datos para crear un predictor. Para obtener más información, consulte [Importing datasets](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html) (Importación de conjuntos de datos). Para obtener una lista de todos sus conjuntos de datos, utilice la [ListDatasets](https://docs.aws.amazon.com/forecast/latest/dg/API_ListDatasets.html)operación. Para ver, por ejemplo, conjuntos de datos de Forecast, consulte el [ GitHubrepositorio de muestras de Amazon Forecast](https://github.com/aws-samples/amazon-forecast-samples). **nota** Para poder importar los datos de entrenamiento, el `Status` de un conjunto de datos debe ser `ACTIVE`. Utilice la operación [DescribeDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDataset.html) para obtener el estado. ## Sintaxis de la solicitud ``` { "DataFrequency": "string", "DatasetName": "string", "DatasetType": "string", "Domain": "string", "EncryptionConfig": { "KMSKeyArn": "string", "RoleArn": "string" }, "Schema": { "Attributes": [ { "AttributeName": "string", "AttributeType": "string" } ] }, "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Parámetros de la solicitud La solicitud acepta los siguientes datos en formato JSON. ** [DataFrequency](#API_CreateDataset_RequestSyntax) ** La frecuencia de la recopilación de datos. Este parámetro es necesario para los conjuntos de datos RELATED\$1TIME\$1SERIES. Los intervalos válidos son un número entero seguido de Y (año), M (mes), W (semana), D (día), H (hora) y min (minuto). Por ejemplo, “1D” indica todos los días y “15min” indica cada 15 minutos. No puede especificar un valor que se superponga con la siguiente frecuencia mayor. Esto significa, por ejemplo, que no puede especificar una frecuencia de 60 minutos, porque equivale a 1 hora. Los valores válidos de cada frecuencia son los siguientes: + Minuto: de 1 a 59 + Hora: de 1 a 23 + Día: de 1 a 6 + Semana: de 1 a 4 + Mes: de 1 a 11 + Año: 1 Por lo tanto, si desea previsiones cada dos semanas, especifique “2W”. O, si desea previsiones trimestrales, especifique “3M”. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 5. Patrón: `^Y|M|W|D|H|30min|15min|10min|5min|1min$` Obligatorio: no ** [DatasetName](#API_CreateDataset_RequestSyntax) ** Un nombre para el conjunto de datos. 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í ** [DatasetType](#API_CreateDataset_RequestSyntax) ** El tipo del conjunto de datos. Los valores válidos dependen del `Domain` seleccionado. Tipo: cadena Valores válidos: `TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA` Obligatorio: sí ** [Domain](#API_CreateDataset_RequestSyntax) ** El dominio asociado al conjunto de datos. Al añadir un conjunto de datos a un grupo de conjuntos de datos, este valor y el valor especificado para el `Domain` parámetro de la [CreateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetGroup.html)operación deben coincidir. El `Domain` y `DatasetType` que elija determinan los campos que deben estar presentes en los datos de entrenamiento que importe al conjunto de datos. Por ejemplo, si elige el dominio `RETAIL` y `TARGET_TIME_SERIES`, como el `DatasetType`, Amazon Forecast exige que los campos `item_id`, `timestamp` y `demand` estén presentes en los datos. Para obtener más información, consulte [Importing datasets](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html) (Importación de conjuntos de datos). Tipo: cadena Valores válidos: `RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS` Obligatorio: sí ** [EncryptionConfig](#API_CreateDataset_RequestSyntax) ** Una clave AWS Key Management Service (KMS) y la función AWS Identity and Access Management (IAM) que Amazon Forecast puede asumir para acceder a la clave. Tipo: objeto [EncryptionConfig](API_EncryptionConfig.md) Obligatorio: no ** [Schema](#API_CreateDataset_RequestSyntax) ** El esquema del conjunto de datos. Los atributos del esquema y su orden deben coincidir con los campos de los datos. El conjunto de datos `Domain` y `DatasetType` que elija determinan los campos mínimos obligatorios de los datos de entrenamiento. Para obtener información sobre los campos obligatorios para un dominio y tipo de conjunto de datos específicos, consulte [Dominios y tipos de conjuntos de datos](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-domains-ds-types.html). Tipo: objeto [Schema](API_Schema.md) Obligatorio: sí ** [Tags](#API_CreateDataset_RequestSyntax) ** Los metadatos opcionales que se aplican al conjunto de datos para ayudarle a categorizarlos y organizarlos. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario. Se aplican las siguientes restricciones básicas a las etiquetas de : + Número máximo de etiquetas por recurso: 50. + Para cada recurso, cada clave de etiqueta debe ser única y cada clave de etiqueta solo puede tener un valor. + Longitud máxima de la clave: 128 caracteres Unicode en UTF-8 + Longitud máxima del valor: 256 caracteres Unicode en UTF-8 + Si se utiliza su esquema de etiquetado en múltiples servicios y recursos, recuerde que otros servicios pueden tener otras restricciones sobre caracteres permitidos. Los caracteres generalmente permitidos son: letras, números y espacios representables en UTF-8, y los siguientes caracteres: \$1 - =. \$1:/@. + Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas. + No utilice `aws:``AWS:`, ni ninguna combinación de mayúsculas o minúsculas como, por ejemplo, un prefijo para las teclas, ya que está reservado para su uso. AWS Las claves de etiquetas que tienen este prefijo no se pueden editar ni eliminar. 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. 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 ``` { "DatasetArn": "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. ** [DatasetArn](#API_CreateDataset_ResponseSyntax) ** El nombre de recurso de Amazon (ARN) del conjunto de datos. 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 ## Véase también 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/CreateDataset) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateDataset) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDataset) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateDataset) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateDataset) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDataset) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateDataset) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateDataset) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateDataset) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDataset)