查询云厂商账号 - ListVendorAccount
功能介绍
查询所有云厂商(阿里云、AWS、Azure和HCS等)账号信息。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
 - 如果使用身份策略授权,需具备如下身份策略权限。 
    
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
coc:vendorAccount:list
List
-
-
-
-
 
URI
GET /v1/vendor-account
| 
        参数  | 
      
        是否必选  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|---|
| 
        limit  | 
      
        是  | 
      
        Integer  | 
      
        参数解释: 分页查询每页显示的条目数量。 约束限制: 不涉及。 取值范围: 自定义,在1-500范围。 默认取值: 不涉及。  | 
     
| 
        offset  | 
      
        否  | 
      
        String  | 
      
        参数解释: 分页查询偏移量,表示从此偏移量开始查询。 约束限制: 不涉及。 取值范围: 0-2147483647。 默认取值: 0。  | 
     
| 
        marker  | 
      
        否  | 
      
        String  | 
      
        参数解释: 分页参数,上一页请求最后一个id。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。  | 
     
| 
        vendor  | 
      
        否  | 
      
        String  | 
      
        参数解释: 供应商。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。  | 
     
| 
        account_id  | 
      
        否  | 
      
        String  | 
      
        参数解释: 供应商的账户ID。 约束限制: 不涉及。 取值范围: 字符串,长度0到64个字符。 默认取值: 不涉及。  | 
     
| 
        account_name  | 
      
        否  | 
      
        String  | 
      
        参数解释: 账户名。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。  | 
     
请求参数
无
响应参数
状态码:200
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        X-request-id  | 
      
        String  | 
      
        参数解释: 用于任务跟踪的请求ID号。 取值范围: request_uuid-时间戳-主机名。  | 
     
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        data  | 
      
        Array of data objects  | 
      
        参数解释: 云厂商账户列表。 取值范围: 不涉及。  | 
     
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        id  | 
      
        String  | 
      
        参数解释: CMDB分配的云厂商账户ID。 取值范围: 不涉及。  | 
     
| 
        vendor  | 
      
        String  | 
      
        参数解释: 云厂商信息。 取值范围:  | 
     
| 
        account_id  | 
      
        String  | 
      
        参数解释: 供应商的账户ID。 取值范围: 字符串,长度0到64个字符。  | 
     
| 
        domain_id  | 
      
        String  | 
      
        参数解释: 租户id。 取值范围: 不涉及。  | 
     
| 
        account_name  | 
      
        String  | 
      
        参数解释: 账户名。 取值范围: 字符串,长度0到64个字符。  | 
     
| 
        ak  | 
      
        String  | 
      
        参数解释: 账户ak。 取值范围: 字符串,长度0到64个字符。  | 
     
| 
        sync_status  | 
      
        String  | 
      
        参数解释: 任务状态。 取值范围:  | 
     
| 
        failure_msg  | 
      
        String  | 
      
        参数解释: 错误信息。 取值范围: 不涉及。  | 
     
| 
        sync_date  | 
      
        String  | 
      
        参数解释: 同步时间。 取值范围: 不涉及。  | 
     
| 
        create_time  | 
      
        String  | 
      
        参数解释: 创建时间。 取值范围: 不涉及。  | 
     
| 
        update_time  | 
      
        String  | 
      
        参数解释: 更新时间。 取值范围: 不涉及。  | 
     
状态码:400
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        X-request-id  | 
      
        String  | 
      
        参数解释: 用于任务跟踪的请求ID号。 取值范围: request_uuid-时间戳-主机名。  | 
     
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        参数解释: 错误码。 取值范围: 字符串,长度8~36个字符之间。  | 
     
| 
        error_msg  | 
      
        String  | 
      
        参数解释: 错误描述。 取值范围: 字符串,长度2~512个字符之间。  | 
     
请求示例
查询所有云厂商账号。
GET https://{endpoint}/v1/vendor-account?limit=10&offset=0
 响应示例
状态码:200
查询云厂商账号信息成功。
{
  "data" : [ {
    "id" : "688b32521c083f512c338cf2",
    "domain_id" : "dc2d76541f754d68a4c8d150262d92c2",
    "vendor" : "HCS",
    "account_id" : "ssstest21321",
    "account_name" : "ssssss",
    "ak" : "sss",
    "sync_status" : null,
    "failure_msg" : null,
    "sync_date" : null,
    "create_time" : "7/31/25, 5:07 PM",
    "update_time" : "7/31/25, 5:07 PM"
  }, {
    "id" : "6881e4d870bbfa13eb9fb988",
    "domain_id" : "dc2d76541f754d68a4c8d150262d92c2",
    "vendor" : "HCS",
    "account_id" : "52.154.20.10",
    "account_name" : "dhsdhsdhsd",
    "ak" : "test_api_1",
    "sync_status" : "failed",
    "failure_msg" : "network is disconnected or the user or password is incorrect.",
    "sync_date" : "7/31/25, 4:44 PM",
    "create_time" : "7/24/25, 3:46 PM",
    "update_time" : "7/24/25, 3:46 PM"
  } ],
  "total" : 2
}
 状态码
| 
        状态码  | 
      
        描述  | 
     
|---|---|
| 
        200  | 
      
        查询云厂商账号信息成功。  | 
     
| 
        400  | 
      
        查询云厂商账号信息失败。  | 
     
错误码
请参见错误码。