全部产品
Search
文档中心

资源编排:CreateTemplate - 创建自定义模板

更新时间:Feb 22, 2024

创建自定义模板。

接口说明

本文将提供一个示例,在杭州地域cn-hangzhou创建一个名为MyTemplate的模板,并将模板的结构TemplateBody设置为{"ROSTemplateFormatVersion": "2015-09-01"}

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ros:CreateTemplateWrite
  • Template
    acs:ros:{#regionId}:{#accountId}:template/*

请求参数

名称类型必填描述示例值
TemplateURLstring

包含模板主体的文件的位置。URL 必须指向位于 Web 服务器(HTTP 或 HTTPS)或阿里云 OSS 存储空间(例如:oss://ros/stack-policy/demo、oss://ros/stack-policy/demo?RegionId=cn-hangzhou)中的模板。 模板长度范围为 1~1024 字节。 如未指定 OSS 地域,默认与接口参数 RegionId 相同。

说明 您必须且仅能指定 TemplateBody 和 TemplateURL 其中一个参数。
oss://ros/template/demo
Descriptionstring

模板的描述。最大长度为 256 个字符。

It is a demo.
TemplateNamestring

模板的名称。
长度不超过 255 个字符,必须以数字或英文字母开头,可包含数字、英文字母、短划线(-)和下划线(_)。

MyTemplate
ResourceGroupIdstring

资源组 ID。
关于资源组的更多信息,请参见什么是资源组

rg-acfmxazb4ph6aiy****
Tagsobject []

模板的标签。

Keystring

模板的标签键。

说明 Tags 为可选参数。如果需要指定 Tags,则 Tags.N.Key 必须指定。
usage
Valuestring

模板的标签值。

test

关于公共请求参数的详情,请参见公共参数

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

8C5D90E1-66B6-496C-9371-3807F8DA80A8
TemplateIdstring

模板 ID。

5ecd1e10-b0e9-4389-a565-e4c15efc****

示例

正常返回示例

JSON格式

{
  "RequestId": "8C5D90E1-66B6-496C-9371-3807F8DA80A8",
  "TemplateId": "5ecd1e10-b0e9-4389-a565-e4c15efc****"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-01-12API 内部配置变更,不影响调用看变更集
变更项变更内容
API 内部配置变更,不影响调用
2022-10-27OpenAPI 入参发生变更看变更集
变更项变更内容
入参OpenAPI 入参发生变更
    新增入参:Tags
HttpCode错误码错误信息描述
400InvalidSchema{reason}.模板格式不正确。reason 为具体原因。
400InvalidTemplateAttributeThe Referenced Attribute ({resource} {name}) is incorrect.模板包含不正确的资源属性(输出)引用。resource 为资源名,name 为属性名。
400InvalidTemplatePropertyTypeThe specified value type of ({resource} {section}) is incorrect.模板资源定义中的字段类型不正确。resource 为资源名,section 为字段名。
400InvalidTemplateReferenceThe specified reference "{name}" (in {referencer}) is incorrect.模板包含不正确的引用。name 为引用名,referencer 为引用者。
400InvalidTemplateSectionThe template section is invalid: {section}.模板包含无效的字段。section 为字段名。
400InvalidTemplateVersionThe template version is invalid: {reason}.模板版本不正确。reason 为具体原因。