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

查询用户在云厂商的资源总数 - CountMultiCloudResources

功能介绍

查询用户在云厂商(阿里云、AWS、Azure和HCS)的资源总数。

调试

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

授权信息

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

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

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    coc:instance:countResources

    List

    -

    -

    -

    -

URI

GET /v1/multicloud-resources/count

表1 Query参数

参数

是否必选

参数类型

描述

vendor

String

参数解释:

云厂商类型。

约束限制:

不涉及。

取值范围:

  • AWS:亚马逊。

  • AZURE:微软。

  • ALI:阿里云。

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

默认取值:

不涉及。

type

String

参数解释:

资源类型。

约束限制:

不涉及。

取值范围:

资源类型较多,根据实际业务选择资源类型、常用资源类型如下:

  • cloudservers:弹性云服务器。

  • servers:裸金属服务器。

  • clusters:云容器引擎。

  • instances:云数据库。

默认取值:

不涉及。

resource_id_list

Array of strings

参数解释:

用户选择的资源id组成的列表。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

name_list

Array of strings

参数解释:

资源名称。

约束限制:

不涉及。

取值范围:

列表,可参考:裸金属服务器BMS。

默认取值:

不涉及。

region_id_list

Array of strings

参数解释:

关联的区域region的id组成的列表。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

data

Long

参数解释:

云资源数量。

取值范围:

取值在0 到 65535之间。

状态码:400

表3 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

字符串,长度8~36个字符之间。

error_msg

String

参数解释:

错误描述。

取值范围:

字符串,长度2~512个字符之间。

请求示例

查询用户在云厂商的资源总数。

GET https://{Endpoint}/v1/multicloud-resources/count?vendor=ALI&type=ACS::ECS::Instance

响应示例

状态码:200

查询用户在云厂商的资源总数成功。

{
  "data" : 2
}

状态码

状态码

描述

200

查询用户在云厂商的资源总数成功。

400

查询用户在云厂商的资源总数失败。

错误码

请参见错误码

相关文档