# 查询分组关联的华为云资源 - ListGroupRmsResourceRelations #### 功能介绍 分组关联资源后，可查询分组相关的资源信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/COC/doc?api=ListGroupRmsResourceRelations)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-coc/coc_api_06.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | coc:application:listResources | List | application \* | - | - | - | | coc:application:listResources | List | - | coc:ApplicationGroupCode | - | - | #### URI GET /v1/group-resource-relations 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | application_id | 否 | String | **参数解释：** 分组关联的应用id。 **约束限制：** 应用id和分组id，组件id不能共存，且必填其中一个。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | component_id | 否 | String | **参数解释：** 分组关联的组件id。 **约束限制：** 应用id和分组id，组件id不能共存，且必填其中一个。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | group_id | 否 | String | **参数解释：** 分组id。 **约束限制：** 应用id和分组id，组件id不能共存，且必填其中一个。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | provider | 是 | String | **参数解释：** 云服务名称。 **约束限制：** 不涉及。 **取值范围：** 字符串，可选ecs，cce，rds等服务资源。 **默认取值：** 不涉及。 | | vendor | 是 | String | **参数解释：** 厂商信息。 **约束限制：** 不涉及。 **取值范围：** - AWS：亚马逊。 - AZURE：微软。 - ALI：阿里云。 - RMS：华为云。 - CROSS_ACCOUNT：跨账号资源。 - OTHER：其他厂商，例如：IDC离线资源。 **默认取值：** 不涉及。 | | type | 是 | String | **参数解释：** 资源类型。 **约束限制：** 不涉及。 **取值范围：** 资源类型，根据实际业务选择资源类型、常用资源类型如下： - cloudservers：弹性云服务器。 - servers：裸金属服务器。 - clusters：云容器引擎。 - instances：云数据库。 **默认取值：** 不涉及。 | | limit | 是 | Integer | **参数解释：** 分页查询每页显示的条目数量。 **约束限制：** 不涉及。 **取值范围：** 自定义，在1-500范围。 **默认取值：** 不涉及。 | | offset | 否 | String | **参数解释：** 分页查询偏移量，表示从此偏移量开始查询。 **约束限制：** 不涉及。 **取值范围：** 0-2147483647。 **默认取值：** 0。 | | marker | 否 | String | **参数解释：** 分页参数，上一页请求最后一个id。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | resource_id_list | 否 | Array of strings | **参数解释：** 资源id列表。 **约束限制：** 不涉及。 **取值范围：** 资源id列表，最大值100。 **默认取值：** 不涉及。 | | name | 否 | String | **参数解释：** 云资源名称。 **约束限制：** 不涉及。 **取值范围：** 自定义，可参考：裸金属服务器BMS。 **默认取值：** 不涉及。 | | region_id | 否 | String | **参数解释：** 区域id列表。 **约束限制：** 不涉及。 **取值范围：** 区域id列表，最大值100。 **默认取值：** 不涉及。 | | az_id | 否 | String | **参数解释：** 可用区id。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | ip_type | 否 | String | **参数解释：** ip类型。 **约束限制：** 不涉及。 **取值范围：** fixed：内网IP。 floating：弹性公网IP。 **默认取值：** 不涉及。 | | ip | 否 | String | **参数解释：** 云资源IP。 **约束限制：** 不涉及。 **取值范围：** IPv4地址过滤结果，匹配规则为模糊匹配。 **默认取值：** 不涉及。 | | status | 否 | String | **参数解释：** 云资源状态。 **约束限制：** 不涉及。 **取值范围：** 请选择[弹性云服务器 ECS](https://support.huaweicloud.com/api-ecs/ecs_08_0002.html)中存在的云服务器状态。 **默认取值：** 不涉及。 | | agent_state | 否 | String | **参数解释：** agent状态。 **约束限制：** 不涉及。 **取值范围：** - ONLINE：运行中。 - OFFLINE：异常。 - INSTALLING：安装中。 - FAILED：安装失败。 - UNINSTALLED：已卸载。 - null：未安装。 **默认取值：** 不涉及。 | | image_name | 否 | String | **参数解释：** 镜像名称，模糊匹配。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | os_type | 否 | String | **参数解释：** 系统类型。 **约束限制：** 不涉及。 **取值范围：** - windows：windows操作系统类型。 - linux：linux操作系统类型。 **默认取值：** 不涉及。 | | tag | 否 | String | **参数解释：** 云资源的标签。 **约束限制：** 标签的格式为"key.value"。其中，key的长度不超过36个字符，value的长度不超过43个字符。 **取值范围：** 标签命名时，需满足如下要求：标签的key值只能包含大写字母（A\~Z）、小写字母（a\~z）、数字（0-9）、下划线（）、中划线（-）以及中文字符。 标签的value值只能包含大写字母（A\~Z）、小写字母（a\~z）、数字（0-9）、下划线（）、中划线（-）、小数点（.）以及中文字符。 **默认取值：** 不涉及。 | | charging_mode | 否 | String | **参数解释：** 云服务器的计费类型。 **约束限制：** 不涉及。 **取值范围：** 计费模式： - 0：按需计费。 - 1：包年包月。 - 2：竞价计费。 **默认取值：** 不涉及。 | | flavor_name | 否 | String | **参数解释：** 规格名称。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | ip_list | 否 | Array of strings | **参数解释：** ip列表。 **约束限制：** 不涉及。 **取值范围：** 列表，最大值100。 **默认取值：** 不涉及。 | | is_collected | 否 | Boolean | **参数解释：** 是否已收藏。 **约束限制：** 不涉及。 **取值范围：** - true：查询已收藏分组管理的资源关联。 - false：查询未收藏分组管理的资源关联。 **默认取值：** 不涉及。 | #### 请求参数 无 #### 响应参数 **状态码：200** 表2响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | data | Array of [data] objects | **参数解释：** 分组资源关联信息。 **取值范围：** 长度大小在0\~500之间。 | 表3data | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 分组资源关联的id。 **取值范围：** 不涉及。 | | cmdb_resource_id | String | **参数解释：** CloudCMDB分配的资源uuid。 **取值范围：** 不涉及。 | | group_id | String | **参数解释：** 分组id。 **取值范围：** 字符串，长度24个字符。 | | group_name | String | **参数解释：** 分组名称。 **取值范围：** 字符串，长度3\~60个字符。 | | application_id | String | **参数解释：** 应用id。 **取值范围：** 字符串，长度24个字符。 | | resource_id | String | **参数解释：** 资源id。 **取值范围：** 字符串，长度36个字符。 | | name | String | **参数解释：** 资源名称。 **取值范围：** 字符串，长度3到50个字符之间。 | | ep_id | String | **参数解释：** 企业项目id。 **取值范围：** 字符串，长度0\~36个字符之间。 | | project_id | String | **参数解释：** 项目id。 **取值范围：** 字符串，长度32个字符。 | | ep_name | String | **参数解释：** 企业项目名称。 **取值范围：** 不涉及。 | | provider | String | **参数解释：** 云服务名称。 **取值范围：** 字符串，长度1到64个字符之间。 | | domain_id | String | **参数解释：** 租户id。 **取值范围：** 不涉及。 | | type | String | **参数解释：** 资源类型。 **取值范围：** 资源类型较多，根据实际业务选择资源类型、常用资源类型如下： - cloudservers：弹性云服务器。 - servers：裸金属服务器。 - clusters：云容器引擎。 - instances：云数据库。 | | region_id | String | **参数解释：** 区域id。 **取值范围：** 字符串，长度在0到64个字符之间。 | | inner_ip | String | **参数解释：** 资源内网ip。 **取值范围：** 不涉及。 | | agent_id | String | **参数解释：** uniagent的id值。 **取值范围：** 不涉及。 | | agent_state | String | **参数解释：** uniagent的状态。 **取值范围：** - ONLINE：运行中。 - OFFLINE：异常。 - INSTALLING：安装中。 - FAILED：安装失败。 - UNINSTALLED：已卸载。 - null：未安装。 | | tags | Array of [tags] objects | **参数解释：** 标签键值对。 **取值范围：** 不涉及。 | | ingest_properties | Object | **参数解释：** 数据采集属性。 **取值范围：** 不涉及。 | | properties | Map\ | **参数解释：** 属性信息。 **取值范围：** 不涉及。 | | operable | String | **参数解释：** 用户定义资源是否可运维实例。 **取值范围：** - ENABLE：可运维。 - DISABLE：不可运维实例operable字段不存在。 | | create_time | String | **参数解释：** 创建时间，参考ISO8601标准格式。 **取值范围：** 不涉及。 | 表4tags | 参数 | 参数类型 | 描述 | |:---|:---|:---| | key | String | **参数解释：** 标签键。 **取值范围：** 标签的键允许包含任意语种字母、数字、空格和_ . : = + - @特殊字符，但首尾不能含有空格，不能以_sys_开头，限制长度最长128个字符。 | | value | String | **参数解释：** 标签值。 **取值范围：** 标签的值允许包含任意语种字母、数字、空格和_ . : %%= + - @特殊字符，但首尾不能含有空格，限制长度最长255个字符。 | #### 请求示例 查询分组关联的资源。 ``` GET https://{endpoint}/v1/group-resource-relations?provider=cce&type=clusters&limit=10&offset=0&application_id=660557b2dc48844adc49eaa5&is_collected=false&vendor=RMS ``` #### 响应示例 **状态码：200** ``` { "data" : [ { "id" : "687740684dbc6000ac47f0af", "cmdb_resource_id" : "687733804dbc6000ac3eaf51", "group_id" : "66055804dc48844adc49eaae", "group_name" : "RMSaUTODDD", "resource_id" : "38fbefc2-5c76-11f0-8a3e-0255ac100b06", "name" : "cdr-test", "provider" : "cce", "type" : "clusters", "region_id" : "string", "ep_id" : "0", "ep_name" : null, "project_id" : "23a154c6e0be4cd282538462825fca67", "domain_id" : "adabd970539e4ebb8141ca2cf3b571f1", "tags" : null, "agent_id" : null, "agent_state" : null, "inner_ip" : null, "properties" : { "clusterEOSVersion" : "false", "clusterType" : "VirtualMachine", "clusterSubnetId" : "22b498de-32fa-46e8-abf4-2be88693f114", "clusterEIP" : "", "clusterChargeMode" : "0", "clusterVpcId" : "b6e5c685-d16a-4534-a023-bd67049f5cdd", "clusterFlavor" : "cce.s2.small", "clusterSecGroup" : "99000d1a-2f08-419a-a1d7-c02eb6c3b945", "clusterOldestVersion" : "false", "clusterVersion" : "v1.30.10-r10", "clusterStatus" : "Available" }, "ingest_properties" : null, "operable" : null, "create_time" : "2025-07-09T03:38:48.000+00:00" } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 查询分组关联的资源成功。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-coc/ErrorCode.html)。