DescribeSimulationJob

重要

终止支持通知：2025 年 9 月 10 日， AWS 将停止对的支持。 AWS RoboMaker2025 年 9 月 10 日之后，您将无法再访问 AWS RoboMaker 控制台或 AWS RoboMaker 资源。有关过渡 AWS Batch 到以帮助运行容器化仿真的更多信息，请访问此博客文章。

描述模拟作业。

请求语法


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 限制。
ENILimitExceeded: ENI已超过限制。
BadPermissionsUserCredentials: 无法使用提供的角色。
InvalidBundleRobotApplication: 无法提取机器人捆绑包（格式无效、捆绑错误或其他问题）。
InvalidBundleSimulationApplication: 无法提取模拟捆绑包（格式无效、捆绑错误或其他问题）。
RobotApplicationVersionMismatchedEtag: Etag for 在版本创建期间与值 RobotApplication 不匹配。
SimulationApplicationVersionMismatchedEtag: Etag for 在版本创建期间与值 SimulationApplication 不匹配。