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à.
CreateWorldExportJob
Crea un lavoro di esportazione mondiale.
Sintassi della richiesta
POST /createWorldExportJob HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string
",
"iamRole": "string
",
"outputLocation": {
"s3Bucket": "string
",
"s3Prefix": "string
"
},
"tags": {
"string
" : "string
"
},
"worlds": [ "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 pari a 1. La lunghezza massima è 64 caratteri.
Modello:
[a-zA-Z0-9_\-=]*
Campo obbligatorio: no
- iamRole
-
Il ruolo IAM utilizzato dal processo di esportazione mondiale per accedere al bucket Amazon S3 e inserire l'esportazione.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.
Modello:
arn:aws:iam::\w+:role/.*
Campo obbligatorio: sì
- outputLocation
-
La posizione di output.
Tipo: oggetto OutputLocation
Campo obbligatorio: sì
-
Una mappa che contiene le chiavi e i valori dei tag associati al World Export 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
- worlds
-
Un elenco di Amazon Resource Names (ARN) che corrispondono ai mondi da esportare.
Tipo: matrice di stringhe
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 100 elementi.
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1224.
Modello:
arn:.*
Campo obbligatorio: sì
Sintassi della risposta
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"
}
}
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 lavoro di esportazione mondiale.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 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 pari a 1. La lunghezza massima è 64 caratteri.
Modello:
[a-zA-Z0-9_\-=]*
- createdAt
-
L'ora, espressa in millisecondi dall'epoca, in cui è stato creato il lavoro nel settore delle esportazioni mondiali.
Tipo: Timestamp
- failureCode
-
Il codice di fallimento del World Export 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.
- AllWorldGenerationFailed
-
Il lavoro di generazione mondiale è fallito in tutti i mondi. Questo può succedere se il tuo
worldCount
è maggiore di 50 o inferiore a 1.
Per ulteriori informazioni sulla risoluzione dei problemi WorldForge, vedere Troubleshooting Simulation WorldForge.
▬Tipo: stringa
Valori validi:
InternalServiceError | LimitExceeded | ResourceNotFound | RequestThrottled | InvalidInput | AccessDenied
- iamRole
-
Il ruolo IAM utilizzato dal processo di esportazione mondiale per accedere al bucket Amazon S3 e inserire l'esportazione.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.
Modello:
arn:aws:iam::\w+:role/.*
- outputLocation
-
La posizione di output.
Tipo: oggetto OutputLocation
- status
-
Lo status del lavoro nel settore delle esportazioni mondiali.
- In attesa
-
La richiesta di lavoro per l'esportazione mondiale è in sospeso.
- In esecuzione
-
L'offerta di esportazione mondiale è in corso.
- Completato
-
Il lavoro di esportazione mondiale è stato completato.
- Non riuscito
-
L'occupazione nel settore delle esportazioni mondiali è fallita. Per ulteriori informazioni, consulta
failureCode
. - Annullato
-
L'offerta di lavoro per le esportazioni mondiali è stata annullata.
- Annullamento
-
L'incarico di esportazione mondiale viene annullato.
▬Tipo: stringa
Valori validi:
Pending | Running | Completed | Failed | Canceling | Canceled
-
Una mappa che contiene le chiavi e i valori dei tag associati al World Export 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 _.\-\/+=:]*
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
- 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 AWS SDK specifici della lingua, consulta quanto segue: