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.
CreateForecastExportJob
Exporte une prévision créée par l'CreateForecastopération vers votre bucket Amazon Simple Storage Service (Amazon S3). Le nom du fichier de prévisions respectera les conventions suivantes :
<ForecastExportJobName>_<ExportTimestamp>_<PartNumber>
où le composant < ExportTimestamp > est en Java SimpleDateFormat (yyyy-mm-dd THH -mm-SSZ).
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 »
Vous devez spécifier un DataDestination objet qui inclut un rôle AWS Identity and Access Management (IAM) qu'Amazon Forecast peut assumer pour accéder au compartiment Amazon S3. Pour de plus amples informations, veuillez consulter Configuration d'autorisations pour Amazon Forecast.
Pour de plus amples informations, veuillez consulter Génération de prévisions.
Pour obtenir une liste de toutes vos tâches d'exportation de prévisions, utilisez l'ListForecastExportJobsopération.
Note
La tâche Status
d'exportation des prévisions doit avoir lieu ACTIVE
avant que vous puissiez accéder aux prévisions dans votre compartiment Amazon S3. Pour obtenir le statut, utilisez l'DescribeForecastExportJobopération.
Syntaxe de la requête
{
"Destination": {
"S3Config": {
"KMSKeyArn": "string
",
"Path": "string
",
"RoleArn": "string
"
}
},
"ForecastArn": "string
",
"ForecastExportJobName": "string
",
"Format": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
Paramètres de demande
La demande accepte les données suivantes au JSON format suivant.
- Destination
-
L'emplacement où vous souhaitez enregistrer les prévisions et le rôle AWS Identity and Access Management (IAM) qu'Amazon Forecast peut assumer pour accéder à l'emplacement. Les prévisions doivent être exportées vers un compartiment Amazon S3.
Si le chiffrement est utilisé,
Destination
il doit inclure une clé AWS Key Management Service (KMS). Le IAM rôle doit autoriser Amazon Forecast à accéder à la clé.Type : objet DataDestination
Obligatoire : oui
- ForecastArn
-
Le nom de la ressource Amazon (ARN) de la prévision que vous souhaitez exporter.
Type : String
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):forecast:.*:.*:.+
Obligatoire : oui
- ForecastExportJobName
-
Nom de la tâche d'exportation des prévisions.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63.
Modèle :
^[a-zA-Z][a-zA-Z0-9_]*
Obligatoire : oui
- Format
-
Le format des données exportées, CSV ouPARQUET. La valeur par défaut estCSV.
Type : String
Contraintes de longueur : longueur maximale de 7.
Modèle :
^CSV|PARQUET$
Obligatoire : non
- Tags
-
Les métadonnées facultatives que vous appliquez à la tâche d'exportation des prévisions pour vous aider à les classer et à les organiser. Chaque balise est constituée d’une clé et d’une valeur facultative que vous définissez.
Les restrictions de base suivantes s’appliquent aux balises :
-
Nombre maximum de balises par ressource : 50.
-
Pour chaque ressource, chaque clé d'identification doit être unique, et chaque clé d'identification peut avoir une seule valeur.
-
Longueur de clé maximale : 128 caractères Unicode en UTF -8.
-
Longueur maximale de la valeur : 256 caractères Unicode en UTF -8.
-
Si votre schéma de balisage est utilisé pour plusieurs services et ressources , n’oubliez pas que d’autres services peuvent avoir des restrictions concernant les caractères autorisés. Les caractères généralement autorisés sont : les lettres, les chiffres et les espaces représentables en UTF -8, ainsi que les caractères suivants : + - =. _ :/@.
-
Les clés et valeurs de balise sont sensibles à la casse.
-
N'utilisez pas
aws:
AWS:
, ni aucune combinaison majuscules ou minuscules, comme un préfixe pour les clés, car il est réservé à l'usage. AWS Vous ne pouvez pas modifier ou supprimer les clés de balise avec ce préfixe. Les valeurs peuvent avoir ce préfixe. Si une valeur de balise aaws
pour préfixe, mais pas la clé, Forecast considère qu'il s'agit d'une balise utilisateur et compte dans la limite de 50 balises. Les balises dont le seul préfixe est « ne sont pas prises en compte dansaws
le calcul de vos balises par limite de ressources ».
Type : tableau d’objets Tag
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.
Obligatoire : non
-
Syntaxe de la réponse
{
"ForecastExportJobArn": "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.
- ForecastExportJobArn
-
Le nom de la ressource Amazon (ARN) de la tâche d'exportation.
Type : String
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):forecast:.*:.*:.+
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
- LimitExceededException
-
La limite du nombre de ressources par compte a été dépassée.
HTTPCode de statut : 400
- ResourceAlreadyExistsException
-
Il existe déjà une ressource portant ce nom. Réessayez avec un autre nom.
HTTPCode de statut : 400
- ResourceInUseException
-
La ressource spécifiée est en cours d'utilisation.
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 :