Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateWorldGenerationJob
Crea mondi utilizzando il modello specificato.
Sintassi della richiesta
POST /createWorldGenerationJob HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string",
"tags": {
"string" : "string"
},
"template": "string",
"worldCount": {
"floorplanCount": number,
"interiorCountPerFloorplan": number
},
"worldTags": {
"string" : "string"
}
}Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- clientRequestToken
-
Identificatore univoco con distinzione tra maiuscole e minuscole fornito per garantire l'idempotenza della richiesta.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 64 caratteri.
Modello:
[a-zA-Z0-9_\-=]*Campo obbligatorio: no
-
Una mappa che contiene le chiavi e i valori dei tag associati al World Generator Job.
Tipo: mappatura stringa a stringa
Voci sulla mappa: numero minimo di 0 elementi. Numero massimo di 50 item.
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.
Modello di chiave:
[a-zA-Z0-9 _.\-\/+=:]*Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.
Modello di valore:
[a-zA-Z0-9 _.\-\/+=:]*Campo obbligatorio: no
- template
-
Il modello Amazon Resource Name (arn) of the world che descrive i mondi che desideri creare.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 1224.
Modello:
arn:.*Campo obbligatorio: sì
- worldCount
-
Informazioni sul conteggio mondiale.
Tipo: oggetto WorldCount
Campo obbligatorio: sì
- worldTags
-
Una mappa che contiene le chiavi e i valori dei tag associati ai mondi generati.
Tipo: mappatura stringa a stringa
Voci sulla mappa: numero minimo di 0 elementi. Numero massimo di 50 item.
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.
Modello di chiave:
[a-zA-Z0-9 _.\-\/+=:]*Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.
Modello di valore:
[a-zA-Z0-9 _.\-\/+=:]*Campo obbligatorio: no
Sintassi della risposta
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"
}
}Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- arn
-
L'Amazon Resource Name (ARN) del job World Generator.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 1224.
Modello:
arn:.* - clientRequestToken
-
Identificatore univoco con distinzione tra maiuscole e minuscole fornito per garantire l'idempotenza della richiesta.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 64 caratteri.
Modello:
[a-zA-Z0-9_\-=]* - createdAt
-
L'ora, in millisecondi dall'epoca, in cui è stato creato il posto di lavoro del generatore mondiale.
Tipo: Timestamp
- failureCode
-
Il codice di errore del World Generator Job in caso di fallimento:
- InternalServiceError
-
Errore interno del servizio.
- LimitExceeded
-
La risorsa richiesta supera il numero massimo consentito oppure il numero di richieste di streaming simultanee supera il numero massimo consentito.
- ResourceNotFound
-
La risorsa specificata non è stata trovata.
- RequestThrottled
-
La richiesta è stata sottoposta a throttling.
- InvalidInput
-
Un parametro di input nella richiesta non è valido.
Tipo: stringa
Valori validi:
InternalServiceError | LimitExceeded | ResourceNotFound | RequestThrottled | InvalidInput | AllWorldGenerationFailed - status
-
Lo stato del lavoro del generatore mondiale.
- In attesa
-
La richiesta di lavoro di World Generator è in sospeso.
- In esecuzione
-
Il funzionamento del generatore mondiale è in corso.
- Completato
-
Il lavoro del generatore mondiale è stato completato.
- Non riuscito
-
Il lavoro del generatore mondiale è fallito. Per ulteriori informazioni, consulta
failureCode. - PartialFailed
-
Alcuni mondi non sono stati generati.
- Annullato
-
Il lavoro di World Generator è stato annullato.
- Annullamento
-
L'offerta di World Generator è stata annullata.
Tipo: stringa
Valori validi:
Pending | Running | Completed | Failed | PartialFailed | Canceling | Canceled -
Una mappa che contiene le chiavi e i valori dei tag associati al World Generator Job.
Tipo: mappatura stringa a stringa
Voci sulla mappa: numero minimo di 0 elementi. Numero massimo di 50 item.
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.
Modello di chiave:
[a-zA-Z0-9 _.\-\/+=:]*Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.
Modello di valore:
[a-zA-Z0-9 _.\-\/+=:]* - template
-
Il modello Amazon Resource Name (arn) del mondo.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 1224.
Modello:
arn:.* - worldCount
-
Informazioni sul conteggio mondiale.
Tipo: oggetto WorldCount
- worldTags
-
Una mappa che contiene le chiavi e i valori dei tag associati ai mondi generati.
Tipo: mappatura stringa a stringa
Voci sulla mappa: numero minimo di 0 elementi. Numero massimo di 50 item.
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.
Modello di chiave:
[a-zA-Z0-9 _.\-\/+=:]*Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.
Modello di valore:
[a-zA-Z0-9 _.\-\/+=:]*
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- IdempotentParameterMismatchException
-
La richiesta usa lo stesso token client di una precedente, ma non è una richiesta identica. Non riutilizzare un token client con richieste diverse a meno che le richieste non siano identiche.
Codice di stato HTTP: 400
- InternalServerException
-
AWS RoboMaker ha riscontrato un problema di servizio. Riprova la chiamata.
Codice di stato HTTP: 500
- InvalidParameterException
-
Un parametro specificato in una richiesta non è valido, non è supportato o non può essere utilizzato. Il messaggio restituito fornisce una spiegazione del valore di errore.
Codice di stato HTTP: 400
- LimitExceededException
-
La risorsa richiesta supera il numero massimo consentito o il numero di richieste di streaming simultanee supera il numero massimo consentito.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
La risorsa specificata non esiste.
Codice di stato HTTP: 400
- ServiceUnavailableException
-
La richiesta non è riuscita a causa di un errore temporaneo del server.
Codice di stato HTTP: 503
- ThrottlingException
-
AWS non RoboMaker è temporaneamente in grado di elaborare la richiesta. Riprova la chiamata.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
