DescribeDataset

PDFRSS

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

Cette demande accepte les données suivantes au format JSON.

DatasetArn

L'Amazon Resource Name (ARN) du jeu 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 au format JSON 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 tous les 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

L'Amazon Resource Name (ARN) du jeu 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.

Code d’état HTTP : 400

ResourceNotFoundException

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

Code d’état HTTP : 400

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :

• Interface de ligne de commande AWS

• AWS SDK pour .NET

• AWS SDK pour C++

• AWS SDK pour Go v2

• AWS SDK pour Java V2

• AWS SDK pour V3 JavaScript

• AWS SDK pour PHP V3

• AWS SDK pour Python

• AWS SDK pour Ruby V3