获得云机群控列表
获取云机群控列表。
接口地址:
text
/papi/container/containerList请求方式:
text
POSTHeader 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-Access-Key | string | 是 | API 访问密钥 ID,鉴权方式见 接口规则 |
| X-Signature | string | 是 | 签名值,Base64 编码的 HMAC-SHA256 计算结果 |
| X-Timestamp | string | 是 | 毫秒级 Unix 时间戳(13 位) |
| X-Nonce | string | 是 | 随机字符串,10~32 位小写字母+数字 |
Body 参数:
无请求体参数。
响应参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 错误码,参见 错误码说明 |
| data | array[object] | 返回数据 |
| ├─ alias | string | 别名 |
| ├─ signalServerUrl | string | 信令服务器URL |
| ├─ spareSignal | string | 备用信令 |
| ├─ roomId | string | 房间ID |
| ├─ turnServerUri | string | TURN服务器URI |
| ├─ isControl | boolean | 是否控制 |
| ├─ token | string | 认证令牌 |
| ├─ hostTurn | array[string] | 主中继 |
| ├─ spareTurn | array[string] | 备用中继 |
| ├─ expires | integer | 过期时间 |
| ├─ sign | string | 签名 |
| ├─ ctrAlias | string | 别名 |
| ├─ groupName | string | 分组名称 |
| ├─ ctrIp | string | IP |
| ├─ ctrId | string | 容器ID |
| ├─ ctrName | string | 云机名称 |
| ├─ ctrRemark | string | 云机备注 |
| ├─ screenshotServiceUrl | string | 截图服务地址 |
| ├─ dest | string | 设备IP加密字符串 |
| ├─ ossServiceApiUrl | string | OSS服务端API地址 |
| ├─ status | integer | 云机状态 |
| msg | string | 错误提示 |
响应示例:
json
{
"code": 0,
"data": [
{
"alias": "22d6sr1gii",
"signalServerUrl": "https://signal.example.com",
"spareSignal": "https://spare-signal.example.com",
"roomId": "room-xxx",
"turnServerUri": "turn:turn.example.com:3478",
"isControl": true,
"token": "token-xxx",
"hostTurn": [
"turn:host1.example.com:3478"
],
"spareTurn": [
"turn:spare1.example.com:3478"
],
"expires": 1735689600000,
"sign": "sign-xxx",
"ctrAlias": "22d6sr1gii",
"groupName": "默认分组",
"ctrIp": "192.168.1.100",
"ctrId": "ctr-xxx",
"ctrName": "测试云机-01",
"ctrRemark": "云机备注",
"screenshotServiceUrl": "https://screenshot.example.com",
"dest": "encrypted-xxx",
"ossServiceApiUrl": "https://oss.example.com",
"status": 7
}
],
"msg": "success"
}