查询模板列表
功能介绍
查询弹性云服务器模板列表,迁移时选择“新建服务器”时可使用该模板创建弹性云服务器。
URI
GET /v3/vm/templates
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
否 |
String |
模板名称 最小长度:0 最大长度:255 |
availability_zone |
否 |
String |
可用区 最小长度:0 最大长度:255 |
region |
否 |
String |
Region ID 最小长度:0 最大长度:255 |
limit |
否 |
Integer |
分页大小,不传值默认为50 最小值:0 最大值:100 缺省值:50 |
offset |
否 |
Integer |
偏移量,不传值默认为0 最小值:0 最大值:65535 缺省值:0 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
X-Auth-Token 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 最小长度:1 最大长度:16384 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
count |
Integer |
模板个数 最小值:0 最大值:65535 |
templates |
Array of TemplateResponse objects |
模板信息 |
参数 |
参数类型 |
描述 |
---|---|---|
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_zone |
String |
可用区 最小长度:0 最大长度:255 |
volumetype |
String |
磁盘类型 枚举值:
|
flavor |
String |
虚拟机规格 最小长度:0 最大长度:255 |
vpc |
VpcObject object |
vpc对象 |
nics |
Array of Nics objects |
网卡信息,支持多个网卡,如果是自动创建,只填一个,id使用“autoCreate” |
security_groups |
Array of SgObject objects |
安全组,支持多个安全组,如果是自动创建,只填一个,id使用“autoCreate” |
publicip |
PublicIp object |
公网ip |
disk |
Array of TemplateDisk objects |
磁盘信息 |
data_volume_type |
String |
数据盘磁盘类型 枚举值:
|
target_password |
String |
目的端密码 最小长度:0 最大长度:1024 |
参数 |
参数类型 |
描述 |
---|---|---|
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 |
请求示例
查询模板列表
GET https://{endpoint}/v3/vm/templates
响应示例
状态码: 200
OK
{ "count" : 9, "templates" : [ { "id" : "3db302e8-95de-478c-a892-8a083f2d269b", "name" : "test", "region" : "region", "availability_zone" : "availability_zone", "projectid" : "c6e3047501b340a4a79fb94dad453676", "flavor" : "s2.large.2", "volumetype" : "", "vpc" : { "id" : "4d329f4b-70ee-4996-ba9a-5b5ec63a7c2e", "name" : "vpc-dfdb" }, "nics" : [ { "id" : "d807e702-a59a-480c-aa5e-23449775d107", "name" : "subnet-dfdb(192.168.1.0/24)", "cidr" : "192.168.1.0/24", "ip" : "" } ], "security_groups" : [ { "id" : "c922bce4-1892-44bc-a58e-f250a666939a", "name" : "default(Inbound:tcp/8900,8899,3389,22; Outbound:--)" } ] }, { "id" : "708847ae-f013-4b1a-8ea8-6cfa1e94237d", "name" : "test1", "region" : "region", "availability_zone" : "availability_zone", "projectid" : "05a6d0f34380269c2f02c016826878ea", "flavor" : "s6.large.2", "volumetype" : "", "vpc" : { "id" : "ee756d79-6223-464b-a3f4-a1e048309fdb", "name" : "vpc-13d6" }, "nics" : [ { "id" : "768b0328-7b01-4d34-9afc-03e88025ff05", "name" : "subnet-13d6(192.168.1.0/24)", "cidr" : "192.168.1.0/24", "ip" : "" } ], "security_groups" : [ { "id" : "bf736dd6-7e7e-42ba-a1d3-b3a9f6a5fda5", "name" : "sms-1568190885(Inbound:tcp/8900,8899,3389; Outbound:--)" } ] }, { "id" : "6874cb49-48bb-4875-975d-4bca464d8472", "name" : "test2", "region" : "region", "availability_zone" : "availability_zone", "projectid" : "353b5ccc3deb4abc8ac8291bf468f69c", "flavor" : "s2.large.2", "volumetype" : "", "vpc" : { "id" : "a1f9de64-bf00-4c4f-8c97-ebc65f9e1e2e", "name" : "vpc-testcloud(192.168.0.0/16)" }, "nics" : [ { "id" : "04ba310f-34df-4df3-9385-11552aafff03", "name" : "subnet-testcloud(192.168.0.0/24)", "cidr" : "192.168.0.0/24", "ip" : "" } ], "security_groups" : [ ] }, { "id" : "76b8b2b2-b730-4000-b0a3-048f80105dd2", "name" : "fdff", "region" : "region", "availability_zone" : "availability_zone", "projectid" : "00924d0ad2df4f21ac476dd9f32888f1", "flavor" : "s2.large.2", "volumetype" : "", "vpc" : { "id" : "d6f34811-1a4d-4686-911a-982c8e2c1f1b", "name" : "vpc-migration(192.168.0.0/16)" }, "nics" : [ { "id" : "85ca07d5-7d0d-40ce-b1b2-9dd2db14f840", "name" : "subnet-cf42(192.168.5.0/24)", "cidr" : "192.168.5.0/24", "ip" : "" } ], "security_groups" : [ { "id" : "a563735f-4183-40de-854f-5ba2cb26496d", "name" : "sg-smt-test(Inbound:tcp/3389,8899,22,8900; Outbound:--)" } ] }, { "id" : "382f66f9-b948-4bee-b2a8-50b9d3461c81", "name" : "test3", "region" : "region", "availability_zone" : "availability_zone", "projectid" : "00924d0ad2df4f21ac476dd9f32888f1", "flavor" : "s2.medium.2", "volumetype" : "", "vpc" : { }, "nics" : [ ], "security_groups" : [ ] }, { "id" : "b3c49d20-720a-486f-9d61-b56e6b5bca39", "name" : "test_linux_childproj", "region" : "region", "availability_zone" : "availability_zone", "projectid" : "062b8cb8ec8010dc2f42c0167c4631f9", "flavor" : "s2.small.1", "volumetype" : "SATA", "vpc" : { "id" : "b09cebfb-6887-4c58-a353-008dae644f6e", "name" : "sms-1567992634(192.168.0.0/16)" }, "nics" : [ { "id" : "34688a59-2fd9-422d-a373-87460ef60014", "name" : "sms-1567992646(192.168.0.0/16)", "cidr" : "192.168.0.0/16", "ip" : "" } ], "security_groups" : [ { "id" : "079febf0-cfd2-4722-82d6-a518ea65cd67", "name" : "sg-7e50(Inbound:tcp/8900,8899,3389,22; Outbound:--)" } ] }, { "id" : "bda09f7f-3b0c-4bb5-a1ad-3a4d62024774", "name" : "12212", "region" : "region", "availability_zone" : "availability_zone", "projectid" : "2c0689c860ad4728a497c91ec0844383", "flavor" : "s2.large.2", "volumetype" : "", "vpc" : { "id" : "4490ab3f-5f0c-42e9-97b7-8b3bc0541e70", "name" : "vpc-migration(192.168.0.0/16)" }, "nics" : [ { "id" : "350a355b-53db-4e58-80fc-56841ab55021", "name" : "subnet-migration(192.168.1.0/24)", "cidr" : "192.168.1.0/24", "ip" : "" } ], "security_groups" : [ { "id" : "410f9e21-1085-41b8-b5f7-0da0089be8e3", "name" : "SMT-Windows(Inbound:tcp/8443,8899,8900,22,3389;icmp; Outbound:--)" } ] }, { "id" : "7d0b56ff-f9c7-478d-9017-120bbdf4b363", "name" : "test4", "region" : "region", "availability_zone" : "availability_zone", "projectid" : "00924d0ad2df4f21ac476dd9f32888f1", "flavor" : "s2.medium.2", "volumetype" : "SATA", "vpc" : { }, "nics" : [ ], "security_groups" : [ ] }, { "id" : "ec4ac7de-dba1-4602-b327-c228243651db", "name" : "dddd", "region" : "region", "availability_zone" : "availability_zone", "projectid" : "2c0689c860ad4728a497c91ec0844383", "flavor" : "s2.large.2", "volumetype" : "", "vpc" : { "id" : "00cda768-ef7b-40ac-a555-84b0c2b85d89", "name" : "sms-1566979232(192.168.0.0/16)" }, "nics" : [ { "id" : "b5891372-f48c-4b3c-9f7a-ab58da5baa93", "name" : "sms-1566979244(192.168.0.0/16)", "cidr" : "192.168.0.0/16", "ip" : "" } ], "security_groups" : [ ] } ] }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
错误码
请参见错误码。