# 查询CMDB跨账号资源视图聚合的资源 - ListResourcesOfResourceView #### 功能介绍 视图创建后，可以通过视图，去查询筛选CMDB跨账号资源视图聚合的资源信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/COC/doc?api=ListResourcesOfResourceView)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-coc/coc_api_06.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | coc:resourceView:listResources | List | resourceView \* | - | - | - | #### URI GET /v1/resource/views/resources 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | **参数解释：** 视图聚合的资源数据。 **取值范围：** 不涉及。 | 表3data | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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。 **取值范围：** 请选择[企业管理](https://support.huaweicloud.com/usermanual-em/eps_13_0001.html#section6)中存在的项目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 | String | **参数解释：** uniagent的状态。 **取值范围：** - ONLINE：运行中。 - OFFLINE：异常。 - INSTALLING：安装中。 - FAILED：安装失败。 - UNINSTALLED：已卸载。 - null：未安装。 | | inner_ip | String | **参数解释：** 资源内网ip。 **取值范围：** 不涉及。 | | associated_group_list | Object | **参数解释：** 绑定的资源组信息列表。 **取值范围：** 不涉及。 | 表4tags | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释：** 标签键。 **取值范围：** 标签的键允许包含任意语种字母、数字、空格和_ . : = + - @特殊字符，但首尾不能含有空格，不能以_sys_开头，限制长度最长128个字符。 | | value | String | **参数解释：** 标签值。 **取值范围：** 标签的值允许包含任意语种字母、数字、空格和_ . : %%= + - @特殊字符，但首尾不能含有空格，限制长度最长255个字符。 | #### 请求示例 查询CMDB跨账号资源视图聚合的资源。 ``` GET https://{Endpoint}/v1/resource/views/resources ``` #### 响应示例 **状态码：200** ``` { "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跨账号资源视图聚合的资源成功。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-coc/ErrorCode.html)。