5.4 模板管理
5.4.2 查询模板列表
"disk" : [ { "id" : "0", "index" : 0, "name" : "Disk 0", "diskType" : "SATA", "size" : 40,
"device_use" : "BOOT"
} ],
"volumetype" : "SATA", "publicip" : {
"type" : "5_g-vm", "bandwidth_size" : 10,
"bandwidth_share_type" : "PER"
} }}
响应示例
状态码： 200 OK
{ "id" : "2bf4344f-8f1f-414e-bb1b-8c2f59ada67f"
}
状态码
状态码 描述
200 OK
错误码
请参见错误码。
5.4.2 查询模板列表
功能介绍
查询弹性云服务器模板列表，迁移时选择“新建服务器”时可使用该模板创建弹性云 服务器。
调试
您可以在API Explorer中调试该接口。
URI
GET /v3/vm/templates
表5-162 Query 参数
参数 是否必选 参数类型 描述
name 否 String 模板名称
最小长度：0 最大长度：255 availability_zo
ne 否 String 可用区
最小长度：0 最大长度：255 region 否 String Region ID
最小长度：0 最大长度：255
limit 否 Integer 分页大小，不传值默认为50
最小值：0 最大值：100 缺省值：50
offset 否 Integer 偏移量，不传值默认为0
最小值：0 最大值：65535 缺省值：0
请求参数
表5-163 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String X-Auth-Token 用户Token。通 过调用IAM服务获取用户Token 接口获取(响应消息头中X-Subject-Token的值)。
最小长度：1 最大长度：16384
响应参数
状态码： 200
表5-164 响应 Body 参数
参数 参数类型 描述
count Integer 模板个数 最小值：0 最大值：65535 templates Array of
TemplateRes ponse objects
模板信息
表5-165 TemplateResponse
参数 参数类型 描述
template TemplateRes ponseBody object
模板信息
表5-166 TemplateResponseBody
参数 参数类型 描述
id String 模板ID
最小长度：0 最大长度：255
name String 模板名称
最小长度：0 最大长度：255
is_template String 是否是通用模板，如果模板关联一个任务，则不 算通用模板
最小长度：0 最大长度：255 region String Region信息
最小长度：0 最大长度：255 projectid String 项目ID
最小长度：0 最大长度：255
参数 参数类型 描述 target_server_
name String 目标端服务器名称
最小长度：0 最大长度：255 availability_zo
ne String 可用区
最小长度：0 最大长度：255 volumetype String 磁盘类型
枚举值：
● SAS
● SSD
● SATA flavor String 虚拟机规格
最小长度：0 最大长度：255
vpc VpcObject
object vpc对象 nics Array of Nics
objects 网卡信息，支持多个网卡，如果是自动创建，只 填一个，id使用“autoCreate”
security_grou
ps Array of SgObject objects
安全组，支持多个安全组，如果是自动创建，只 填一个，id使用“autoCreate”
publicip PublicIp
object 公网ip disk Array of
TemplateDis k objects
磁盘信息
data_volume_
type String 数据盘磁盘类型
枚举值：
● SAS
● SSD
● SATA target_passwo
rd String 目的端密码
最小长度：0 最大长度：1024
表5-167 VpcObject
参数 参数类型 描述
id String 虚拟私有云ID，如果是自动创建，填
“autoCreate”
最小长度：1 最大长度：255
name String 虚拟私有云名称
最小长度：1 最大长度：255
cidr String VPC的网段，默认192.168.0.0/16 最小长度：1
最大长度：255
表5-168 Nics
参数 参数类型 描述
id String 子网ID，如果是自动创建，使用"autoCreate"
最小长度：0 最大长度：255
name String 子网名称
最小长度：0 最大长度：255 cidr String 子网网关/掩码
最小长度：0 最大长度：255
ip String 虚拟机IP地址，如果没有这个字段，自动分配IP 最小长度：0
最大长度：255
表5-169 SgObject
参数 参数类型 描述
id String 安全组ID
最小长度：0 最大长度：255
参数 参数类型 描述
name String 安全组名称
最小长度：0 最大长度：255
表5-170 PublicIp
参数 参数类型 描述
type String 弹性公网IP类型，默认为5_bgp 最小长度：0
最大长度：255 bandwidth_siz
e Integer 带宽大小，单位：Mbit/s
调整带宽时的最小单位会根据带宽范围不同存在 差异。
小于等于300Mbit/s，默认最小单位为1Mbit/s。
300Mbit/s~1000Mbit/s，默认最小单位为 50Mbit/s。大于1000Mbit/s：默认最小单位为 500Mbit/s。
最小值：1 最大值：2000
表5-171 TemplateDisk
参数 参数类型 描述
index Integer 磁盘序号，从0开始 最小值：0
最大值：2147483647
name String 磁盘名称
最小长度：0 最大长度：255
disktype String 磁盘类型，同volumetype字段 最小长度：0
最大长度：255
size Long 磁盘大小，单位：GB
最小值：0
最大值：9223372036854775807