全部产品
云市场

UpdateTemplate

更新时间:2019-07-19 19:37:48

更新一个已经存在的模板。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateTemplate 系统规定参数。取值:UpdateTemplate
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。

返回参数

名称 类型 示例值 描述
RequestId String 14A07460-EBE7-47CA-9757-12CC4761D47A 请求 ID。
Template 模板元信息。
└ CreatedBy String root(130920000) 模板创建者。
└ CreatedDate String 2019-05-16T10:26:14Z 模板创建时间。
└ UpdatedBy String root(1309000) 模板更新者。
└ UpdatedDate String 2019-05-16T10:26:14Z 模板更新时间。
└ Description String Describe instances of given status 模板说明。
└ Hash String 4bc7d7a21b3e003434b9c223f6e6d2578b5ebfeb5be28c1fcf8a8a1b11907bb4 模板内容的SHA256。
└ ShareType String Private 模板共享类型。目前用户创建的模板的共享类型均为 Private。
└ TemplateFormat String JSON 模板格式。系统字段判断,为JSON或YAML。
└ TemplateName String MyTemplate 模板名称。
└ TemplateId String t-94753deed38 模板ID。
└ TemplateVersion String v2 模板版本。以“v”+数字的形式,数字从1开始。

示例

请求示例

  1. https://oos.cn-hangzhou.aliyuncs.com/?Action=UpdateTemplate
  2. &TemplateName=MyTemplate
  3. &Content=%7B%22FormatVersion%22%3A+%22OOS-2019-06-01%22%2C+%22Description%22%3A+%22Describe+instances+of+given+status%22%2C+%22Parameters%22%3A+%7B%22Status%22%3A+%7B%22Type%22%3A+%22String%22%2C+%22Description%22%3A+%22%28Required%29+The+status+of+the+Ecs+instance.%22%7D%7D%2C+%22Tasks%22%3A+%5B%7B%22Properties%22%3A+%7B%22Parameters%22%3A+%7B%22Status%22%3A+%22%7B%7B+Status+%7D%7D%22%7D%2C+%22API%22%3A+%22DescribeInstances%22%2C+%22Service%22%3A+%22ECS%22%7D%2C+%22Name%22%3A+%22describeInstances%22%2C+%22Action%22%3A+%22ACS%3A%3AExecuteAPI%22%7D%5D%7D
  4. &<公共请求参数>

正常返回示例
JSON 格式

  1. {
  2. "RequestId": "2075899A-585D-4A41-A9B2-28DF4F534F",
  3. "Template": {
  4. "CreatedBy": "root(13090000)",
  5. "CreatedDate": "2019-05-27T08:46:33Z",
  6. "UpdatedBy": "root(13090000)",
  7. "UpdatedDate": "2019-05-27T08:46:33Z",
  8. "Description": "Describe instances of given status",
  9. "Hash": "4bc7d7a21b3e003434b9c223f6e6d2578b5ebfeb5be28c1fcf8a8a1b11907bb4",
  10. "ShareType": "Private",
  11. "TemplateFormat": "JSON",
  12. "TemplateName": "MyTemplate",
  13. "TemplateId": "t-94753de38",
  14. "TemplateVersion": "v2"
  15. }
  16. }

错误码

错误代码 HTTP 状态码 错误信息 描述
InvalidVersion 400 Specified parameter Version is not valid. 给定的Version非法。请检查URL中指定的Version的正确性。
InvalidAction.NotFound 400 Specified api is not found, please check your url and method. 给定的API不存在。请检查URL中指定的Action的正确性。
Throttling.User 400 Request was denied due to user flow control. 访问频率太高导致流控。
User.NoPermission 401 User has no permission to do the action: ({api_name}) 用户没有调用某个API的权限。请检查是否在RAM中给当前用户赋予了OOS的API的权限。
InvalidStsToken 400 Invalid STS token to do the action: ({api_name}) 给定的STS Token非法。
ExpiredStsToken 400 Expired STS token to do the action: ({api_name}) 给定的STS Token过期。
QuotaExceed 403 The Quota ({key}) exceeded ({value}). 特定属性(如模板数量、正在运行的执行数等)超过上限。
InvalidAccountType 400 The account type ({account_type}) was not supported. 不支持给定的账号类型。
TemplateValidationError 400 {reason} 模板约束,如参数类型、数值等,校验不通过。
EntityNotExists.Template 404 The specified template {name} does not exist. 模板不存在。
TemplateUpdateFailed 403 The template {name} update failed due to concurrence. Please try again. 模板因并发更新失败。