Anforderungssyntax URI-Anfrageparameter Anforderungstext Antwortsyntax Antwortelemente Fehler Weitere Informationen finden Sie unter:

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.

CreateSimulationJob

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.

Erstellt einen Simulationsjob.

Anmerkung

Simulationsaufträge laufen nach 90 Tagen ab und werden gelöscht. Sie sind nicht mehr zugänglich.

Anforderungssyntax


POST /createSimulationJob HTTP/1.1
Content-type: application/json

{
   "clientRequestToken": "string",
   "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" 
   },
   "vpcConfig": { 
      "assignPublicIp": boolean,
      "securityGroups": [ "string" ],
      "subnets": [ "string" ]
   }
}

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

clientRequestToken

Eindeutiger Bezeichner mit Berücksichtigung von Groß- und Kleinschreibung, 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_\-=]*

Erforderlich: Nein

compute

Berechne die Informationen für den Simulationsjob.

Typ: Compute Objekt

Erforderlich: Nein

dataSources

Geben Sie Datenquellen an, um schreibgeschützte Dateien aus S3 in Ihre Simulation einzubinden. Diese Dateien sind verfügbar unter. /opt/robomaker/datasources/data_source_name

Anmerkung

Es gibt ein Limit von 100 Dateien und eine Gesamtgröße von 25 GB für alle DataSourceConfig Objekte.

Typ: Array von DataSourceConfig-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 6 Elemente.

Erforderlich: Nein

failureBehavior

Das Fehlerverhalten des Simulationsjobs.

Continue: Läßt die Instanz nach einem 4XX Fehlercode für ihre maximale Timeoutdauer laufen.
Fehler: Beenden Sie den Simulationsjob und beenden Sie die Instanz.

Typ: Zeichenfolge

Zulässige Werte: Fail | Continue

Erforderlich: Nein

iamRole

Der IAM-Rollenname, der es der Simulationsinstanz ermöglicht, die AWS APIs , die in den zugehörigen Richtlinien angegeben sind, in Ihrem Namen aufzurufen. Auf diese Weise werden Anmeldeinformationen an Ihren Simulationsjob übergeben.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 255 Zeichen.

Pattern: arn:aws:iam::\w+:role/.*

Erforderlich: Ja

loggingConfig

Die Protokollierungskonfiguration.

Typ: LoggingConfig Objekt

Erforderlich: Nein

maxJobDurationInSeconds

Die maximale Dauer des Simulationsauftrags in Sekunden (bis zu 14 Tage oder 1.209.600 Sekunden). Wenn dieser maxJobDurationInSeconds Wert erreicht ist, wird der Status des Simulationsauftrags auf geändert. Completed

Type: Long

Erforderlich: Ja

outputLocation

Speicherort für die vom Simulationsjob generierten Ausgabedateien.

Typ: OutputLocation Objekt

Erforderlich: Nein

robotApplications

Die Roboteranwendung, die im Simulationsjob verwendet werden soll.

Typ: Array von RobotApplicationConfig-Objekten

Array-Mitglieder: Feste Anzahl von 1 Element.

Erforderlich: Nein

simulationApplications

Die Simulationsanwendung, die im Simulationsjob verwendet werden soll.

Typ: Array von SimulationApplicationConfig-Objekten

Array-Mitglieder: Feste Anzahl von 1 Element.

Erforderlich: Nein

tags

Eine Map, die Tag-Schlüssel und Tag-Werte enthält, die dem Simulationsjob 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 _.\-\/+=:]*

Erforderlich: Nein

vpcConfig

Wenn Ihr Simulationsjob auf Ressourcen in einer VPC zugreift, geben Sie diesen Parameter an, der die Liste der Sicherheitsgruppen IDs und des Subnetzes identifiziert. IDs Diese müssen zu derselben VPC gehören. Sie müssen mindestens eine Sicherheitsgruppe und eine Subnetz-ID angeben.

Typ: VPCConfig Objekt

Erforderlich: Nein

Antwortsyntax


HTTP/1.1 200
Content-type: application/json

{
   "arn": "string",
   "clientRequestToken": "string",
   "compute": { 
      "computeType": "string",
      "gpuUnitLimit": number,
      "simulationUnitLimit": number
   },
   "dataSources": [ 
      { 
         "destination": "string",
         "name": "string",
         "s3Bucket": "string",
         "s3Keys": [ 
            { 
               "etag": "string",
               "s3Key": "string"
            }
         ],
         "type": "string"
      }
   ],
   "failureBehavior": "string",
   "failureCode": "string",
   "iamRole": "string",
   "lastStartedAt": number,
   "lastUpdatedAt": number,
   "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"
            }
         ]
      }
   ],
   "simulationTimeMillis": number,
   "status": "string",
   "tags": { 
      "string" : "string" 
   },
   "vpcConfig": { 
      "assignPublicIp": boolean,
      "securityGroups": [ "string" ],
      "subnets": [ "string" ],
      "vpcId": "string"
   }
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

arn

Der Amazon-Ressourcenname (ARN) des Simulationsjobs.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 1224.

Pattern: arn:.*

clientRequestToken

