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.
CreateWorldGenerationJob
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 des mondes à l'aide du modèle spécifié.
Syntaxe de la requête
POST /createWorldGenerationJob HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string",
"tags": {
"string" : "string"
},
"template": "string",
"worldCount": {
"floorplanCount": number,
"interiorCountPerFloorplan": number
},
"worldTags": {
"string" : "string"
}
}URIParamètres de demande
La demande n'utilise aucun URI paramètre.
Corps de la requête
La demande accepte le JSON format des données suivantes.
- 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
-
Une carte contenant les clés de balise et les valeurs de balise associées à la tâche World Generator.
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
- template
-
Le nom de ressource Amazon (arn) du modèle mondial décrivant les mondes que vous souhaitez créer.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 1224.
Modèle :
arn:.*Obligatoire : oui
- worldCount
-
Informations sur le décompte mondial.
Type : objet WorldCount
Obligatoire : oui
- worldTags
-
Une carte qui contient des clés de balise et des valeurs de balises associées aux mondes générés.
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
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"arn": "string",
"clientRequestToken": "string",
"createdAt": number,
"failureCode": "string",
"status": "string",
"tags": {
"string" : "string"
},
"template": "string",
"worldCount": {
"floorplanCount": number,
"interiorCountPerFloorplan": number
},
"worldTags": {
"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 ressource Amazon (ARN) de la tâche du générateur mondial.
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, à laquelle le poste de générateur mondial a été créé.
Type : Timestamp
- failureCode
-
Le code d'échec de la tâche World Generator 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.
Type : String
Valeurs valides :
InternalServiceError | LimitExceeded | ResourceNotFound | RequestThrottled | InvalidInput | AllWorldGenerationFailed - status
-
L'état du poste de générateur mondial.
- En attente
-
La demande d'emploi de World Generator est en attente.
- En cours d'exécution
-
La tâche World Generator est en cours d'exécution.
- Terminé
-
Le travail du générateur mondial est terminé.
- Échec
-
Le travail du générateur mondial a échoué. Pour plus d’informations, consultez
failureCode. - PartialFailed
-
Certains mondes n'ont pas été générés.
- Annulé
-
Le poste de World Generator a été annulé.
- Annulation
-
Le poste de World Generator est annulé.
Type : String
Valeurs valides :
Pending | Running | Completed | Failed | PartialFailed | Canceling | Canceled -
Une carte contenant les clés de balise et les valeurs de balise associées à la tâche World Generator.
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 _.\-\/+=:]* - template
-
Le nom de ressource Amazon (arn) du modèle mondial.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 1224.
Modèle :
arn:.* - worldCount
-
Informations sur le décompte mondial.
Type : objet WorldCount
- worldTags
-
Une carte qui contient des clés de balise et des valeurs de balises associées aux mondes générés.
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
- LimitExceededException
-
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é.
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 :
