删除模板
功能介绍
删除模板(DeleteTemplate)
此API用于删除某个模板以及模板下的全部模板版本
请谨慎操作,删除模板将会删除模板下的所有模板版本。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
DELETE /v1/{project_id}/templates/{template_name}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID,可以从调用API处获取,也可以从控制台获取。 最小长度:3 最大长度:64 |
| template_name | 是 | String | 模板(Template)的名字。此名字在domain_id+region下应唯一,可以使用中文、大小写英文、数字、下划线、中划线。首字符需为中文或者英文,区分大小写。 最小长度:1 最大长度:128 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| template_id | 否 | String | 模板的ID。当template_id存在时,模板服务会检查template_id是否和template_name匹配,不匹配会返回400 最小长度:36 最大长度:36 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Client-Request-Id | 是 | String | 用户指定的,对于此请求的唯一ID,用于定位某个请求,推荐使用UUID 最小长度:36 最大长度:128 |
响应参数
状态码:204
删除成功,无数据返回
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误描述 |
| encoded_authorization_message | String | 包含有关未经授权请求的信息。 |
| details | Array of Detail objects | 权限拒绝时服务返回的详细错误信息。 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误描述 |
| encoded_authorization_message | String | 包含有关未经授权请求的信息。 |
| details | Array of Detail objects | 权限拒绝时服务返回的详细错误信息。 |
状态码:403
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误描述 |
| encoded_authorization_message | String | 包含有关未经授权请求的信息。 |
| details | Array of Detail objects | 权限拒绝时服务返回的详细错误信息。 |
状态码:404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误描述 |
| encoded_authorization_message | String | 包含有关未经授权请求的信息。 |
| details | Array of Detail objects | 权限拒绝时服务返回的详细错误信息。 |
状态码:429
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误描述 |
| encoded_authorization_message | String | 包含有关未经授权请求的信息。 |
| details | Array of Detail objects | 权限拒绝时服务返回的详细错误信息。 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误描述 |
| encoded_authorization_message | String | 包含有关未经授权请求的信息。 |
| details | Array of Detail objects | 权限拒绝时服务返回的详细错误信息。 |
请求示例
响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 204 | 删除成功,无数据返回 |
| 400 | 用户请求非法 |
| 401 | 用户身份认证失败 |
| 403 | 用户无权限调用此API |
| 404 | 模板不存在 |
| 429 | 请求数量过多 |
| 500 | 服务器内部错误 |