新增模板信息
功能介绍
新增源端模板信息
URI
POST /v3/vm/templates
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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 |
磁盘类型 枚举值:
|
flavor |
否 |
String |
虚拟机规格 最小长度:0 最大长度:65535 |
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 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
服务端返回的新添加的模板的id 最小长度:0 最大长度:255 |
请求示例
- 创建迁移任务(创建新服务器)时同时添加的模板
POST https://{endpoint}/v3/vm/templates { "template" : { "name" : "", "is_template" : false, "region" : "region", "target_server_name" : "abcd", "availability_zone" : "availability_zone", "volumetype" : "", "vpc" : { "id" : "00cda768-ef7b-40ac-a555-84b0c2b85d89", "name" : "sms-1566979232(192.168.0.0/16)" }, "security_groups" : [ { "id" : "00d57b53-c00b-4d0a-975b-0f3c4fcf93c8", "name" : "kubernetes.io-default-sg(入方向:udp/1-65535;tcp/22,1-65535,3389; 出方向:--)" } ], "nics" : [ { "id" : "b5891372-f48c-4b3c-9f7a-ab58da5baa93", "name" : "sms-1566979244(192.168.0.0/16)", "cidr" : "192.168.0.0/16", "ip" : "" } ], "flavor" : "s2.medium.2", "publicip" : { "type" : "5_bgp", "bandwidth_size" : 5, "bandwidth_share_type" : "PER" }, "disks" : [ { "index" : 0, "name" : "system", "disktype" : "", "size" : 40, "$$hashKey" : "object:3065" } ] } }
- 创建模板的参数
POST https://{endpoint}/v3/vm-templates { "template" : { "name" : "xxxx", "is_template" : true, "region" : "region", "target_server_name" : "ggg-win16-t", "availability_zone" : "availability_zone", "target_password" : "********", "flavor" : "c3.medium.2", "vpc" : { "id" : "e7069fc1-e09e-4ded-8570-6b3bb2a5893b", "name" : "Migrate-SSd-1", "cidr" : "192.168.0.0/16" }, "nics" : [ { "id" : "c5c7d1a2-a204-4cee-8f11-26ac97a50d13", "name" : "Migrate-SSd-35", "cidr" : "192.168.0.0/16", "ip" : "" } ], "security_groups" : [ { "id" : "003ae8fc-066a-45cd-8a9c-995b1def8c26", "name" : "Migrate-dddd" } ], "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 |
错误码
请参见错误码。