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.
CreateWorldExportJob
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 Weltexportauftrag.
Anforderungssyntax
POST /createWorldExportJob HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string
",
"iamRole": "string
",
"outputLocation": {
"s3Bucket": "string
",
"s3Prefix": "string
"
},
"tags": {
"string
" : "string
"
},
"worlds": [ "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
- iamRole
-
Die IAM Rolle, die der Weltexportprozess verwendet, um auf den Amazon S3 S3-Bucket zuzugreifen und den Export durchzuführen.
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
- outputLocation
-
Der Ausgabeort.
Typ: OutputLocation Objekt
Erforderlich: Ja
-
Eine Map, die Tag-Schlüssel und Tag-Werte enthält, die dem Weltexport-Job 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
- worlds
-
Eine Liste von Amazon-Ressourcennamen (ARNS), die den zu exportierenden Welten entsprechen.
Typ: Zeichenfolgen-Array
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 100 Elemente.
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",
"clientRequestToken": "string",
"createdAt": number,
"failureCode": "string",
"iamRole": "string",
"outputLocation": {
"s3Bucket": "string",
"s3Prefix": "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 Weltexportauftrags.
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_\-=]*
- createdAt
-
Die Zeit in Millisekunden seit der Epoche, als der Weltexportjob geschaffen wurde.
Typ: Zeitstempel
- failureCode
-
Der Fehlercode des Weltexportauftrags, falls er fehlgeschlagen ist:
- InternalServiceError
-
Interner Dienstfehler.
- LimitExceeded
-
Die angeforderte Ressource überschreitet die maximal zulässige Anzahl, oder die Anzahl gleichzeitiger Stream-Anfragen überschreitet die zulässige Höchstzahl.
- ResourceNotFound
-
Die angegebene Ressource konnte nicht gefunden werden.
- RequestThrottled
-
Die Anforderung wurde gedrosselt.
- InvalidInput
-
Ein Eingabeparameter in der Anfrage ist nicht gültig.
- AllWorldGenerationFailed
-
Alle Weltengenerierungsprojekte sind gescheitert. Das kann passieren, wenn dein
worldCount
Wert größer als 50 oder kleiner als 1 ist.
Weitere Informationen zur Problembehandlung finden Sie WorldForge unter Problembehandlung bei der Simulation WorldForge.
Typ: Zeichenfolge
Zulässige Werte:
InternalServiceError | LimitExceeded | ResourceNotFound | RequestThrottled | InvalidInput | AccessDenied
- iamRole
-
Die IAM Rolle, die der Weltexportprozess verwendet, um auf den Amazon S3 S3-Bucket zuzugreifen und den Export durchzuführen.
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/.*
- outputLocation
-
Der Ausgabeort.
Typ: OutputLocation Objekt
- status
-
Der Status des Weltexportauftrags.
- Ausstehend
-
Die Anfrage für den Weltexportauftrag steht noch aus.
- In Ausführung
-
Der Weltexportauftrag wird ausgeführt.
- Completed
-
Der Weltexportauftrag ist abgeschlossen.
- Fehlgeschlagen
-
Der Weltexportauftrag ist fehlgeschlagen. Weitere Informationen finden Sie unter
failureCode
. - Canceled
-
Der Weltexportauftrag wurde storniert.
- Der Vorgang wird storniert
-
Der Weltexportauftrag wird storniert.
Typ: Zeichenfolge
Zulässige Werte:
Pending | Running | Completed | Failed | Canceling | Canceled
-
Eine Map, die Tag-Schlüssel und Tag-Werte enthält, die mit dem Weltexportauftrag verknüpft 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.
- 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
- 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: