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
" ]
}
}
URIParameter anfordern
Die Anfrage verwendet keine URI Parameter.
Anforderungstext
Die Anfrage 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 AWSAPIs, die in den zugehörigen Richtlinien angegebenen Rollen 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 sie erreicht
maxJobDurationInSeconds
ist, wechselt der Status des Simulationsjobs zu.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
-
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 einem zugreiftVPC, geben Sie diesen Parameter an, der die Liste der Sicherheitsgruppen IDs und des IDs Subnetzes identifiziert. Diese müssen zu demselben gehören. VPC 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 Dienst eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Dienst 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.
- ENILimitExceeded
-
ENILimit ü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
Zulässige Werte:
InternalServiceError | RobotApplicationCrash | SimulationApplicationCrash | RobotApplicationHealthCheckFailure | SimulationApplicationHealthCheckFailure | BadPermissionsRobotApplication | BadPermissionsSimulationApplication | BadPermissionsS3Object | BadPermissionsS3Output | BadPermissionsCloudwatchLogs | SubnetIpLimitExceeded | ENILimitExceeded | BadPermissionsUserCredentials | InvalidBundleRobotApplication | InvalidBundleSimulationApplication | InvalidS3Resource | ThrottlingError | LimitExceeded | MismatchedEtag | RobotApplicationVersionMismatchedEtag | SimulationApplicationVersionMismatchedEtag | ResourceNotFound | RequestThrottled | BatchTimedOut | BatchCanceled | InvalidInput | WrongRegionS3Bucket | WrongRegionS3Output | WrongRegionRobotApplication | WrongRegionSimulationApplication | UploadContentMismatchError
- iamRole
-
Die IAM Rolle, die es dem Simulationsjob ermöglicht AWSAPIs, die in den zugehörigen Richtlinien angegebenen Werte 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
Zulässige Werte:
Pending | Preparing | Running | Restarting | Completed | Failed | RunningFailed | Terminating | Terminated | Canceled
-
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.
HTTPStatuscode: 400
- 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
- LimitExceededException
-
Die angeforderte Ressource überschreitet die maximal zulässige Anzahl, oder die Anzahl gleichzeitiger Stream-Anfragen überschreitet die zulässige Höchstzahl.
HTTPStatuscode: 400
- ResourceNotFoundException
-
Die angegebene Ressource ist nicht vorhanden.
HTTPStatuscode: 400
- ServiceUnavailableException
-
Die Anforderung ist aufgrund eines temporären Fehlers des Servers fehlgeschlagen.
HTTPStatuscode: 503
- ThrottlingException
-
AWS RoboMaker kann die Anfrage vorübergehend nicht bearbeiten. Wiederholen Sie den Aufruf.
HTTPStatuscode: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: