# 查询云厂商账号 - ListVendorAccount #### 功能介绍 查询所有云厂商（阿里云、AWS、Azure和HCS等）账号信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/COC/doc?api=ListVendorAccount)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-coc/coc_api_06.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | coc:vendorAccount:list | List | - | - | - | - | #### URI GET /v1/vendor-account 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 总数 | 表4data | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 查询云厂商账号信息失败。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-coc/ErrorCode.html)。