CreateDataset - Amazon Forecast
Sintaxis de la solicitudParámetros de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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

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

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 (Importación de conjuntos de datos).

Para obtener una lista de todos sus conjuntos de datos, utilice la ListDatasetsoperación.

Para ver, por ejemplo, conjuntos de datos de Forecast, consulte el GitHubrepositorio de muestras de Amazon Forecast.

nota

Para poder importar los datos de entrenamiento, el Status de un conjunto de datos debe ser ACTIVE. Utilice la DescribeDatasetoperación 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 JSON formato.

DataFrequency

La frecuencia de la recopilación de datos. Este parámetro es obligatorio para los SERIES conjuntos de datos RELATED TIME _ _.

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

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

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

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 CreateDatasetGroupoperació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 (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

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

Obligatorio: no

Schema

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.

Tipo: objeto Schema

Obligatorio: sí

Tags

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:

  • Número máximo de etiquetas por recurso: 50.

  • Para cada recurso, cada clave de etiqueta debe ser única y 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: + - =. _:/@.

  • 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 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

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 HTTP respuesta de 200.

El servicio devuelve los siguientes datos en JSON formato.

DatasetArn

El nombre del 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.

HTTPCódigo de estado: 400

LimitExceededException

Se ha superado el límite en el número de recursos por cuenta.

HTTPCódigo de estado: 400

ResourceAlreadyExistsException

Ya existe un recurso con este nombre. Inténtelo de nuevo con un nombre diferente.

HTTPCódigo de estado: 400

Véase también

Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: