Avviso di fine del supporto: il 10 settembre 2025, AWS
interromperà il supporto per. AWS RoboMaker Dopo il 10 settembre 2025, non potrai più accedere alla AWS RoboMaker console o alle risorse. AWS RoboMaker Per ulteriori informazioni sulla transizione AWS Batch verso l'esecuzione di simulazioni containerizzate, consulta questo post del blog.
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à.
StartSimulationJobBatch
Importante
Avviso di fine del supporto: il 10 settembre 2025, AWS
il supporto per. AWS RoboMaker Dopo il 10 settembre 2025, non potrai più accedere alla AWS RoboMaker console o alle risorse. AWS RoboMaker Per ulteriori informazioni sulla transizione AWS Batch verso l'esecuzione di simulazioni containerizzate, consulta questo post del blog.
Avvia un nuovo batch di lavori di simulazione. Il batch viene definito utilizzando uno o più SimulationJobRequest oggetti.
Sintassi della richiesta
POST /startSimulationJobBatch HTTP/1.1
Content-type: application/json
{
"batchPolicy": {
"maxConcurrency": number,
"timeoutInSeconds": number
},
"clientRequestToken": "string",
"createSimulationJobRequests": [
{
"compute": {
"computeType": "string",
"gpuUnitLimit": number,
"simulationUnitLimit": number
},
"dataSources": [
{
"destination": "string",
"name": "string",
"s3Bucket": "string",
"s3Keys": [ "string" ],
"type": "string"
}
],
"failureBehavior": "string",
"iamRole": "string",
"loggingConfig": {
"recordAllRosTopics": boolean
},
"maxJobDurationInSeconds": number,
"outputLocation": {
"s3Bucket": "string",
"s3Prefix": "string"
},
"robotApplications": [
{
"application": "string",
"applicationVersion": "string",
"launchConfig": {
"command": [ "string" ],
"environmentVariables": {
"string" : "string"
},
"launchFile": "string",
"packageName": "string",
"portForwardingConfig": {
"portMappings": [
{
"applicationPort": number,
"enableOnPublicIp": boolean,
"jobPort": number
}
]
},
"streamUI": boolean
},
"tools": [
{
"command": "string",
"exitBehavior": "string",
"name": "string",
"streamOutputToCloudWatch": boolean,
"streamUI": boolean
}
],
"uploadConfigurations": [
{
"name": "string",
"path": "string",
"uploadBehavior": "string"
}
],
"useDefaultTools": boolean,
"useDefaultUploadConfigurations": boolean
}
],
"simulationApplications": [
{
"application": "string",
"applicationVersion": "string",
"launchConfig": {
"command": [ "string" ],
"environmentVariables": {
"string" : "string"
},
"launchFile": "string",
"packageName": "string",
"portForwardingConfig": {
"portMappings": [
{
"applicationPort": number,
"enableOnPublicIp": boolean,
"jobPort": number
}
]
},
"streamUI": boolean
},
"tools": [
{
"command": "string",
"exitBehavior": "string",
"name": "string",
"streamOutputToCloudWatch": boolean,
"streamUI": boolean
}
],
"uploadConfigurations": [
{
"name": "string",
"path": "string",
"uploadBehavior": "string"
}
],
"useDefaultTools": boolean,
"useDefaultUploadConfigurations": boolean,
"worldConfigs": [
{
"world": "string"
}
]
}
],
"tags": {
"string" : "string"
},
"useDefaultApplications": boolean,
"vpcConfig": {
"assignPublicIp": boolean,
"securityGroups": [ "string" ],
"subnets": [ "string" ]
}
}
],
"tags": {
"string" : "string"
}
}URIParametri della richiesta
La richiesta non utilizza alcun URI parametro.
Corpo della richiesta
La richiesta accetta i seguenti dati nel JSON formato.
- batchPolicy
-
La politica dei batch.
Tipo: oggetto BatchPolicy
Campo obbligatorio: no
- 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
- createSimulationJobRequests
-
Un elenco di richieste di lavori di simulazione da creare nel batch.
Tipo: matrice di oggetti SimulationJobRequest
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 1.000 elementi.
Campo obbligatorio: sì
-
Una mappa che contiene le chiavi e i valori dei tag allegati al batch del processo di distribuzione.
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",
"batchPolicy": {
"maxConcurrency": number,
"timeoutInSeconds": number
},
"clientRequestToken": "string",
"createdAt": number,
"createdRequests": [
{
"arn": "string",
"computeType": "string",
"dataSourceNames": [ "string" ],
"lastUpdatedAt": number,
"name": "string",
"robotApplicationNames": [ "string" ],
"simulationApplicationNames": [ "string" ],
"status": "string"
}
],
"failedRequests": [
{
"failedAt": number,
"failureCode": "string",
"failureReason": "string",
"request": {
"compute": {
"computeType": "string",
"gpuUnitLimit": number,
"simulationUnitLimit": number
},
"dataSources": [
{
"destination": "string",
"name": "string",
"s3Bucket": "string",
"s3Keys": [ "string" ],
"type": "string"
}
],
"failureBehavior": "string",
"iamRole": "string",
"loggingConfig": {
"recordAllRosTopics": boolean
},
"maxJobDurationInSeconds": number,
"outputLocation": {
"s3Bucket": "string",
"s3Prefix": "string"
},
"robotApplications": [
{
"application": "string",
"applicationVersion": "string",
"launchConfig": {
"command": [ "string" ],
"environmentVariables": {
"string" : "string"
},
"launchFile": "string",
"packageName": "string",
"portForwardingConfig": {
"portMappings": [
{
"applicationPort": number,
"enableOnPublicIp": boolean,
"jobPort": number
}
]
},
"streamUI": boolean
},
"tools": [
{
"command": "string",
"exitBehavior": "string",
"name": "string",
"streamOutputToCloudWatch": boolean,
"streamUI": boolean
}
],
"uploadConfigurations": [
{
"name": "string",
"path": "string",
"uploadBehavior": "string"
}
],
"useDefaultTools": boolean,
"useDefaultUploadConfigurations": boolean
}
],
"simulationApplications": [
{
"application": "string",
"applicationVersion": "string",
"launchConfig": {
"command": [ "string" ],
"environmentVariables": {
"string" : "string"
},
"launchFile": "string",
"packageName": "string",
"portForwardingConfig": {
"portMappings": [
{
"applicationPort": number,
"enableOnPublicIp": boolean,
"jobPort": number
}
]
},
"streamUI": boolean
},
"tools": [
{
"command": "string",
"exitBehavior": "string",
"name": "string",
"streamOutputToCloudWatch": boolean,
"streamUI": boolean
}
],
"uploadConfigurations": [
{
"name": "string",
"path": "string",
"uploadBehavior": "string"
}
],
"useDefaultTools": boolean,
"useDefaultUploadConfigurations": boolean,
"worldConfigs": [
{
"world": "string"
}
]
}
],
"tags": {
"string" : "string"
},
"useDefaultApplications": boolean,
"vpcConfig": {
"assignPublicIp": boolean,
"securityGroups": [ "string" ],
"subnets": [ "string" ]
}
}
}
],
"failureCode": "string",
"failureReason": "string",
"pendingRequests": [
{
"compute": {
"computeType": "string",
"gpuUnitLimit": number,
"simulationUnitLimit": number
},
"dataSources": [
{
"destination": "string",
"name": "string",
"s3Bucket": "string",
"s3Keys": [ "string" ],
"type": "string"
}
],
"failureBehavior": "string",
"iamRole": "string",
"loggingConfig": {
"recordAllRosTopics": boolean
},
"maxJobDurationInSeconds": number,
"outputLocation": {
"s3Bucket": "string",
"s3Prefix": "string"
},
"robotApplications": [
{
"application": "string",
"applicationVersion": "string",
"launchConfig": {
"command": [ "string" ],
"environmentVariables": {
"string" : "string"
},
"launchFile": "string",
"packageName": "string",
"portForwardingConfig": {
"portMappings": [
{
"applicationPort": number,
"enableOnPublicIp": boolean,
"jobPort": number
}
]
},
"streamUI": boolean
},
"tools": [
{
"command": "string",
"exitBehavior": "string",
"name": "string",
"streamOutputToCloudWatch": boolean,
"streamUI": boolean
}
],
"uploadConfigurations": [
{
"name": "string",
"path": "string",
"uploadBehavior": "string"
}
],
"useDefaultTools": boolean,
"useDefaultUploadConfigurations": boolean
}
],
"simulationApplications": [
{
"application": "string",
"applicationVersion": "string",
"launchConfig": {
"command": [ "string" ],
"environmentVariables": {
"string" : "string"
},
"launchFile": "string",
"packageName": "string",
"portForwardingConfig": {
"portMappings": [
{
"applicationPort": number,
"enableOnPublicIp": boolean,
"jobPort": number
}
]
},
"streamUI": boolean
},
"tools": [
{
"command": "string",
"exitBehavior": "string",
"name": "string",
"streamOutputToCloudWatch": boolean,
"streamUI": boolean
}
],
"uploadConfigurations": [
{
"name": "string",
"path": "string",
"uploadBehavior": "string"
}
],
"useDefaultTools": boolean,
"useDefaultUploadConfigurations": boolean,
"worldConfigs": [
{
"world": "string"
}
]
}
],
"tags": {
"string" : "string"
},
"useDefaultApplications": boolean,
"vpcConfig": {
"assignPublicIp": boolean,
"securityGroups": [ "string" ],
"subnets": [ "string" ]
}
}
],
"status": "string",
"tags": {
"string" : "string"
}
}Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal servizio.
- arn
-
L'Amazon Resource Name (arn) del batch.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1224.
Modello:
arn:.* - batchPolicy
-
La politica dei batch.
Tipo: oggetto BatchPolicy
- 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, in millisecondi dall'epoca, in cui è stato creato il batch di lavori di simulazione.
Tipo: Timestamp
- createdRequests
-
Un elenco di riepiloghi delle richieste di lavori di simulazione creati.
Tipo: matrice di oggetti SimulationJobSummary
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 100 elementi.
- failedRequests
-
Un elenco di richieste di lavori di simulazione non riuscite. La richiesta non è stata creata in un lavoro di simulazione. Le richieste non riuscite non hanno un ID del lavoro di simulazione.
Tipo: matrice di oggetti FailedCreateSimulationJobRequest
- failureCode
-
Il codice di errore se il batch del processo di simulazione non è riuscito.
Tipo: stringa
Valori validi:
InternalServiceError - failureReason
-
Il motivo per cui il batch di processi di simulazione non è riuscito.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.
Modello:
.* - pendingRequests
-
Un elenco di richieste di lavori di simulazione in sospeso. Queste richieste non sono ancora state inserite in lavori di simulazione.
Tipo: matrice di oggetti SimulationJobRequest
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 1.000 elementi.
- status
-
Lo stato del batch di lavori di simulazione.
- In attesa
-
La richiesta del batch di processi di simulazione è in sospeso.
- InProgress
-
Il batch di processi di simulazione è in corso.
- Non riuscito
-
Il batch di processi di simulazione non è riuscito. Una o più richieste di lavori di simulazione non possono essere completate a causa di un errore interno (ad esempio
InternalServiceError). Per ulteriori informazioni, consultafailureCodeefailureReason. - Completato
-
Il processo in batch di simulazione è stato completato. Un batch è completo quando (1) non vi sono richieste di lavori di simulazione in sospeso nel batch e nessuna delle richieste di lavoro di simulazione non riuscite è dovuta a
InternalServiceErrore (2) quando tutti i lavori di simulazione creati hanno raggiunto uno stato terminale (ad esempio, o).CompletedFailed - Annullato
-
Il processo del batch di simulazione è stato annullato.
- Annullamento
-
Il processo in batch di simulazione viene annullato.
- Completamento
-
Il processo di simulazione in batch è completato.
- TimingOut
-
Il batch del processo di simulazione sta scadendo.
Se un batch scade e ci sono richieste in sospeso che non sono riuscite a causa di un errore interno (ad esempio
InternalServiceError), lo stato del batch sarà.FailedSe non ci sono richieste di questo tipo non riuscite, lo stato del batch sarà.TimedOut - TimedOut
-
Il processo del batch di simulazione è scaduto.
Tipo: stringa
Valori validi:
Pending | InProgress | Failed | Completed | Canceled | Canceling | Completing | TimingOut | TimedOut -
Una mappa che contiene le chiavi e i valori dei tag allegati al batch del processo di distribuzione.
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.
HTTPCodice di stato: 400
- InternalServerException
-
AWS RoboMaker ha riscontrato un problema di assistenza. Riprova la chiamata.
HTTPCodice di stato: 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.
HTTPCodice di stato: 400
- LimitExceededException
-
La risorsa richiesta supera il numero massimo consentito oppure il numero di richieste di streaming simultanee supera il numero massimo consentito.
HTTPCodice di stato: 400
- ThrottlingException
-
AWS RoboMaker non è temporaneamente in grado di elaborare la richiesta. Riprova la chiamata.
HTTPCodice di stato: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
