终止支持通知：2025 年 9 月 10 日， AWS
将停止对的支持。 AWS RoboMaker2025 年 9 月 10 日之后，您将无法再访问 AWS RoboMaker 控制台或 AWS RoboMaker 资源。有关过渡 AWS Batch 到以帮助运行容器化仿真的更多信息，请访问此博客文章。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateWorldGenerationJob
重要
终止支持通知：2025 年 9 月 10 日， AWS
将停止对的支持。 AWS RoboMaker2025 年 9 月 10 日之后，您将无法再访问 AWS RoboMaker 控制台或 AWS RoboMaker 资源。有关过渡 AWS Batch 到以帮助运行容器化仿真的更多信息，请访问此博客文章。
使用指定的模板创建世界。
请求语法
POST /createWorldGenerationJob HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string",
"tags": {
"string" : "string"
},
"template": "string",
"worldCount": {
"floorplanCount": number,
"interiorCountPerFloorplan": number
},
"worldTags": {
"string" : "string"
}
}URI请求参数
该请求不使用任何URI参数。
请求正文
该请求接受以下JSON格式的数据。
- clientRequestToken
-
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
类型：字符串
长度限制：长度下限为 1。长度上限为 64。
模式：
[a-zA-Z0-9_\-=]*必需：否
-
包含附加到世界生成器作业的标签键和标签值的映射。
类型：字符串到字符串映射
映射条目：最低 0 项。最多 50 项。
密钥长度限制：最小长度为 1。长度上限为 128。
键模式：
[a-zA-Z0-9 _.\-\/+=:]*值长度限制：最小长度为 0。最大长度为 256。
价值模式：
[a-zA-Z0-9 _.\-\/+=:]*必需：否
- template
-
描述您要创建的世界模板的 Amazon 资源名称（arn）。
类型：字符串
长度限制：长度下限为 1。最大长度为 1224。
模式：
arn:.*必需：是
- worldCount
-
有关世界计数的信息。
类型：WorldCount 对象
必需：是
- worldTags
-
包含附加到生成器作业的标签键和标签值的映射。
类型：字符串到字符串映射
映射条目：最低 0 项。最多 50 项。
密钥长度限制：最小长度为 1。长度上限为 128。
键模式：
[a-zA-Z0-9 _.\-\/+=:]*值长度限制：最小长度为 0。最大长度为 256。
价值模式：
[a-zA-Z0-9 _.\-\/+=:]*必需：否
响应语法
HTTP/1.1 200
Content-type: application/json
{
"arn": "string",
"clientRequestToken": "string",
"createdAt": number,
"failureCode": "string",
"status": "string",
"tags": {
"string" : "string"
},
"template": "string",
"worldCount": {
"floorplanCount": number,
"interiorCountPerFloorplan": number
},
"worldTags": {
"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
-
请求输入参数无效。
类型：字符串
有效值：
InternalServiceError | LimitExceeded | ResourceNotFound | RequestThrottled | InvalidInput | AllWorldGenerationFailed - status
-
世界生成器作业的状态。
- 待处理
-
世界生成器作业请求待处理。
- Running
-
世界生成器作业正在运行。
- 已完成
-
世界生成器作业已完成。
- 失败
-
世界生成器作业失败。请参阅
failureCode了解更多信息。 - PartialFailed
-
有些世界没有生成。
- 已取消
-
世界生成器作业已取消。
- 正在取消
-
世界生成器作业正在取消。
类型：字符串
有效值：
Pending | Running | Completed | Failed | PartialFailed | Canceling | Canceled -
包含附加到世界生成器作业的标签键和标签值的映射。
类型：字符串到字符串映射
映射条目：最低 0 项。最多 50 项。
密钥长度限制：最小长度为 1。长度上限为 128。
键模式：
[a-zA-Z0-9 _.\-\/+=:]*值长度限制：最小长度为 0。最大长度为 256。
价值模式：
[a-zA-Z0-9 _.\-\/+=:]* - template
-
世界模板的 Amazon 资源名称（ARN）。
类型：字符串
长度限制：长度下限为 1。最大长度为 1224。
模式：
arn:.* - worldCount
-
有关世界计数的信息。
类型：WorldCount 对象
- worldTags
-
包含附加到生成器作业的标签键和标签值的映射。
类型：字符串到字符串映射
映射条目：最低 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
- LimitExceededException
-
请求的资源超过了允许的最大数量，或者并发流请求的数量超过了允许的最大数量。
HTTP状态码：400
- ResourceNotFoundException
-
指定的资源不存在。
HTTP状态码：400
- ServiceUnavailableException
-
由于服务器发生临时故障而导致请求失败。
HTTP状态码：503
- ThrottlingException
-
AWS RoboMaker 暂时无法处理请求。重新尝试您的调用。
HTTP状态码：400
另请参阅
有关API在一种特定语言中使用此功能的更多信息 AWS SDKs，请参阅以下内容：
