查询云厂商账号 - ListVendorAccount

功能介绍

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

调试

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

授权信息

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

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
coc:vendorAccount:list
List
-
-
-
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
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	参数解释：云厂商账户列表。取值范围：不涉及。
total	Long	总数

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