文档首页/ 云运维中心 COC/ API参考/ API/ 应用资源管理/ 多云配置/ 查询云厂商账号 - ListVendorAccount
更新时间:2025-10-14 GMT+08:00
分享

查询云厂商账号 - ListVendorAccount

功能介绍

查询所有云厂商(阿里云、AWS、Azure和HCS等)账号信息。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    coc:vendorAccount:list

    List

    -

    -

    -

    -

URI

GET /v1/vendor-account

表1 Query参数

参数

是否必选

参数类型

描述

limit

Integer

参数解释:

分页查询每页显示的条目数量。

约束限制:

不涉及。

取值范围:

自定义,在1-500范围。

默认取值:

不涉及。

offset

String

参数解释:

分页查询偏移量,表示从此偏移量开始查询。

约束限制:

不涉及。

取值范围:

0-2147483647。

默认取值:

0。

marker

String

参数解释:

分页参数,上一页请求最后一个id。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

vendor

String

参数解释:

供应商。

约束限制:

不涉及。

取值范围:

  • RMS: 华为云。

  • AWS:亚马逊。

  • AZURE:微软。

  • ALI:阿里云。

  • VMWARE:VMware。

  • OPENSTACK:openstack云平台。

  • HCS:Huawei Cloud Stack(简称 HCS),华为混合云解决方案。

  • OTHER:其他云厂商。

默认取值:

不涉及。

account_id

String

参数解释:

供应商的账户ID。

约束限制:

不涉及。

取值范围:

字符串,长度0到64个字符。

默认取值:

不涉及。

account_name

String

参数解释:

账户名。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

响应参数

状态码:200

表2 响应Header参数

参数

参数类型

描述

X-request-id

String

参数解释:

用于任务跟踪的请求ID号。

取值范围:

request_uuid-时间戳-主机名。

表3 响应Body参数

参数

参数类型

描述

data

Array of data objects

参数解释:

云厂商账户列表。

取值范围:

不涉及。

表4 data

参数

参数类型

描述

id

String

参数解释:

CMDB分配的云厂商账户ID。

取值范围:

不涉及。

vendor

String

参数解释:

云厂商信息。

取值范围:

  • RMS: 华为云。

  • AWS:亚马逊。

  • AZURE:微软。

  • ALI:阿里云。

  • VMWARE:VMware。

  • OPENSTACK:openstack云平台。

  • HCS:Huawei Cloud Stack(简称 HCS),华为混合云解决方案。

  • OTHER:其他云厂商。

account_id

String

参数解释:

供应商的账户ID。

取值范围:

字符串,长度0到64个字符。

domain_id

String

参数解释:

租户id。

取值范围:

不涉及。

account_name

String

参数解释:

账户名。

取值范围:

字符串,长度0到64个字符。

ak

String

参数解释:

账户ak。

取值范围:

字符串,长度0到64个字符。

sync_status

String

参数解释:

任务状态。

取值范围:

  • waiting:待启动。

  • running:同步中。

  • success:同步成功。

  • failed:同步失败。

failure_msg

String

参数解释:

错误信息。

取值范围:

不涉及。

sync_date

String

参数解释:

同步时间。

取值范围:

不涉及。

create_time

String

参数解释:

创建时间。

取值范围:

不涉及。

update_time

String

参数解释:

更新时间。

取值范围:

不涉及。

状态码:400

表5 响应Header参数

参数

参数类型

描述

X-request-id

String

参数解释:

用于任务跟踪的请求ID号。

取值范围:

request_uuid-时间戳-主机名。

表6 响应Body参数

参数

参数类型

描述

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

查询云厂商账号信息失败。

错误码

请参见错误码

相关文档