获取云机分组树
获取云机分组树结构。
接口地址:
text
/papi/container/group-tree请求方式:
text
POST请求数据类型:
text
application/jsonHeader 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-Access-Key | string | 是 | API 访问密钥 ID,鉴权方式见 接口规则 |
| X-Signature | string | 是 | 签名值,Base64 编码的 HMAC-SHA256 计算结果 |
| X-Timestamp | string | 是 | 毫秒级 Unix 时间戳(13 位) |
| X-Nonce | string | 是 | 随机字符串,10~32 位小写字母+数字 |
Body 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sortType | integer | 否 | 排序类型,枚举:1-设备名称升序,2-设备名称降序,3-设备时长升序,4-设备时长降序 |
请求示例:
json
{
"sortType": 1
}响应参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 错误码,参见 错误码说明 |
| data | array[object] | 返回数据,分组树列表 |
| ├─ name | string | 分组名称 |
| ├─ sort | integer | 显示顺序 |
| ├─ sid | string | 分组ID |
| ├─ systemFlag | boolean | 是否系统默认分组 |
| ├─ containerCount | integer | 容器数量 |
| ├─ containers | array[object] | 分组下的容器列表 |
| ├─├─ ctrId | string | 容器标识 |
| ├─├─ remark | string | 备注 |
| ├─├─ status | integer | 状态 |
| ├─├─ name | string | 容器名 |
| ├─├─ expire | integer | 授权到期时间 |
| ├─├─ ctrNameId | string | Id 业务Id,跟云机资源的ctr_alias相同 |
| ├─├─ ctrName | string | 容器名称 |
| ├─├─ ctrRemark | string | 容器备注名 |
| ├─├─ androidVersion | string | 安卓版本 |
| ├─├─ os | integer | 云机OS |
| ├─├─ skuCode | string | sku编号 |
| ├─├─ skuName | string | sku名称 |
| ├─├─ aliasCode | string | 别名编码 |
| ├─├─ multiple | number | 兑换倍数 |
| ├─├─ level | integer | 等级 |
| ├─├─ packageCode | string | 套餐编码 |
| ├─├─ sign | string | 签名 |
| ├─├─ screenshotServiceUrl | string | 截图服务地址 |
| ├─├─ dest | string | 设备IP加密字符串 |
| ├─├─ ctrAlias | string | 容器别名 |
| ├─├─ topFlag | boolean | 是否置顶 |
| ├─├─ operateFlag | boolean | 是否资源表容器,只有资源表的才有操作权限 |
| ├─├─ authType | integer | 授权类型,0-普通,1-已授权,2-被授权 |
| msg | string | 错误提示 |
响应示例:
json
{
"code": 0,
"data": [
{
"name": "默认分组",
"sort": 0,
"sid": "group-sid-xxx",
"systemFlag": true,
"containerCount": 2,
"containers": [
{
"ctrId": "ctr-xxx",
"remark": "备注",
"status": 7,
"name": "测试云机-01",
"expire": 1735689600000,
"ctrNameId": "22d6sr1gii",
"ctrName": "测试云机-01",
"ctrRemark": "云机备注",
"androidVersion": "Android 12",
"os": 12,
"skuCode": "standard",
"skuName": "标准版",
"aliasCode": "std",
"multiple": 1.0,
"level": 1,
"packageCode": "pkg-xxx",
"sign": "sign-xxx",
"screenshotServiceUrl": "https://screenshot.example.com",
"dest": "encrypted-xxx",
"ctrAlias": "22d6sr1gii",
"topFlag": false,
"operateFlag": true,
"authType": 0
}
]
}
],
"msg": "success"
}