查询远程管理连接数

查询远程管理连接数。

请求 URL

GET {base_url}/dm/open_api/v1/subscription/rm_connections

请求参数

请求头
参数 是否必填 类型 说明
Authorization 是 String 在请求头中传递访问 Token。

格式：Bearer {access_token}。

响应参数

参数 类型 说明
data Object <Details> 详情。
requestId String 请求 ID，作为该请求的唯一标识，用于快速定位请求。
status String 请求结果。
  • Success：请求成功。
  • Failed：请求失败。
time Long 请求响应的时间。
注： YCM API 响应返回的是时间戳，如有需要，你可以将时间戳转换成具体的日期和时间。详细操作方法，请参见 将时间戳转换为日期和时间。
Details
参数 类型 说明
connections Object <Connections> 远程连接数详情。
remoteManagementAccount Object <RM_Account> 远程管理账号订阅详情。
remoteManagementPremiumAccount Object <RMP_Account> 远程管理高级账号订阅详情。
Connections
参数 类型 说明
used Integer 已使用的远程连接数。
capacity Integer 总的远程连接数。
assignedToResellerUsed Integer 分配给经销商的已使用的远程连接数。
assignedToResellerCapacity Integer 分配给经销商的总的远程连接数。
RM_Account
参数 类型 说明
status String 订阅状态。
  • Subscribed：已订阅。
  • Trial：使用。
  • Not Subscribed：未订阅。
expirationTime Long 订阅的过期时间。
RMP_Account
参数 类型 说明
status String 订阅状态。
  • Subscribed：已订阅。
  • Trial：使用。
  • Not Subscribed：未订阅。
expirationTime Long 订阅的过期时间。

示例

请求示例

GET /dm/open_api/v1/subscription/rm_connections HTTP/1.1
Host:ycm.yeastar.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21Kd3RQYXlsb2FkSW5mbyI6eyJncmFudFR5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJ5c0lkIjoxNzg5NjM2MDM5MDg1MDI1NzM0OSwidmVyc2lvbiI6MTYzODk1OTkwOSwicmVmcmVzaFZlcnNpb24iOjE2NjM1NzIzNTN9LCJzY29wZSI6WyJhbGwiXSwiZXhwIjoxNjYzNTc0MTUzLCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJjZDEyZTE1My1iYjRiLTRjNzUtOTkxZC01ZDFlMzM4YzE3MDYiLCJjbGllbnRfaWQiOiJrcDl5eW50bXVlc3VrNWpvV3ZNa1RiQ0J4cU82TEtSaCJ9.6E_hI3HkpCr8obFYrwH35hWOhB56tNmoT9tW0PTVOOE
响应示例
HTTP/1.1 200 OK
{
    "data": {
        "connections": {
            "used": 2,
            "capacity": 15,
            "assignedToResellerUsed": 0,
            "assignedToResellerCapacity": 1
        },
        "remoteManagementAccount": {
            "status": "Subscribed",
            "expirationTime": 1748658872
        },
        "remoteManagementPremiumAccount": {
            "status": "Subscribed",
            "expirationTime": 1748658872
        }
    },
    "requestId": "d13922856edfdde160a7d3e0bd899e5a",
    "status": "Success",
    "time": 1742363033
}