调用CreateTemplate创建一个模版。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateTemplate

系统规定参数。取值:CreateTemplate

RegionId String cn-hangzhou

地域ID

TemplateName String MyTemplate

模板名称。内容限制为字母、数字、中划线、下划线,长度200字符,且不能以ALIYUN、ACS、ALIBABA、ALICLOUD开头。

Content String {"FormatVersion": "OOS-2019-06-01", "Description": "Describe instances of given status", "Parameters": {"Status": {"Type": "String", "Description": "(Required) The status of the Ecs instance."}}, "Tasks": [{"Properties": {"Parameters": {"Status": "{{ Status }}"}, "API": "DescribeInstances", "Service": "Ecs"}, "Name": "foo", "Action": "ACS::ExecuteApi"}]}

模板内容。JSON或YAML格式,长度限制为 64 KB。

Tags Map {"k1":"v1","k2":"v2"}

标签键和值列表, 标签键值对数量范围是1至20。

VersionName String v2

版本名称。

ResourceGroupId String rg-acfmxsn4m4******

资源组ID。

返回数据

名称 类型 示例值 描述
TemplateType String Private

模版类型。

RequestId String 20758A-585D-4A41-A9B2-28DA8F4F534F

请求ID

Template Object

模板元信息

Hash String 4bc7d7a21b3e003434b9c223f6e6d2578b5ebfeb5be28c1fcf8a8a1b11907bb4

模板内容的SHA256

UpdatedDate String 2019-05-16T10:26:14Z

模板更新时间

UpdatedBy String root(130900000)

模板更新者

Tags Map

该资源的标签

TemplateName String MyTemplate

模板名称

TemplateVersion String v1

模板版本。以“v”+数字的形式,数字从1开始。

TemplateFormat String JSON

模板格式。系统字段判断,为JSON或YAML。

Description String Describe instances of given status

模板说明

ResourceGroupId String rg-acfmxsn4m4******

资源组ID

CreatedBy String root(13090000)

模板创建者

CreatedDate String 2019-05-16T10:26:14Z

模板创建时间

TemplateId String t-94753d38

模板ID

HasTrigger Boolean true

是否成功触发

ShareType String Private

模板共享类型。目前用户创建的模板的共享类型均为 Private。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateTemplate
&RegionId=cn-hangzhou
&TemplateName=MyTemplate
&Content={"FormatVersion": "OOS-2019-06-01", "Description": "Describe instances of given status", "Parameters": {"Status": {"Type": "String", "Description": "(Required) The status of the Ecs instance."}}, "Tasks": [{"Properties": {"Parameters": {"Status": "{{ Status }}"}, "API": "DescribeInstances", "Service": "Ecs"}, "Name": "foo", "Action": "ACS::ExecuteApi"}]}
&VersionName=v2
&ResourceGroupId=rg-acfmxsn4m4******
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateTemplateResponse>
    <RequestId>20758A-585D-4A41-A9B2-28DA8F4F534F</RequestId>
    <Template>
        <CreatedBy>root(130900000)</CreatedBy>
        <CreatedDate>2019-05-27T08:46:33Z</CreatedDate>
        <UpdatedBy>root(1309000000)</UpdatedBy>
        <UpdatedDate>2019-05-27T08:46:33Z</UpdatedDate>
        <Description>Describe instances of given status</Description>
        <Hash>4bc7d7a21b3e003434b9c223f6e6d2578b5ebfeb5be28c1fcf8a8a1b11907bb4</Hash>
        <ShareType>Private</ShareType>
        <Tags>
            <k1>v1</k1>
            <k2>v2</k2>
        </Tags>
        <ResourceGroupId>rg-acfmxsn4m4******</ResourceGroupId>
        <TemplateFormat>JSON</TemplateFormat>
        <TemplateName>MyTemplate</TemplateName>
        <TemplateId>t-94753eeaef8</TemplateId>
        <TemplateVersion>v1</TemplateVersion>
    </Template>
</CreateTemplateResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "20758A-585D-4A41-A9B2-28DA8F4F534F",
  "Template" : {
    "CreatedBy" : "root(130900000)",
    "CreatedDate" : "2019-05-27T08:46:33Z",
    "UpdatedBy" : "root(1309000000)",
    "UpdatedDate" : "2019-05-27T08:46:33Z",
    "Description" : "Describe instances of given status",
    "Hash" : "4bc7d7a21b3e003434b9c223f6e6d2578b5ebfeb5be28c1fcf8a8a1b11907bb4",
    "ShareType" : "Private",
    "Tags" : {
      "k1" : "v1",
      "k2" : "v2"
    },
    "ResourceGroupId" : "rg-acfmxsn4m4******",
    "TemplateFormat" : "JSON",
    "TemplateName" : "MyTemplate",
    "TemplateId" : "t-94753eeaef8",
    "TemplateVersion" : "v1"
  }
}

错误码

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