响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "orderNo":"2099XXXXXXXXXXXXXXXX" } } 状态码 请参考 状态码 错误码 请参考 错误码

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 message String 提示信息。 OK. returnObj Object 返回数据结构体。 { } returnObj

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 100054c0416811e9a6690242ac110002

参数 是否必填 参数类型 说明 示例 下级对象 desktopList 是 Array of Objects 云电脑列表，可设置一个或多个，最多 10 个 desktopList

参数 是否必填 参数类型 说明 示例 下级对象 volumeOid 是 String 云硬盘ID desktopOid 是 String 云电脑ID

错误码 请参考 错误码

接口功能介绍 绑定用户 接口约束 无 URI POST /v3/desktop/bindUser 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 pubUserOid 是 String 用户ID upg2lck6loc5swjlg2x6e16e desktopOid 是 String 云电脑ID D0023101301183998 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 message String 提示信息。 OK. returnObj Object 返回数据结构体。 { } returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"pubUserOid":"upgxxx","desktopOid":"XXXXXXXXXXXXX6925"} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{ }} 状态码 请参考 状态码 错误码 请参考 错误码

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002

参数 是否必填 参数类型 说明 示例 下级对象 bandwidthOid 是 String 带宽ID size 是 Integer 带宽大小（单位：Mbps），需大于0 autoPay 否 Boolean 是否自动支付（仅订购类型为包周期的带宽），默认false。取值范围： true:是。（需账号有足够金额） false:否。

接口功能介绍 快照策略功能请联系客户经理开通。 幂等接口，重复取消会忽略并视为取消成功。 注意！若云电脑与快照策略不存在分配关系，取消时会直接忽略。 接口约束 无 URI POST /v3/snapshotPolicy/cancelFromDesktops 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 snapshotPolicyOid 是 String 快照策略ID。 sspgg7576hc59fkph1b3xe4y desktopOidList 是 Array of Strings 云电脑ID列表。长度限制[1,10]。 D0023092201180710 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 ok returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"snapshotPolicyOid":"sspxxx","desktopOidList":["XXXXXXXXXXXXX6925"]}

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002

接口功能介绍 修改部门资源包配额 接口约束 无 URI POST /v3/resourcePack/orgQuota/modify 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 orgOid 是 String 部门ID org18qnu7l41v8fr2xif6jdq cpu 是 Integer 计算包CPU数量（单位：核），至少为0 4 memory 是 Integer 计算包内存数量（单位：GB），至少为0 8 diskSize 是 Integer 存储包空间大小（单位：GB），至少为0 80 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"orgOid":"orgdel","cpu":0,"memory":0,"diskSize":0}

参数 参数类型 说明 示例 下级对象 orderNo String 订单号

状态码 请参考 状态码 错误码 请参考 错误码

状态码 请参考 状态码 错误码 请参考 错误码

枚举参数 无 请求示例 请求url 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "total":1, "list":[{ "fipOid":"fipxxitowt6ljhydytg4lim0", "fipUuid":"f10ee930605a4b35b1975b3f19c0264f", "floatingIpAddress":"10.33.153.188", "bindObjType":"0", "bandName":"bandwidthvlme54p9k0:0", "bandWidth":1, "desktopName":"000000bf53CU9sFN0P", "desktopOid":"D0221011301037475", "ipAddr":"192.168.0.101", "resourcePackOid":"rsp3uyckx0nxry4rp3j3482e", "resourcePackName":"pkgvb3j", "status":1 }] } } 状态码 请参考 状态码 错误码 请参考 错误码

枚举参数 无 请求示例 请求url 请求头header 无 请求体body { "desktopOid":["XXXXXX"], "cycleType":"Month", "cycleCnt":1, "autoPay":true } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "newOrderNo":"20250904114057904770", "submitted":true, "totalPrice":332.0, "newOrderId":"0b5abefafb17480eb8290d7044df5905", "errorMessage":"" } } 状态码 请参考 状态码 错误码 请参考 错误码

参数 是否必填 参数类型 说明 示例 下级对象 natOid 是 String NAT网关ID dnatOid 是 String DNAT规则ID

参数 参数类型 说明 示例 下级对象 operationId String 删除云硬盘快照操作ID，可用于查询操作状态（相关接口：异步操作查询操作详情）。

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

接口功能介绍 云硬盘快照功能请联系客户经理开通。 接口约束 无 URI POST /v3/cloudVolumeSnapshot/modifyAttribute 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 snapshotOid 是 String 云硬盘快照ID snapshotName 是 String 云硬盘快照名称（不能超过64个字符） description 是 String 云硬盘快照描述（不能超过250个字符"） 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body { "snapshotOid":"xxxxxxxxxxx", "snapshotName":"snapshotNameTest", "description":"this is cloud volume snapshot test" } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ } }

参数 参数类型 说明 示例 下级对象 status String 开通状态（Unactivated未开通;Activating开通中;Activated已开通）

参数 参数类型 说明 示例 下级对象 snapshotOid String 云硬盘快照ID XXXXXXXXXXXXX snapshotName String 云硬盘快照名称 volumeOid String 关联的云硬盘ID status String 云硬盘快照状态（CREATING创建中;AVAILABLE可用;CREATEVOLUMEING创建云盘中;REVERTING回滚中;DELETING删除中） createTime String 创建时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。

参数 参数类型 说明 示例 下级对象 submitted Boolean 是否提交成功（仅创建单独付费云硬盘有效）。 errorMessage String 错误信息（仅创建单独付费云硬盘有效）。 newOrderNo String 订单号（仅创建单独付费云硬盘有效）。 newOrderId String 订单id（仅创建单独付费云硬盘有效）。 totalPrice String 总价格（仅创建单独付费云硬盘有效）。 operations Array of Objects 创建云硬盘操作列表。可用于查询操作状态和新建云硬盘ID（相关接口：异步操作查询操作详情）。 operations

参数 参数类型 说明 示例 下级对象 operationId String 操作ID。 type String 操作类型。枚举值范围：Common通用型;Task任务型。

参数 是否必填 参数类型 说明 示例 下级对象 desktopOid 是 String 云电脑ID D0023101301183998

参数 参数类型 说明 示例 下级对象 list Array of Objects 数据列表 list

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002

参数 是否必填 参数类型 说明 示例 下级对象 desktopOid 是 String 云电脑ID D0023101301183998 nickname 是 String 别名（最大长度20，只能包含数字、字母、汉字） xiemushuapi

接口功能介绍 适用于计费方式为资源包、不属于池化桌面池的云电脑。 删除后数据盘的数据将会被销毁，请谨慎操作！ 接口约束 无 URI POST /v3/desktop/deleteDataDisk 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopOid 是 String 云电脑ID D0023091701178069 diskOid 是 String 磁盘ID voln2edc2ayng31wnkc45n9h 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 operation Object 删除云电脑数据盘操作。可用于查询操作状态（相关接口：查询操作列表）。 operation 表 operation 参数 参数类型 说明 示例 下级对象 operationId String 操作ID。 a86890542a526673769ec38a622f55ec type String 操作类型。枚举值范围：Common通用型;Task任务型。 Common

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 message String 提示信息。 OK. returnObj Object 返回数据对象 { } returnObj

参数 参数类型 说明 示例 下级对象 operation Object 创建云电脑数据盘操作。可用于查询操作状态与新建数据盘ID（相关接口：查询操作列表）。 operation