Avis de fin de support : le 10 septembre 2025, AWS
le support de AWS RoboMaker. Après le 10 septembre 2025, vous ne pourrez plus accéder à la AWS RoboMaker console ni aux AWS RoboMaker ressources. Pour plus d'informations sur la transition AWS Batch afin de faciliter l'exécution de simulations conteneurisées, consultez ce billet de blog.
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.
CreateWorldExportJob
Important
Avis de fin de support : le 10 septembre 2025, AWS
le support de AWS RoboMaker. Après le 10 septembre 2025, vous ne pourrez plus accéder à la AWS RoboMaker console ni aux AWS RoboMaker ressources. Pour plus d'informations sur la transition AWS Batch afin de faciliter l'exécution de simulations conteneurisées, consultez ce billet de blog.
Crée un emploi à l'exportation dans le monde entier.
Syntaxe de la requête
POST /createWorldExportJob HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string",
"iamRole": "string",
"outputLocation": {
"s3Bucket": "string",
"s3Prefix": "string"
},
"tags": {
"string" : "string"
},
"worlds": [ "string" ]
}URIParamètres de demande
La demande n'utilise aucun URI paramètre.
Corps de la requête
La demande accepte les données suivantes au JSON format suivant.
- clientRequestToken
-
Identifiant unique distinguant majuscules et minuscules que vous fournissez pour garantir l'idempuissance de la demande.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.
Modèle :
[a-zA-Z0-9_\-=]*Obligatoire : non
- iamRole
-
IAMRôle utilisé par le processus d'exportation mondial pour accéder au compartiment Amazon S3 et effectuer l'exportation.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255.
Modèle :
arn:aws:iam::\w+:role/.*Obligatoire : oui
- outputLocation
-
Emplacement de la sortie.
Type : objet OutputLocation
Obligatoire : oui
-
Une carte contenant les clés de balise et les valeurs de balise associées à la tâche d'exportation mondiale.
Type : mappage chaîne/chaîne
Entrées cartographiques : nombre minimum de 0 éléments. Nombre maximal de 50 éléments.
Contraintes de longueur de clé : longueur minimale de 1. Longueur maximale de 128.
Modèle de clé :
[a-zA-Z0-9 _.\-\/+=:]*Contraintes de longueur de valeur : longueur minimale de 0. Longueur maximale de 256.
Modèle de valeur :
[a-zA-Z0-9 _.\-\/+=:]*Obligatoire : non
- worlds
-
Liste des noms de ressources Amazon (arns) correspondant aux mondes à exporter.
Type : tableau de chaînes
Membres du tableau : Nombre minimum de 1 élément. Nombre maximal de 100 éléments.
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 1224.
Modèle :
arn:.*Obligatoire : oui
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"arn": "string",
"clientRequestToken": "string",
"createdAt": number,
"failureCode": "string",
"iamRole": "string",
"outputLocation": {
"s3Bucket": "string",
"s3Prefix": "string"
},
"status": "string",
"tags": {
"string" : "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.
- arn
-
Le nom de la ressource Amazon (ARN) de la tâche d'exportation mondiale.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 1224.
Modèle :
arn:.* - clientRequestToken
-
Identifiant unique distinguant majuscules et minuscules que vous fournissez pour garantir l'idempuissance de la demande.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64.
Modèle :
[a-zA-Z0-9_\-=]* - createdAt
-
L'heure, en millisecondes, depuis l'époque, où l'emploi d'exportateur mondial a été créé.
Type : Timestamp
- failureCode
-
Le code d'échec de la tâche d'exportation mondiale en cas d'échec :
- InternalServiceError
-
Erreur de service interne.
- LimitExceeded
-
La ressource demandée dépasse le nombre maximum autorisé, ou le nombre de demandes de flux simultanées dépasse le nombre maximum autorisé.
- ResourceNotFound
-
La ressource spécifiée est introuvable.
- RequestThrottled
-
La demande a été limitée.
- InvalidInput
-
Un paramètre d'entrée de la demande n'est pas valide.
- AllWorldGenerationFailed
-
Tous les emplois de la génération mondiale ont échoué. Cela peut se produire si votre
worldCountvaleur est supérieure à 50 ou inférieure à 1.
Pour plus d'informations sur le dépannage WorldForge, consultez la section Simulation de résolution des problèmes WorldForge.
Type : String
Valeurs valides :
InternalServiceError | LimitExceeded | ResourceNotFound | RequestThrottled | InvalidInput | AccessDenied - iamRole
-
IAMRôle utilisé par le processus d'exportation mondial pour accéder au compartiment Amazon S3 et effectuer l'exportation.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255.
Modèle :
arn:aws:iam::\w+:role/.* - outputLocation
-
Emplacement de la sortie.
Type : objet OutputLocation
- status
-
L'état de l'emploi dans le secteur de l'exportation dans le monde.
- En attente
-
La demande d'emploi pour l'exportation mondiale est en attente.
- En cours d'exécution
-
Le marché de l'exportation mondiale est en cours.
- Terminé
-
Le travail d'exportation mondiale est terminé.
- Échec
-
L'exportation mondiale a échoué. Pour plus d’informations, consultez
failureCode. - Annulé
-
Le poste d'exportation mondial a été annulé.
- Annulation
-
Le poste d'exportation mondial est annulé.
Type : String
Valeurs valides :
Pending | Running | Completed | Failed | Canceling | Canceled -
Une carte contenant les clés de balise et les valeurs de balise associées à la tâche d'exportation mondiale.
Type : mappage chaîne/chaîne
Entrées cartographiques : nombre minimum de 0 éléments. Nombre maximal de 50 éléments.
Contraintes de longueur de clé : longueur minimale de 1. Longueur maximale de 128.
Modèle de clé :
[a-zA-Z0-9 _.\-\/+=:]*Contraintes de longueur de valeur : longueur minimale de 0. Longueur maximale de 256.
Modèle de valeur :
[a-zA-Z0-9 _.\-\/+=:]*
Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.
- IdempotentParameterMismatchException
-
La demande utilise le même jeton client qu'une demande précédente non identique. Vous ne devez pas réutiliser de jeton client avec des demandes différentes, sauf si les demandes sont identiques.
HTTPCode de statut : 400
- InternalServerException
-
AWS RoboMaker a rencontré un problème de service. Renouvelez votre appel.
HTTPCode de statut : 500
- InvalidParameterException
-
Un paramètre spécifié dans une demande n'est pas valide, n'est pas pris en charge ou ne peut pas être utilisé. Le message renvoyé fournit une explication de la valeur d'erreur.
HTTPCode de statut : 400
- ResourceNotFoundException
-
La ressource spécifiée n'existe pas.
HTTPCode de statut : 400
- ServiceUnavailableException
-
La demande a échoué en raison d’une défaillance temporaire du serveur.
HTTPCode de statut : 503
- ThrottlingException
-
AWS RoboMaker est temporairement incapable de traiter la demande. Renouvelez votre appel.
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 :
