サポート終了通知: 2025 年 9 月 10 日、 AWS は のサポートを中止します AWS RoboMaker。2025 年 9 月 10 日以降、 AWS RoboMaker コンソールまたは AWS RoboMaker リソースにアクセスできなくなります。コンテナ化されたシミュレーションの実行に役立つ AWS Batch への移行の詳細については、このブログ記事
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
DescribeSimulationJobBatch
重要
サポート終了通知: 2025 年 9 月 10 日、 AWS は のサポートを中止します AWS RoboMaker。2025 年 9 月 10 日以降、 AWS RoboMaker コンソールまたは AWS RoboMaker リソースにアクセスできなくなります。コンテナ化されたシミュレーションの実行に役立つ AWS Batch への移行の詳細については、このブログ記事
シミュレーションジョブバッチを記述します。
リクエストの構文
POST /describeSimulationJobBatch HTTP/1.1
Content-type: application/json
{
"batch": "string
"
}
URI リクエストパラメータ
リクエストはURIパラメータを使用しません。
リクエスト本文
リクエストは、次のJSON形式のデータを受け入れます。
- batch
-
記述するバッチの ID。
型: 文字列
長さの制限:最小長は 1 です。最大長は 1224 です。
Pattern:
arn:.*
必須:はい
レスポンスの構文
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"
}
}
レスポンス要素
アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。
次のデータは、 サービスによって JSON 形式で返されます。
- arn
-
バッチの Amazon リソースネーム (ARN)。
型: 文字列
長さの制限:最小長は 1 です。最大長は 1224 です。
パターン:
arn:.*
- batchPolicy
-
バッチポリシー。
型: BatchPolicy オブジェクト
- clientRequestToken
-
リクエストのべき等のために割り当てる一意の識別子 (大文字と小文字を区別)。
型: 文字列
長さの制限:最小長は 1 です。最大長は 64 文字です。
パターン:
[a-zA-Z0-9_\-=]*
- createdAt
-
シミュレーションジョブバッチが作成されたときの、エポックからのミリ秒単位の時間。
型: タイムスタンプ
- createdRequests
-
作成されたシミュレーションジョブの概要のリスト。
型: SimulationJobSummary オブジェクトの配列
配列メンバー: 最小数は 0 項目です。最大数は 100 項目です。
- failedRequests
-
失敗したシミュレーションジョブ作成リクエストのリスト。シミュレーションジョブに対してリクエストを作成できませんでした。失敗したリクエストにはシミュレーションジョブ ID がありません。
型: FailedCreateSimulationJobRequest オブジェクトの配列
- failureCode
-
シミュレーションジョブバッチの失敗コード。
型: 文字列
有効な値:
InternalServiceError
- failureReason
-
シミュレーションジョブバッチが失敗した理由。
型: 文字列
長さの制限: 最小長は 0 です。最大長は 1,024 です。
Pattern:
.*
- lastUpdatedAt
-
シミュレーションジョブバッチが最後に更新されたときの、エポックからのミリ秒単位の時間。
型: タイムスタンプ
- pendingRequests
-
保留中のシミュレーションジョブリクエストのリスト。これらのリクエストはシミュレーションジョブに対してまだ作成されていません。
型: SimulationJobRequest オブジェクトの配列
配列メンバー: 最小数は 1 項目です。最大数は 1000 項目です。
- status
-
バッチのステータス。
- 保留中
-
シミュレーションジョブバッチリクエストが保留中です。
- InProgress
-
シミュレーションジョブバッチが進行中です。
- [失敗]
-
シミュレーションジョブバッチが失敗しました。内部障害 (
InternalServiceError
など) により、1 つまたは複数のシミュレーションジョブリクエストを完了できませんでした 詳細については、「failureCode
」と「failureReason
」 を参照してください。 - 完了
-
シミュレーションバッチジョブが完了しました。バッチは、(1) バッチ内に保留中のシミュレーションジョブリクエストがなく、失敗したシミュレーションジョブリクエストがいずれも
InternalServiceError
を原因としない場合、および (2) 作成されたすべてのシミュレーションジョブが終了状態に達したとき (例えばCompleted
またはFailed
) に完了となります。 - キャンセル
-
シミュレーションバッチジョブがキャンセルされました。
- キャンセル中
-
シミュレーションバッチジョブをキャンセルしています。
- 完了中
-
シミュレーションバッチジョブを完了しています。
- TimingOut
-
シミュレーションバッチジョブがタイムアウトしています。
バッチがタイムアウトし、内部障害(
InternalServiceError
など) のために失敗していた保留中のリクエストがある場合の場合、バッチステータスはFailed
になります。このような失敗リクエストがない場合、バッチステータスはTimedOut
になります。 - TimedOut
-
シミュレーションバッチジョブがタイムアウトしました。
型: 文字列
有効な値:
Pending | InProgress | Failed | Completed | Canceled | Canceling | Completing | TimingOut | TimedOut
-
シミュレーションジョブバッチにアタッチされているタグキーとタグ値を含むマップ。
型: 文字列間のマッピング
マップエントリ: 最小数は 0 項目です。最大数は 50 項目です。
キーの長さ制限: 最小長さは 1 です。最大長は 128 です。
キーパターン:
[a-zA-Z0-9 _.\-\/+=:]*
値の長さの制限: 最小長は 0 です。最大長は 256 です。
値のパターン:
[a-zA-Z0-9 _.\-\/+=:]*
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- InternalServerException
-
AWS RoboMaker でサービスの問題が発生しました。もう一度やり直してください。
HTTP ステータスコード: 500
- InvalidParameterException
-
リクエストで指定されたパラメータが無効であるか、サポートされていないか、または使用できません。返されたメッセージはエラー値の説明を提供します。
HTTP ステータスコード: 400
- ResourceNotFoundException
-
指定されたリソースは存在しません。
HTTP ステータスコード: 400
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。