翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
DescribeSimulationJobBatch
シミュレーションジョブバッチを記述します。
リクエストの構文
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"
}
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが 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 です。
パターン:
.* - 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
その他の参照資料
言語固有の AWS SDK の 1 つでこの API を使用する方法の詳細については、以下を参照してください。
