DescribeSimulationJob

描述模拟作业。

请求语法


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

{
   "job": "string"
}

URI 请求参数

该请求不使用任何 URI 参数。

请求体

请求接受采用 JSON 格式的以下数据。

job

要描述模拟作业的 Amazon 资源名称（ARN）。

类型：字符串

长度限制：长度下限为 1。最大长度为 1224。

模式：arn:.*

必需：是

响应语法


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",
   "failureReason": "string",
   "iamRole": "string",
   "lastStartedAt": number,
   "lastUpdatedAt": number,
   "loggingConfig": { 
      "recordAllRosTopics": boolean
   },
   "maxJobDurationInSeconds": number,
   "name": "string",
   "networkInterface": { 
      "networkInterfaceId": "string",
      "privateIpAddress": "string",
      "publicIpAddress": "string"
   },
   "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"
   }
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

arn

模拟作业的 Amazon 资源名称（ARN）。

类型：字符串

长度限制：长度下限为 1。最大长度为 1224。

模式：arn:.*

clientRequestToken

用于确保请求的幂等性而提供的唯一、区分大小写的标识符。

类型：字符串

长度限制：长度下限为 1。长度上限为 64。

模式：[a-zA-Z0-9_\-=]*

compute

计算模拟作业的信息。

类型：ComputeResponse 对象

dataSources

模拟作业的数据来源。

类型：DataSource 对象数组

failureBehavior

模拟作业的失败行为。

类型：字符串

有效值：Fail | Continue

failureCode

模拟作业失败时的失败代码：

InternalServiceError: 内部服务错误。
RobotApplicationCrash: 机器人应用程序异常退出。
SimulationApplicationCrash: 模拟应用程序异常退出。
BadPermissionsRobotApplication: 无法下载机器人应用程序包。
BadPermissionsSimulationApplication: 无法下载模拟应用程序包。
BadPermissionsS3Output: 无法将输出发布到客户提供的 S3 存储桶。
BadPermissionsCloudwatchLogs: 无法将日志发布到客户提供的 CloudWatch 日志资源。
SubnetIpLimitExceeded: 已超出子网 IP 限制。
ENI LimitExceeded: 超出 ENI 限制。
BadPermissionsUserCredentials: 无法使用提供的角色。
InvalidBundleRobotApplication: 无法提取机器人捆绑包（格式无效、捆绑错误或其他问题）。
InvalidBundleSimulationApplication: 无法提取模拟捆绑包（格式无效、捆绑错误或其他问题）。
RobotApplicationVersionMismatchedEtag: Etag for 在版本创建期间与值 RobotApplication 不匹配。
SimulationApplicationVersionMismatchedEtag: Etag for 在版本创建期间与值 SimulationApplication 不匹配。