Eindeutiger Bezeichner mit Berücksichtigung von Groß- und Kleinschreibung, 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_\-=]*

compute

Berechne die Informationen für den Simulationsjob.

Typ: ComputeResponse Objekt

dataSources

Die Datenquellen für den Simulationsjob.

Typ: Array von DataSource-Objekten

failureBehavior

das Fehlerverhalten für den Simulationsjob.

Typ: Zeichenfolge

Zulässige Werte: Fail | Continue

failureCode

Der Fehlercode des Simulationsjobs, falls er fehlgeschlagen ist:

InternalServiceError: Interner Dienstfehler.
RobotApplicationCrash: Die Roboteranwendung wurde ungewöhnlich beendet.
SimulationApplicationCrash: Die Simulationsanwendung wurde ungewöhnlich beendet.
BadPermissionsRobotApplication: Das Robot-Anwendungspaket konnte nicht heruntergeladen werden.
BadPermissionsSimulationApplication: Das Simulationsanwendungspaket konnte nicht heruntergeladen werden.
BadPermissionsS3-Ausgabe: Die Ausgaben konnten nicht im vom Kunden bereitgestellten S3-Bucket veröffentlicht werden.
BadPermissionsCloudwatchLogs: Die Protokolle konnten nicht in der vom Kunden bereitgestellten CloudWatch Protokollressource veröffentlicht werden.
SubnetIpLimitExceeded: Das Subnetz-IP-Limit wurde überschritten.
ENILimitÜberschritten: ENI-Limit überschritten.
BadPermissionsUserCredentials: Die angegebene Rolle kann nicht verwendet werden.
InvalidBundleRobotApplication: Das Roboterpaket kann nicht extrahiert werden (ungültiges Format, Bündelungsfehler oder anderes Problem).
InvalidBundleSimulationApplication: Das Simulationspaket kann nicht extrahiert werden (ungültiges Format, Bündelungsfehler oder anderes Problem).
RobotApplicationVersionMismatchedEtag: Etag for RobotApplication stimmt bei der Versionserstellung nicht mit dem Wert überein.
SimulationApplicationVersionMismatchedEtag: Etag for entspricht SimulationApplication nicht dem Wert bei der Versionserstellung.

Typ: Zeichenfolge

iamRole

Die IAM-Rolle, die es dem Simulationsjob ermöglicht, die AWS APIs , die in den zugehörigen Richtlinien angegeben sind, in Ihrem Namen aufzurufen.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 255 Zeichen.

Pattern: arn:aws:iam::\w+:role/.*

lastStartedAt

Die Zeit in Millisekunden seit der Epoche, zu der der Simulationsjob zuletzt gestartet wurde.

Typ: Zeitstempel

lastUpdatedAt

Die Zeit in Millisekunden seit der Epoche, zu der der Simulationsjob zuletzt aktualisiert wurde.

Typ: Zeitstempel

loggingConfig

Die Protokollierungskonfiguration.

Typ: LoggingConfig Objekt

maxJobDurationInSeconds

Die maximale Dauer des Simulationsauftrags in Sekunden.

Type: Long

outputLocation

Speicherort der Ausgabedateien des Simulationsauftrags.

Typ: OutputLocation Objekt

robotApplications

Die Roboteranwendung, die vom Simulationsjob verwendet wird.

Typ: Array von RobotApplicationConfig-Objekten

Array-Mitglieder: Feste Anzahl von 1 Element.

simulationApplications

Die vom Simulationsjob verwendete Simulationsanwendung.

Typ: Array von SimulationApplicationConfig-Objekten

Array-Mitglieder: Feste Anzahl von 1 Element.

simulationTimeMillis

Die Ausführungsdauer des Simulationsauftrags in Millisekunden.

Type: Long

status

Der Status des Simulationsjobs.

Typ: Zeichenfolge

tags

Die Liste aller Tags, die dem Simulationsjob hinzugefügt wurden.

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 _.\-\/+=:]*

vpcConfig

Informationen zur VPC-Konfiguration.

Typ: VPCConfigResponse Objekt

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

IdempotentParameterMismatchException

Für die Anforderung wird das gleiche Client-Token wie für eine vorherige, aber nicht identische Anforderung verwendet. Verwenden Sie keine Client-Token für mehrere Anforderungen, es sei denn, die Anforderungen sind identisch.

HTTP Status Code: 400

InternalServerException

Bei AWS ist ein Serviceproblem RoboMaker aufgetreten. Wiederholen Sie den Aufruf.

HTTP Status Code: 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.

HTTP Status Code: 400

LimitExceededException

Die angeforderte Ressource überschreitet die maximal zulässige Anzahl, oder die Anzahl gleichzeitiger Stream-Anfragen überschreitet die zulässige Höchstzahl.

HTTP Status Code: 400

ResourceNotFoundException

Die angegebene Ressource ist nicht vorhanden.

HTTP Status Code: 400

ServiceUnavailableException

Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.

HTTP Status Code: 503

ThrottlingException

AWS RoboMaker kann die Anfrage vorübergehend nicht bearbeiten. Wiederholen Sie den Aufruf.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

CreateSimulationApplicationVersion

CreateWorldExportJob