CreateWorldExportJob - AWS RoboMaker
请求语法URI请求参数请求正文响应语法响应元素错误另请参阅

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

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

CreateWorldExportJob

重要

终止支持通知：2025 年 9 月 10 日， AWS 将停止对的支持。 AWS RoboMaker2025 年 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。

模式：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。

模式：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" 
   }
}

响应元素

如果操作成功，服务将发回 HTTP 200 响应。

以下数据由服务以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

世界导出作业的状态。

待处理

世界导出作业请求待处理。

Running

世界导出作业正在运行。

已完成

世界导出作业已完成。

失败

世界导出作业失败。请参阅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，请参阅以下内容：