修改模板信息
功能介绍
修改源端模板信息。
调用方法
请参见如何调用API。
URI
PUT /v3/vm/templates/{id}
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
id | 是 | String | 需要修改信息的模板的ID 最小长度：0 最大长度：255 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | X-Auth-Token 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度：1 最大长度：16384 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
template | 否 | TemplateRequest object | 模板信息 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
name | 是 | String | 模板名称 最小长度：0 最大长度：255 |
is_template | 是 | Boolean | 是否是通用模板，如果模板关联一个任务，则不算通用模板 |
region | 是 | String | Region信息 最小长度：0 最大长度：255 |
projectid | 是 | String | 项目ID 最小长度：0 最大长度：255 |
target_server_name | 否 | String | 目标端服务器名称 最小长度：0 最大长度：255 |
availability_zone | 否 | String | 可用区 最小长度：0 最大长度：255 |
volumetype | 否 | String | 磁盘类型 SAS:串行连接SCSI SSD:固态硬盘 SATA:串口硬盘 枚举值：
|
flavor | 否 | String | 虚拟机规格 最小长度：0 最大长度：65535 |
vpc | 否 | VpcObject object | vpc对象 |
nics | 否 | Array of Nics objects | 网卡信息，支持多个网卡，如果是自动创建，只填一个，ID使用“autoCreate” 数组长度：0 - 65535 |
security_groups | 否 | Array of SgObject objects | 安全组，支持多个安全组，如果是自动创建，只填一个，ID使用“autoCreate” 数组长度：0 - 65535 |
publicip | 否 | PublicIp object | 公网ip |
disk | 否 | Array of TemplateDisk objects | 磁盘信息 数组长度：0 - 65535 |
data_volume_type | 否 | String | 数据盘磁盘类型 SAS:串行连接SCSI SSD:固态硬盘 SATA:串口硬盘 枚举值：
|
target_password | 否 | String | 目的端密码 最小长度：0 最大长度：1024 |
image_id | 否 | String | 新建目的虚拟机用户选择的镜像版本Id值 最小长度：0 最大长度：255 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
id | 是 | String | 虚拟私有云ID，如果是自动创建，填“autoCreate” 最小长度：1 最大长度：255 |
name | 是 | String | 虚拟私有云名称 最小长度：1 最大长度：255 |
cidr | 否 | String | VPC的网段，默认192.168.0.0/16 最小长度：1 最大长度：255 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
id | 是 | String | 子网ID，如果是自动创建，使用"autoCreate" 最小长度：0 最大长度：255 |
name | 是 | String | 子网名称 最小长度：0 最大长度：255 |
cidr | 是 | String | 子网网关/掩码 最小长度：0 最大长度：255 |
ip | 否 | String | 虚拟机IP地址，如果没有这个字段，自动分配IP 最小长度：0 最大长度：255 |
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
- | String | 修改模板信息 |
状态码：403
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误代码 最小长度：0 最大长度：255 |
error_msg | String | 错误信息 最小长度：0 最大长度：255 |
encoded_authorization_message | String | 加密授权信息 最小长度：0 最大长度：65535 |
error_param | Array of strings | 错误参数 最小长度：0 最大长度：65535 数组长度：1 - 20 |
details | Array of details objects | 详细错误信息 数组长度：1 - 20 |
请求示例
修改源端模板信息，修改ID为dfbdd142-985f-4a4f-93e1-c535b46bxxxx的模板的模板名称为test1025，projectid为00924d0ad2df4f21ac476dd9f3288xxxx
PUT https://{endpoint}/v3/vm/templates/dfbdd142-985f-4a4f-93e1-c535b46bxxxx
{
"template" : {
"name" : "test1025",
"is_template" : false,
"region" : "region",
"projectid" : "xxxxxxxxxxxxxxxxxxxxxxxx00000001",
"vpc" : {
"id" : "autoCreate",
"name" : "autoCreate"
},
"nics" : [ {
"id" : "autoCreate",
"name" : "autoCreate",
"cidr" : "192.168.0.0/24"
} ],
"security_groups" : [ {
"id" : "autoCreate",
"name" : "autoCreate"
} ],
"publicip" : {
"type" : "5_bgp",
"bandwidth_size" : 1
},
"disk" : [ {
"index" : 0,
"name" : "index1",
"disktype" : "type",
"size" : 111
} ]
}
} 响应示例
状态码：403
鉴权失败
{
"error_code" : "SMS.9004",
"error_msg" : "The current account does not have the permission to execute policy You do not have permission to perform action XXX on resource XXX.",
"encoded_authorization_message" : "XXXXXX",
"error_param" : [ "You do not have permission to perform action XXX on resource XXX." ],
"details" : [ {
"error_code" : "SMS.9004",
"error_msg" : "You do not have permission to perform action XXX on resource XXX."
} ]
} 状态码
状态码 | 描述 |
|---|---|
200 | 修改模板信息 |
403 | 鉴权失败 |
错误码
请参见错误码。
