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'DescribeDataset
appel. 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'
SchemaAttribute
objets qui spécifient les champs du jeu de données. ChacunSchemaAttribute
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 pourACTIVE
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 :