本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateWorldTemplate
创建世界模板。
请求语法
POST /createWorldTemplate HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string",
"name": "string",
"tags": {
"string" : "string"
},
"templateBody": "string",
"templateLocation": {
"s3Bucket": "string",
"s3Key": "string"
}
}URI 请求参数
该请求不使用任何 URI 参数。
请求体
请求接受采用 JSON 格式的以下数据。
- clientRequestToken
-
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
类型：字符串
长度限制：长度下限为 1。长度上限为 64。
模式：
[a-zA-Z0-9_\-=]*必需：否
- name
-
世界模板名称。
类型：字符串
长度约束：最小长度为 0。最大长度为 255。
模式：
.*必需：否
-
包含附加到世界模板的标签键和标签值的映射。
类型：字符串到字符串映射
映射条目：最低 0 项。最多 50 项。
密钥长度限制：最小长度为 1。长度上限为 128。
键模式：
[a-zA-Z0-9 _.\-\/+=:]*值长度限制：最小长度为 0。最大长度为 256。
价值模式：
[a-zA-Z0-9 _.\-\/+=:]*必需：否
- templateBody
-
世界模板正文。
类型：字符串
长度限制：长度下限为 1。长度上限为 262144。
模式：
[\S\s]+必需：否
- templateLocation
-
世界模板的位置。
类型：TemplateLocation 对象
必需：否
响应语法
HTTP/1.1 200
Content-type: application/json
{
"arn": "string",
"clientRequestToken": "string",
"createdAt": number,
"name": "string",
"tags": {
"string" : "string"
}
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- arn
-
世界模板的 Amazon 资源名称（ARN）。
类型：字符串
长度限制：长度下限为 1。最大长度为 1224。
模式：
arn:.* - clientRequestToken
-
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
类型：字符串
长度限制：长度下限为 1。长度上限为 64。
模式：
[a-zA-Z0-9_\-=]* - createdAt
-
创建世界模板的时间，用从纪元开始的毫秒数表示。
类型：时间戳
- name
-
世界模板名称。
类型：字符串
长度约束：最小长度为 0。最大长度为 255。
模式：
.* -
包含附加到世界模板的标签键和标签值的映射。
类型：字符串到字符串映射
映射条目：最低 0 项。最多 50 项。
密钥长度限制：最小长度为 1。长度上限为 128。
键模式：
[a-zA-Z0-9 _.\-\/+=:]*值长度限制：最小长度为 0。最大长度为 256。
价值模式：
[a-zA-Z0-9 _.\-\/+=:]*
错误
有关所有操作的常见错误信息，请参阅常见错误。
- InternalServerException
-
AWS RoboMaker 遇到了服务问题。重新尝试您的调用。
HTTP 状态代码：500
- InvalidParameterException
-
在请求中指定的参数无效、不受支持，或无法使用。请求的消息解释错误值。
HTTP 状态代码：400
- LimitExceededException
-
请求的资源超过了允许的最大数量，或者并发流请求的数量超过了允许的最大数量。
HTTP 状态代码：400
- ResourceAlreadyExistsException
-
指定资源已经存在。
HTTP 状态代码：400
- ResourceNotFoundException
-
指定的资源不存在。
HTTP 状态代码：400
- ThrottlingException
-
AW RoboMaker S 暂时无法处理该请求。重新尝试您的调用。
HTTP 状态代码：400
另请参阅
有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：
