数据结构(创建云服务器)-九游平台

id

否

string

待创建云服务器的安全组，会对创建云服务器中配置的网卡生效。需要指定已有安全组的id，uuid格式；若不传id字段，底层会创建默认安全组。

id

否

string

ipv6带宽的id。

resourcespeccode

否

string

磁盘产品资源规格编码，如sata，sas和ssd。

resourcetype

否

string

磁盘产品资源类型。

snapshotid

否

string

整机镜像中自带的原始数据盘（简称“原数据盘”）所对应的快照id或原始数据盘id。

使用场景：

使用整机镜像创建云服务器，并且选择的整机镜像自带1个或者多个数据盘。

使用整机镜像创建云服务器时，系统会自动恢复整机镜像中自带的数据盘（包括数据盘类型和数据）。此时，您可以通过snapshotid，修改指定原数据盘恢复后的磁盘类型。

实现原理：

snapshotid是整机镜像自带原始数据盘的唯一标识，通过snapshotid可以获取原数据盘的磁盘信息，从而恢复数据盘数据。

通过管理控制台获取snapshotid：

登录管理控制台，打开"云硬盘 > 快照"页面，根据原始数据盘的磁盘名称找到对应的快照id或者原始数据盘的id。

通过api查询snapshotid：

chargingmode

否

string

计费模式。

功能说明：付费方式

取值范围：

• prepaid-预付费，即包年包月；
• postpaid-后付费，即按需付费；
• 默认值是postpaid
  说明：

  当chargingmode为prepaid（即创建包年包月付费的云服务器），且使用ssh密钥方式登录云服务器时，metadata中的op_svc_userid字段为必选字段。

  metadata中的op_svc_userid字段的取值，请参见表11。

regionid

否

string

云服务器所在区域id。

请参考获取。

periodtype

否

string

订购周期类型。

取值范围：

• month-月
• year-年
  说明：

  chargingmode为prepaid时生效且为必选值。

periodnum

否

integer

订购周期数。

取值范围：

• periodtype=month（周期类型为月）时，取值为[1，2，3，4，5，6，7，8，9]；
• periodtype=year（周期类型为年）时，取值为[1，2，3]；

isautorenew

否

string

是否自动续订。

• “true”：自动续订
• “false”：不自动续订
  说明：

  chargingmode为prepaid时生效，不传该字段时默认为不自动续订。

isautopay

否

string

下单订购后，是否自动从客户的账户中支付，而不需要客户手动去进行支付。

• “true”：是（自动支付）
• “false”：否（需要客户手动支付）

enterprise_project_id

否

string

企业项目id。

support_auto_recovery

否

boolean

是否配置虚拟机自动恢复的功能。

• “true”：配置该功能
• “false”：不配置该功能

markettype

否

string

创建竞价实例时，需指定该参数的值为“spot”。

spotprice

否

string

用户愿意为竞价云服务器每小时支付的最高价格。

diskprior

否

string

是否支持先创建卷，再创建虚拟机。

• “true”：配置该功能
• “false”：不配置该功能

spot_duration_hours

否

integer

购买的竞价实例时长。

spot_duration_count

否

integer

表示购买的“竞价实例时长”的个数。

interruption_policy

否

string

竞价实例中断策略，当前支持immediate（立即释放）。

cb_csbs_backup

否

string

云备份策略和云备份存储库详情，取值包含备份策略id和云备份存储库id。

例如：在控制台查询备份策略id为：fdcaa27d-5be4-4f61-afe3-09ff79162c04

云备份存储库id为：332a9408-463f-436a-9e92-78dad95d1ac4

则cb_csbs_backup取值为："{\"policy_id\":\"fdcaa27d-5be4-4f61-afe3-09ff79162c04\",\"vault_id\":\"332a9408-463f-436a-9e92-78dad95d1ac4\"}"

__system__encrypted

否

string

metadata中的表示加密功能的字段，0代表不加密，1代表加密。

该字段不存在时，云硬盘默认为不加密。

__system__cmkid

否

string

用户主密钥id，是metadata中的表示加密功能的字段，与__system__encrypted配合使用。

op_svc_userid

否

string

用户id。

您可以在下，通过“api凭证”页面的“iam用户id”，获取该参数的值。更多内容，请参见api凭证。

agency_name

否

string

委托的名称。

委托是由租户管理员在统一身份认证服务（identity and access management，iam）上创建的，可以为弹性云服务器提供访问云服务的临时凭证。

__support_agent_list

否

string

云服务器是否支持主机安全服务、主机监控。

• "ces"：主机监控
• "hss"：主机安全服务基础版
• "hss,hss-ent"：主机安全服务企业版

取值样例：

__support_agent_list:“hss,ces”

可以通过查询镜像详情判断创建云服务器使用的镜像是否支持主机安全服务或主机监控。

group

否

string

云服务器组id，uuid格式。

云服务器组的id可以从控制台或者参考查询云服务器组列表获取。

tenancy

否

string

在指定的专属主机或者共享主机上创建弹性云服务器。

参数值为shared或者dedicated。

dedicated_host_id

否

string

专属主机的id。

group

array of strings

云服务器组id，uuid格式。

云服务器组的id可以从控制台或者参考查询云服务器组列表获取。

tenancy

array of strings

在指定的专属主机或者共享主机上创建弹性云服务器。

参数值为shared或者dedicated。

dedicated_host_id

array of strings

专属主机的id。

key

是

string

键。

最大长度36个unicode字符。key不能为空。不能包含非打印字符ascii(0-31)，"=", "*",“<”,“>”,“\”,“,”,“|”,“/”。

同一资源的key值不能重复。

value

是

string

值。

每个值最大长度43个unicode字符，可以为空字符串。 不能包含非打印字符ascii(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”。