CreateWorldExportJob - AWS RoboMaker
リクエストの構文URI リクエストパラメータリクエスト本文レスポンスの構文レスポンス要素エラー以下の資料も参照してください。

サポート終了通知: 2025 年 9 月 10 日、 AWS は のサポートを中止します AWS RoboMaker。2025 年 9 月 10 日以降、 AWS RoboMaker コンソールまたは AWS RoboMaker リソースにアクセスできなくなります。コンテナ化されたシミュレーションの実行に役立つ AWS Batch への移行の詳細については、このブログ記事 を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CreateWorldExportJob

重要

サポート終了通知: 2025 年 9 月 10 日、 AWS は のサポートを中止します AWS RoboMaker。2025 年 9 月 10 日以降、 AWS RoboMaker コンソールまたは AWS RoboMaker リソースにアクセスできなくなります。コンテナ化されたシミュレーションの実行に役立つ AWS Batch への移行の詳細については、このブログ記事 を参照してください。

ワールドのエクスポートジョブを作成します。

リクエストの構文

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

{
   "clientRequestToken": "string",
   "iamRole": "string",
   "outputLocation": { 
      "s3Bucket": "string",
      "s3Prefix": "string"
   },
   "tags": { 
      "string" : "string" 
   },
   "worlds": [ "string" ]
}

URI リクエストパラメータ

リクエストはURIパラメータを使用しません。

リクエスト本文

リクエストは、次のJSON形式のデータを受け入れます。

clientRequestToken

リクエストのべき等のために割り当てる一意の識別子 (大文字と小文字を区別)。

型: 文字列

長さの制限：最小長は 1 です。最大長は 64 文字です。

パターン: [a-zA-Z0-9_\-=]*

必須: いいえ

iamRole

ワールドエクスポートプロセスが Amazon S3 バケットにアクセスしてエクスポートを配置するために使用するIAMロール。

型: 文字列

長さの制限：最小長は 1 です。最大長は 255 です。

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

必須：はい

outputLocation

出力場所。

型: OutputLocation オブジェクト

必須：はい

tags

ワールドエクスポートジョブにアタッチされているタグキーとタグ値を含むマップ。

型: 文字列間のマッピング

マップエントリ: 最小数は 0 項目です。最大数は 50 項目です。

キーの長さ制限: 最小長さは 1 です。最大長は 128 です。

キーパターン: [a-zA-Z0-9 _.\-\/+=:]*

値の長さの制限: 最小長は 0 です。最大長は 256 です。

値のパターン: [a-zA-Z0-9 _.\-\/+=:]*

必須：いいえ

worlds

エクスポートするワールドに対応する Amazon リソースネーム (ARN) の一覧。

型: 文字列の配列

配列メンバー: 最小数は 1 項目です。最大数は 100 項目です。

長さの制限：最小長は 1 です。最大長は 1224 です。

Pattern: arn:.*

必須：はい

レスポンスの構文

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" 
   }
}

レスポンス要素

アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。

次のデータは、 サービスによって JSON 形式で返されます。

arn

ワールドエクスポートジョブの Amazon リソースネーム (ARN）。

型: 文字列

長さの制限：最小長は 1 です。最大長は 1224 です。

パターン: arn:.*

clientRequestToken

リクエストのべき等のために割り当てる一意の識別子 (大文字と小文字を区別)。

型: 文字列

長さの制限：最小長は 1 です。最大長は 64 文字です。

パターン: [a-zA-Z0-9_\-=]*

createdAt

ワールドのエクスポートジョブが作成されたときの、エポックからのミリ秒単位の時間。

型: タイムスタンプ

failureCode

ワールドエクスポートジョブが失敗した場合の失敗コード:

InternalServiceError

内部サービスエラー。

LimitExceeded

リクエストされたリソースが最大許容数を超えているか、または同時ストリームリクエストの数が最大許容数を超えています。

ResourceNotFound

指定したリソースが見つかりませんでした。

RequestThrottled

リクエストがスロットリングされました。

InvalidInput

リクエストの入力パラメータが無効です。

AllWorldGenerationFailed

ワールド生成ジョブのすべてのワールドが失敗しました。これは、worldCount が 50 より大きい場合、または 1 より小さい場合に発生する可能性があります。

のトラブルシューティングの詳細については WorldForge、「シミュレーションのトラブルシューティング WorldForge」を参照してください。

型: 文字列

有効な値: InternalServiceError | LimitExceeded | ResourceNotFound | RequestThrottled | InvalidInput | AccessDenied

iamRole

ワールドエクスポートプロセスが Amazon S3 バケットにアクセスしてエクスポートを配置するために使用するIAMロール。

型: 文字列

長さの制限：最小長は 1 です。最大長は 255 です。

パターン: arn:aws:iam::\w+:role/.*

outputLocation

出力場所。

型: OutputLocation オブジェクト

status

ワールドエクスポートジョブのステータス。

保留中

ワールドエクスポートジョブのリクエストが保留中です。

実行中

ワールドエクスポートジョブが実行中です。

完了

ワールドエクスポートジョブが完了しました。

[失敗]

ワールドエクスポートジョブが失敗しました。詳細については「failureCode」を参照してください。

キャンセル

ワールドエクスポートジョブがキャンセルされました。

キャンセル中

ワールドエクスポートジョブをキャンセルしています。

型: 文字列

有効な値: Pending | Running | Completed | Failed | Canceling | Canceled

tags

ワールドエクスポートジョブにアタッチされているタグキーとタグ値を含むマップ。

型: 文字列間のマッピング

マップエントリ: 最小数は 0 項目です。最大数は 50 項目です。

キーの長さ制限: 最小長さは 1 です。最大長は 128 です。

キーパターン: [a-zA-Z0-9 _.\-\/+=:]*

値の長さの制限: 最小長は 0 です。最大長は 256 です。

値のパターン: [a-zA-Z0-9 _.\-\/+=:]*

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

IdempotentParameterMismatchException

リクエストは、前の、しかし同一ではないリクエストと同じクライアントトークンを使用します。リクエストが同一でない限り、異なるリクエストでクライアントトークンを再利用しないでください。

HTTP ステータスコード: 400

InternalServerException

AWS RoboMaker でサービスの問題が発生しました。もう一度やり直してください。

HTTP ステータスコード: 500

InvalidParameterException

リクエストで指定されたパラメータが無効であるか、サポートされていないか、または使用できません。返されたメッセージはエラー値の説明を提供します。​

HTTP ステータスコード: 400

ResourceNotFoundException

指定されたリソースは存在しません。

HTTP ステータスコード: 400

ServiceUnavailableException

サーバーの一時的な障害により、リクエストは失敗しました。

HTTP ステータスコード: 503

ThrottlingException

AWS RoboMaker は一時的にリクエストを処理できません。もう一度やり直してください。

HTTP ステータスコード: 400

以下の資料も参照してください。

言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。