DescribeDataset - Amazon Forecast
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

Amazon Forecast n'est plus disponible pour les nouveaux clients. Les clients existants d'Amazon Forecast peuvent continuer à utiliser le service normalement. En savoir plus »

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

DescribeDataset

Décrit un jeu de données Amazon Forecast créé à l'aide de CreateDatasetcette opération.

Important

Amazon Forecast n'est plus disponible pour les nouveaux clients. Les clients existants d'Amazon Forecast peuvent continuer à utiliser le service normalement. En savoir plus »

Outre la liste des paramètres spécifiés dans la CreateDataset demande, cette opération inclut les propriétés de jeu de données suivantes :

  • CreationTime

  • LastModificationTime

  • Status

Syntaxe de la requête

{
   "DatasetArn": "string"
}

Paramètres de demande

La demande accepte les données suivantes au JSON format suivant.

DatasetArn

Le nom de la ressource Amazon (ARN) de l'ensemble de données.

Type : String

Contraintes de longueur : longueur maximale de 256.

Modèle : arn:([a-z\d-]+):forecast:.*:.*:.+

Obligatoire : oui

Syntaxe de la réponse

{
   "CreationTime": number,
   "DataFrequency": "string",
   "DatasetArn": "string",
   "DatasetName": "string",
   "DatasetType": "string",
   "Domain": "string",
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "LastModificationTime": number,
   "Schema": { 
      "Attributes": [ 
         { 
            "AttributeName": "string",
            "AttributeType": "string"
         }
      ]
   },
   "Status": "string"
}

Eléments de réponse

Si l'action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées sous JSON forme formatée par le service.

CreationTime

Quand le jeu de données a été créé.

Type : Timestamp

DataFrequency

La fréquence de collecte des données.

Les intervalles valides sont Y (année), M (mois), W (semaine), D (jour), H (heure), 30min (30 minutes), 15min (15 minutes), 10min (10 minutes), 5min (5 minutes) et 1min (1 minute). Par exemple, « M » indique chaque mois et « 30 minutes » indique toutes les 30 minutes.

Type : String

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 5.

Modèle : ^Y|M|W|D|H|30min|15min|10min|5min|1min$

DatasetArn

Le nom de la ressource Amazon (ARN) de l'ensemble de données.

Type : String

Contraintes de longueur : longueur maximale de 256.

Modèle : arn:([a-z\d-]+):forecast:.*:.*:.+

DatasetName

Nom de l'ensemble de données.

Type : String

Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63.

Modèle : ^[a-zA-Z][a-zA-Z0-9_]*

DatasetType

Le type de jeu de données.

Type : String

Valeurs valides : TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA

Domain

Le domaine associé au jeu de données.

Type : String

Valeurs valides : RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS

EncryptionConfig

La clé AWS Key Management Service (KMS) et le rôle AWS Identity and Access Management (IAM) qu'Amazon Forecast peut assumer pour accéder à la clé.

Type : objet EncryptionConfig

LastModificationTime

Lorsque vous créez un jeu de données, LastModificationTime c'est la même chose queCreationTime. Pendant l'importation des données dans l'ensemble de données, LastModificationTime c'est l'heure actuelle de l'DescribeDatasetappel. Une fois qu'une CreateDatasetImportJobopération est terminée, LastModificationTime c'est lorsque le travail d'importation s'est terminé ou a échoué.

Type : Timestamp

Schema

Tableau d'SchemaAttributeobjets qui spécifient les champs du jeu de données. Chacun SchemaAttribute indique le nom et le type de données d'un champ.

Type : objet Schema

Status

État de l'ensemble de données. Les États incluent :

  • ACTIVE

  • CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED

  • DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED

  • UPDATE_PENDING, UPDATE_IN_PROGRESS, UPDATE_FAILED

Les UPDATE états s'appliquent lorsque les données sont importées dans l'ensemble de données à la suite d'un appel à l'CreateDatasetImportJobopération et reflètent le statut de la tâche d'importation de l'ensemble de données. Par exemple, lorsque le statut de la tâche d'importation estCREATE_IN_PROGRESS, le statut de l'ensemble de données estUPDATE_IN_PROGRESS.

Note

Le jeu Status de données doit l'être pour ACTIVE que vous puissiez importer des données d'entraînement.

Type : String

Contraintes de longueur : longueur maximale de 256.

Erreurs

InvalidInputException

Nous ne pouvons pas traiter la demande car elle contient une valeur non valide ou une valeur qui dépasse la plage valide.

HTTPCode de statut : 400

ResourceNotFoundException

Nous ne trouvons aucune ressource portant ce nom de ressource Amazon (ARN). Vérifiez le ARN et réessayez.

HTTPCode de statut : 400

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :