文档首页/ 云运维中心 COC/ API参考/ API/ 应用资源管理/ 资源视图/ 查询CMDB跨账号资源视图聚合的资源 - ListResourcesOfResourceView
更新时间：2025-10-23 GMT+08:00
查看PDF
分享

查询CMDB跨账号资源视图聚合的资源 - ListResourcesOfResourceView

功能介绍

视图创建后，可以通过视图，去查询筛选CMDB跨账号资源视图聚合的资源信息。

调试

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

授权信息

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

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

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    coc:resourceView:listResources

    List

    resourceView *

    -

    -

    -

URI

GET /v1/resource/views/resources

表1 Query参数

参数

是否必选

参数类型

描述

limit

是

Integer

参数解释：

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

约束限制：

不涉及。

取值范围：

自定义，在1-500范围。

默认取值：

不涉及。

offset

否

String

参数解释：

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

约束限制：

不涉及。

取值范围：

0-2147483647。

默认取值：

0。

view_id

是

String

参数解释：

视图ID。

约束限制：

不涉及。

取值范围：

字符串，长度1~32之间。

默认取值：

不涉及。

marker

否

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

provider

否

String

参数解释：

云服务名称。

约束限制：

不涉及。

取值范围：

字符串，可选ecs，cce，rds等服务资源。

默认取值：

不涉及。

type

否

String

参数解释：

资源类型。

约束限制：

不涉及。

取值范围：

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

  • cloudservers：弹性云服务器。

  • servers：裸金属服务器。

  • clusters：云容器引擎。

  • instances：云数据库。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

data

Array of data objects

参数解释：

视图聚合的资源数据。

取值范围：

不涉及。
表3 data

参数

参数类型

描述

id

String

参数解释：

唯一标识id。

取值范围：

不涉及。

view_id

String

参数解释：

视图id。

取值范围：

字符串，长度1~32之间。

rms_resource_id

String

参数解释：

对应rms_resource集合中的id值。

取值范围：

不涉及。

resource_id

String

参数解释：

资源id，跨账号资源下且视图管理下对应的资源id。

取值范围：

字符串，长度36字符。

domain_id

String

参数解释：

用户登录租户对应的租户id。

取值范围：

不涉及。

name

String

参数解释：

视图下的资源名称。

取值范围：

字符串，长度3~50个字符之间。

ep_id

String

参数解释：

企业项目ID。

取值范围：

请选择企业管理中存在的项目ID。

ep_name

String

参数解释：

企业项目名称。

取值范围：

不涉及。

project_id

String

参数解释：

Openstack中的项目ID。

取值范围：

不涉及。

provider

String

参数解释：

云服务名称。

取值范围：

字符串，长度1~64个字符之间。

type

String

参数解释：

资源类型。

取值范围：

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

  • cloudservers：弹性云服务器。

  • servers：裸金属服务器。

  • clusters：云容器引擎。

  • instances：云数据库。

region_id

String

参数解释：

区域id。

取值范围：

字符串，长度0~64个字符之间。

tags

Array of tags objects

参数解释：

标签键值对。

取值范围：

不涉及。

properties

Object

参数解释：

存储资源的附加字段信息，通常用于展示、筛选等。

取值范围：

不涉及。

ingest_properties

Object

参数解释：

数据采集属性，描述视图系统采集该资源时所记录的附加信息。

取值范围：

不涉及。

agent_id

String

参数解释：

uniagent的id值。

取值范围：

不涉及。

agent_state

AnyType

参数解释：

uniagent的状态。

取值范围：

  • ONLINE：运行中。

  • OFFLINE：异常。

  • INSTALLING：安装中。

  • FAILED：安装失败。

  • UNINSTALLED：已卸载。

  • null：未安装。

inner_ip

String

参数解释：

资源内网ip。

取值范围：

不涉及。

associated_group_list

Object

参数解释：

绑定的资源组信息列表。

取值范围：

不涉及。
表4 tags

参数

参数类型

描述

key

String

参数解释：

标签键。

取值范围：

标签的键允许包含任意语种字母、数字、空格和_ . : = + - @特殊字符，但首尾不能含有空格，不能以_sys_开头，限制长度最长128个字符。

value

String

参数解释：

标签值。

取值范围：

标签的值允许包含任意语种字母、数字、空格和_ . : / = + - @特殊字符，但首尾不能含有空格，限制长度最长255个字符。

请求示例

查询CMDB跨账号资源视图聚合的资源。

GET https://{Endpoint}/v1/resource/views/resources

响应示例

状态码：200

查询CMDB跨账号资源视图聚合的资源成功。

{
  "data" : [ {
    "id" : "674034ed9de91350a4753232",
    "view_id" : "674034ec9de91350a4753230",
    "rms_resource_id" : "6569f4f04552f23e97babff3",
    "resource_id" : "0228b9bb-7567-49ca-9707-4d851a863ec4",
    "domain_id" : "dc2d76541f754d68a4c8d150262d92c2",
    "name" : "runbook-test-0088ab2误删",
    "ep_id" : "9d414beb-88b7-4ea8-9e61-1ebb64876849",
    "ep_name" : "COC",
    "project_id" : "10a6c23c2a1044779794798beb067c94",
    "provider" : "ecs",
    "type" : "cloudservers",
    "region_id" : "string",
    "tags" : [ {
      "key" : "FASA",
      "value" : "gdsa"
    }, {
      "key" : "ID3",
      "value" : "123456789"
    }, {
      "key" : "ID",
      "value" : "123456789"
    }, {
      "key" : "43243",
      "value" : "45RT"
    }, {
      "key" : "ID2",
      "value" : "123456789"
    } ],
    "properties" : {
      "accessIpv4" : "",
      "hostName" : "runbook-test-0088",
      "addresses" : [ {
        "OsExtIpsType" : "fixed",
        "OsExtIpsPortId" : "1f653e40-423d-4df0-b539-16c3cfd2a2bd",
        "addr" : "192.168.0.94",
        "version" : 4,
        "OsExtIpsMacAddr" : "fa:16:3e:f0:48:a6",
        "primary" : true
      } ],
      "accessIpv6" : "",
      "metadata" : {
        "chargingMode" : "0",
        "meteringImageType" : "gold",
        "imageName" : "Public-CAD-HCE-BaseTemplate-2.0.2312.1-x86_64-Standard",
        "meteringImageId" : "5086e876-a5c2-4d45-a734-1e0c0f664730",
        "meteringResourcesPerCode" : "s6.small.1.linux",
        "vpcId" : "44cec12a-3d51-4101-962e-c973fc4ea948",
        "osBit" : "64",
        "osType" : "Linux",
        "ecmResStatus" : ""
      },
      "OsExtStsVmState" : "stopped",
      "configDrive" : "",
      "OsExtStsPowerState" : 4,
      "hostId" : "387bf199de0b370202251e0db98291285b8b5849b5df74bec036abae",
      "securityGroup" : [ {
        "name" : "default",
        "id" : "9e262f72-2f9a-4534-8a56-412710913895"
      } ],
      "ExtVolumesAttached" : [ {
        "bootIndex" : "0",
        "id" : "f85d484e-f502-43e2-9f99-3add086884ef",
        "device" : "/dev/vda"
      } ],
      "userId" : "9fec03ee5b1040818b91bef6e16213df",
      "flavor" : {
        "disk" : "0",
        "name" : "s6.small.1",
        "id" : "s6.small.1",
        "vcpus" : "1",
        "ram" : "1024"
      },
      "osextsrvattr" : {
        "hostName" : "runbook-test-0088",
        "kernelId" : "",
        "ramdiskId" : "",
        "reservationId" : "r-lljtv8ct",
        "instanceName" : "instance-008def4e",
        "host" : "dd9e17d37e277347b5c29e6ee04c9f5e2aafe6e4a84596c541c48179",
        "rootDeviceName" : "/dev/vda",
        "hypervisorHostName" : "c3a03e89b2504db22be4a695b862662205800ca4ac466a8f8d177e60",
        "launchIndex" : 0
      },
      "OsDcfDiskConfig" : "MANUAL",
      "hostStatus" : "UP",
      "OsSrvUsgLaunchedAt" : "2023-06-27T08:35:10.000000",
      "OsExtAz" : "string",
      "locked" : false,
      "status" : "SHUTOFF",
      "schedulerHints" : { }
    },
    "ingest_properties" : null,
    "agent_id" : null,
    "agent_state" : null,
    "inner_ip" : null,
    "associated_group_list" : null
  } ]
}

状态码

状态码

描述

200

查询CMDB跨账号资源视图聚合的资源成功。

错误码

请参见错误码。

父主题： 资源视图

相关文档