创建实例。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateInstance

系统规定参数。取值:CreateInstance。

ClusterId String gws-xxx

集群 id

ImageId String m-xxx

镜像 id

InstanceType String ecs.g6.large

实例规格,请参见 实例规格族 或调用 DescribeInstanceTypes 获得规格表。

SystemDiskCategory String cloud_ssd

系统盘的种类:

  • cloud_ssd
  • cloud_essd
WorkMode String Desktop

工作模式:

  • Desktop
  • Application
AllocatePublicAddress String true

是否分配公网地址

  • True
  • False
AppList.N.AppArgs String c:/temp.txt
说明 此值仅在 WorkModeDesktop 时有效。

应用的运行参数。

AppList.N.AppName String notepad
说明 此值仅在 WorkModeDesktop 时有效。

应用名称。

AppList.N.AppPath String C:\Windows\System32\notepad.exe
说明 此值仅在 WorkModeDesktop 时有效。

应用的运行路径。

AutoRenew String True

自动续费:

  • False(默认)
  • True
InstanceChargeType String PrePaid

实例付费方式:

  • PostPaid(默认):按量付费
  • PrePaid:包年包月
InternetChargeType String PayByBandwidth
说明 此值只在 AllocatePublicAddresstrue 时有效

网络计费类型。取值范围:

  • PayByTraffic(默认):按使用流量计费
  • PayByBandwidth:按固定带宽计费
InternetMaxBandwidthIn Integer 100
说明 此值只在 AllocatePublicAddresstrue 时有效

公网入带宽最大值,单位为 Mbps

  • 取值范围 1~200
  • 默认值:200
InternetMaxBandwidthOut Integer 100
说明 此值只在 AllocatePublicAddresstrue 时有效

公网出带宽最大值,单位为 Mbps

  • 取值范围 1~200
  • 默认值:200
Name String desktop-xxx

实例名称。

Period Integer 1
说明 此值仅在 InstanceChargeTypePostPaid(包年包月)时有效。

包年包月的时长。

  • PeriodUnitWeek(周)时,取值范围 1~4
  • PeriodUnitMonth(月)时,取值范围 1 2 3 4 5 6 7 8 9 12 24 36 48 60
PeriodUnit String Week
说明 此值仅在 InstanceChargeTypePostPaid(包年包月)时有效。

包年包月的单位。

  • Week
  • Month

返回数据

名称 类型 示例值 描述
InstanceId String i-xxx

实例 id

RequestId String XXXX

请求 id

示例

请求示例


http(s)://[Endpoint]/?Action=CreateInstance
&ClusterId=gws-xxx
&ImageId=m-xxx
&InstanceType=ecs.g6.large
&SystemDiskCategory=cloud_ssd
&WorkMode=Desktop
&<公共请求参数>

正常返回示例

XML 格式

<InstanceId>i-xxx</InstanceId>
<RequestId>XXXX</RequestId>

JSON 格式

{
	"RequestId":"XXXX",
	"InstanceId":"i-xxx"
}

错误码

访问错误中心查看更多错误码。