CreateDatasetGroup - Amazon Forecast
Sintaxis de la solicitudParámetros de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase tambié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.

CreateDatasetGroup

Crea un grupo de conjuntos de datos, que contiene una colección de conjuntos de datos relacionados. Puede agregar conjuntos de datos al grupo de conjuntos de datos al crear el grupo de conjuntos de datos o más adelante mediante la UpdateDatasetGroupoperación.

Después de crear un grupo de conjuntos de datos y agregarle los conjuntos de datos, utilice el grupo para entrenar un predictor. Para obtener más información, consulte Dataset groups (Conjunto de datos).

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

nota

El Status de un grupo de conjuntos de datos debe estar ACTIVE antes de poder usar el grupo para crear un predictor. Utilice la operación DescribeDatasetGroup para obtener el estado.

Sintaxis de la solicitud

{
   "DatasetArns": [ "string" ],
   "DatasetGroupName": "string",
   "Domain": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Parámetros de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

DatasetArns

Una matriz de nombres de recursos de Amazon (ARN) de los conjuntos de datos que desea incluir en el grupo de conjuntos de datos.

Tipo: matriz de cadenas

Limitaciones de longitud: longitud máxima de 256.

Patrón: arn:([a-z\d-]+):forecast:.*:.*:.+

Obligatorio: no

DatasetGroupName

Un nombre para el grupo de 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í

Domain

El dominio asociado al grupo de conjuntos 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 CreateDatasetoperación deben coincidir.

El Domain y DatasetType que elija determinan los campos que deben estar presentes en los datos de entrenamiento que importe a un 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 Dataset groups (Conjunto de datos).

Tipo: cadena

Valores válidos: RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS

Obligatorio: sí

Tags

Los metadatos opcionales que se aplican al grupo de 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:

  • Cantidad máxima 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 permitidos generalmente son: letras, números y espacios representables en UTF-8, además de 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 claves, ya que su uso está reservado para 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

{
   "DatasetGroupArn": "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.

DatasetGroupArn

El nombre de recurso de Amazon (ARN) del grupo de conjuntos 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

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 un SDK de AWS de un lenguaje específico, consulte: