Skip to content

获得云机群控列表 ​

获取云机群控列表。

接口地址:

text
/papi/container/containerList

请求方式:

text
POST

Header 参数:

参数类型必填说明
X-Access-Keystring是API 访问密钥 ID,鉴权方式见 接口规则
X-Signaturestring是签名值,Base64 编码的 HMAC-SHA256 计算结果
X-Timestampstring是毫秒级 Unix 时间戳(13 位)
X-Noncestring是随机字符串,10~32 位小写字母+数字

Body 参数:

无请求体参数。

响应参数:

参数类型说明
codeinteger错误码,参见 错误码说明
dataarray[object]返回数据
├─ aliasstring别名
├─ signalServerUrlstring信令服务器URL
├─ spareSignalstring备用信令
├─ roomIdstring房间ID
├─ turnServerUristringTURN服务器URI
├─ isControlboolean是否控制
├─ tokenstring认证令牌
├─ hostTurnarray[string]主中继
├─ spareTurnarray[string]备用中继
├─ expiresinteger过期时间
├─ signstring签名
├─ ctrAliasstring别名
├─ groupNamestring分组名称
├─ ctrIpstringIP
├─ ctrIdstring容器ID
├─ ctrNamestring云机名称
├─ ctrRemarkstring云机备注
├─ screenshotServiceUrlstring截图服务地址
├─ deststring设备IP加密字符串
├─ ossServiceApiUrlstringOSS服务端API地址
├─ statusinteger云机状态
msgstring错误提示

响应示例:

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"
}

OpenAPI Docs