查看授权绑定列表

最近更新时间: 2026-09-17 00:02:47

1. 接口描述

接口请求域名： cwp.api3.fincloud.tencent.cn。

该接口可以获取设置中心-授权管理,某个授权下已绑定的授权机器列表

默认接口请求频率限制：20次/秒。

接口更新时间：2022-06-09 10:50:08。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：DescribeLicenseBindList
Version 是 否 String 公共参数，本接口取值：2018-02-28
Region 是 否 String 公共参数，地域信息本接口不需要传递此参数。
Filters 否 否 Array of Filters
  • InstanceID、IP、

    MachineName 模糊查询
  • Keywords 主机名或ip模糊查询
  • AgentStatus 状态：在线ONLINE、离线OFFLINE、未防护UNINSTALLED、关机SHUTDOWN、开通专业版并且机器已销毁TERMINATED_PRO_VERSION

    • 示例值：查看
    LicenseId 是 否 Uint64 授权ID
    示例值： 1
    LicenseType 是 否 Uint64 授权类型, 0 专业版, 5 旗舰版
    示例值： 0
    Limit 否 否 Uint64 限制条数,默认10.
    示例值： 10
    Offset 否 否 Uint64 偏移量,默认0.
    示例值： 0
    ResourceId 是 否 String 资源ID
    示例值： any data

    3. 输出参数

    参数名称 类型 描述
    List Array of LicenseBindDetail 绑定机器列表信息
    示例值：查看
    TotalCount Uint64 总条数
    示例值： 10
    RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

    4. 错误码

    以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

    错误码 描述
    InternalError 内部错误。
    MissingParameter 缺少参数错误。
    ResourceNotFound 资源不存在。
    InvalidParameterValue 参数取值错误。

    5. 示例

    示例1 示例

    DescribeLicenseBindList

    输入示例

    POST / HTTP/1.1
Host: cwp.api3.fincloud.tencent.cn
Content-Type: application/json
X-TC-Action: DescribeLicenseBindList
<Public request parameters>

{
    "LicenseId":1,
    "LicenseType":0,
    "ResourceId":"cdbae897e7e0"
}

    输出示例

    {"Response ":{" List":[{"AgentStatus ":" ONLINE "," IsSwitchBind ": false," IsUnBind ": false," MachineExtraInfo ":{" HostName":"dev-one","InstanceID":"ins-onxyg5w","NetworkName":"dev "," NetworkType ": 0," PrivateIP ":" www.example.com "," WanIP ":" 10.0.0 "},"MachineIp":"10.0.0.0","MachineName":" Test machine "," MachineWanIp ":" 10.0.0.0 "," Quuid ":"f6481aac-78f7 - 403e-867d-553c4af8b025","Tags":["dev"],"Uuid":" f6481aac-78f7 - 403e-867d-553c4af8b025 "}]," RequestId":" de41ce31-f2c0 - 49a9-a476 - 57051a5c7c6c"," TotalCount": 1}}}