Ende des Supporthinweises: Am 10. September 2025 AWS
wird der Support für AWS RoboMaker eingestellt. Nach dem 10. September 2025 können Sie nicht mehr auf die AWS RoboMaker Konsole oder die AWS RoboMaker Ressourcen zugreifen. Weitere Informationen AWS Batch zur Umstellung auf containerisierte Simulationen finden Sie in diesem Blogbeitrag.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
DescribeSimulationJobBatch
Wichtig
Hinweis zum Ende des Supports: Am 10. September 2025 AWS
wird der Support für AWS RoboMaker eingestellt. Nach dem 10. September 2025 können Sie nicht mehr auf die AWS RoboMaker Konsole oder die AWS RoboMaker Ressourcen zugreifen. Weitere Informationen AWS Batch zur Umstellung auf containerisierte Simulationen finden Sie in diesem Blogbeitrag.
Beschreibt einen Simulationsjob-Batch.
Anforderungssyntax
POST /describeSimulationJobBatch HTTP/1.1
Content-type: application/json
{
"batch": "string
"
}
URIAnforderungsparameter
Die Anfrage verwendet keine URI Parameter.
Anforderungstext
Die Anfrage akzeptiert die folgenden Daten im JSON Format.
- batch
-
Die ID des zu beschreibenden Batches.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 1224.
Pattern:
arn:.*
Erforderlich: Ja
Antwortsyntax
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",
"lastUpdatedAt": number,
"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"
}
}
Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.
- arn
-
Der Amazon-Ressourcenname (ARN) des Batches.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 1224.
Pattern:
arn:.*
- batchPolicy
-
Die Batch-Richtlinie.
Typ: BatchPolicy Objekt
- clientRequestToken
-
Eindeutiger Bezeichner, bei dem Groß- und Kleinschreibung berücksichtigt wird, den Sie angeben, um die Idempotenz der Anfrage sicherzustellen.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.
Pattern:
[a-zA-Z0-9_\-=]*
- createdAt
-
Die Zeit in Millisekunden seit der Epoche, zu der der Simulationsauftragsstapel erstellt wurde.
Typ: Zeitstempel
- createdRequests
-
Eine Liste der erstellten Zusammenfassungen von Simulationsaufträgen.
Typ: Array von SimulationJobSummary-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 100 Elemente.
- failedRequests
-
Eine Liste der fehlgeschlagenen Anfragen zur Erstellung von Simulationsaufträgen. Die Anforderung konnte nicht in einen Simulationsjob umgewandelt werden. Fehlgeschlagene Anfragen haben keine Simulationsauftrags-ID.
Typ: Array von FailedCreateSimulationJobRequest-Objekten
- failureCode
-
Der Fehlercode des Simulationsauftragsstapels.
Typ: Zeichenfolge
Zulässige Werte:
InternalServiceError
- failureReason
-
Der Grund, warum der Simulationsjob-Batch fehlgeschlagen ist.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 1024 Zeichen.
Pattern:
.*
- lastUpdatedAt
-
Die Zeit in Millisekunden seit der Epoche, zu der der Simulationsauftragsstapel zuletzt aktualisiert wurde.
Typ: Zeitstempel
- pendingRequests
-
Eine Liste ausstehender Simulationsauftragsanfragen. Diese Anfragen wurden noch nicht zu Simulationsaufträgen hinzugefügt.
Typ: Array von SimulationJobRequest-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 1000 Elemente.
- status
-
Der Status des Batches.
- Ausstehend
-
Die Batchanforderung für den Simulationsjob steht noch aus.
- InProgress
-
Der Simulationsauftragsstapel ist in Bearbeitung.
- Fehlgeschlagen
-
Der Simulationsauftragsstapel ist fehlgeschlagen. Eine oder mehrere Simulationsauftragsanforderungen konnten aufgrund eines internen Fehlers (like
InternalServiceError
) nicht abgeschlossen werden. Weitere Informationen finden Sie unterfailureCode
undfailureReason
. - Completed
-
Der Simulations-Batchauftrag wurde abgeschlossen. Ein Stapel ist abgeschlossen, wenn (1) keine ausstehenden Simulationsauftragsanforderungen im Stapel vorhanden sind und keine der fehlgeschlagenen Simulationsauftragsanforderungen darauf zurückzuführen ist
InternalServiceError
und (2) wenn alle erstellten Simulationsaufträge einen Endstatus erreicht haben (z. B.Completed
oderFailed
). - Canceled
-
Der Simulations-Batchauftrag wurde abgebrochen.
- Wird storniert
-
Der Simulations-Batch-Job wird abgebrochen.
- Wird abgeschlossen
-
Der Simulations-Batch-Job ist abgeschlossen.
- TimingOut
-
Das Timeout für den Batch des Simulationsauftrags ist abgelaufen.
Wenn bei einem Batch das Timeout überschritten wird und es ausstehende Anfragen gibt, die aufgrund eines internen Fehlers (wie
InternalServiceError
) fehlgeschlagen sind, wird der Batch-Status angezeigtFailed
. Liegt keine solche fehlgeschlagene Anfrage vor, wird der Batch-Status wie folgt angezeigtTimedOut
. - TimedOut
-
Das Timeout für den Simulations-Batchjob ist abgelaufen.
Typ: Zeichenfolge
Zulässige Werte:
Pending | InProgress | Failed | Completed | Canceled | Canceling | Completing | TimingOut | TimedOut
-
Eine Map, die Tag-Schlüssel und Tag-Werte enthält, die dem Simulationsjob-Batch zugeordnet sind.
Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge
Karteneinträge: Mindestanzahl von 0 Elementen. Die maximale Anzahl beträgt 50 Elemente.
Schlüssel-Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 128 Zeichen.
Schlüssel-Muster:
[a-zA-Z0-9 _.\-\/+=:]*
Längenbeschränkungen für Werte: Mindestlänge von 0. Maximale Länge beträgt 256 Zeichen.
Wertemuster:
[a-zA-Z0-9 _.\-\/+=:]*
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.
- InternalServerException
-
AWS RoboMaker es ist ein Serviceproblem aufgetreten. Wiederholen Sie den Aufruf.
HTTPStatuscode: 500
- InvalidParameterException
-
Ein Parameter in einer Anforderung ist nicht gültig, wird nicht unterstützt oder kann nicht verwendet werden. Die zurückgegebene Nachricht enthält eine Erläuterung des Fehlers.
HTTPStatuscode: 400
- ResourceNotFoundException
-
Die angegebene Ressource ist nicht vorhanden.
HTTPStatuscode: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: