---
title: "GetRuleGroupByMetricGroupIds"
slug: "management-cloudinsight-getrulegroupbymetricgroupids"
updated: 2026-09-17T09:57:56Z
published: 2026-09-17T09:57:56Z
canonical: "api.ncloud-docs.com/management-cloudinsight-getrulegroupbymetricgroupids"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GetRuleGroupByMetricGroupIds

Classic/VPC環境で利用できます。

Rule Template(監視項目グループ)に関連した Event Ruleを照会します。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| POST | /cw_fea/real/cw/api/rule/group/metric/group/related |

### リクエストヘッダ

Cloud Insight APIで共通して使用されるヘッダの詳細は、[Cloud Insightのリクエストヘッダ](/docs/ja/management-cloudinsight#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `prodKey` | String | Required | 商品キー(cw_key) - [Cloud Insight指標](/docs/ja/management-cloudinsight-productinfo)を参照 |

### リクエストボディ

リクエストボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `metricGroupIds` | Array | Required | Rule Template IDリスト - [GetMetricsGroupList](/docs/ja/management-cloudinsight-getmetricsgrouplist)を参照 - 2つ以上照会時はコンマ「,」で区切る |

### リクエスト例

リクエストのサンプルコードは次の通りです。

```
curl --location --request POST 'https://cw.apigw.ntruss.com/cw_fea/real/cw/api/rule/group/metric/group/related?prodKey=**********' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--data '[
    "**********"
]'
```

## レスポンス

レスポンス形式を説明します。

### レスポンスボディ

Event Rule情報関連フィールドの詳細は、[RuleGroupItemDto](/docs/ja/common-vapidatatype-cirulegroupitemdto)をご参照ください。

### レスポンスステータスコード

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Cloud Insight APIのレスポンスステータスコード](/docs/ja/management-cloudinsight#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

```
[
    {
        "id": "**********",
        "ruleGroupItemDtoList": [
            {
                "asgGroupOptions": {},
                "cfTriggers": [],
                "cfTriggersOptions": {},
                "classicAsgGroupOptions": {},
                "createTime": **********,
                "domainCode": "PUB",
                "groupDesc": "サーバイベントルールを変更します。",
                "groupName": "server-test",
                "id": "1061257530522611712",
                "metricsGroups": [
                    {
                        "createTime": **********,
                        "domainCode": "PUB",
                        "groupName": "test-server",
                        "id": "**********",
                        "idDimension": "instanceNo",
                        "metrics": [
                            {
                                "calculation": "AVG",
                                "condition": "EQ",
                                "desc": "disk write bytes average",
                                "dimensions": [
                                    {
                                        "dim": "type",
                                        "val": "svr"
                                    }
                                ],
                                "duration": 1,
                                "eventLevel": "INFO",
                                "metric": "avg_write_byt_cnt",
                                "metricGroupItemId": "**********",
                                "options": {
                                    "Min1": [
                                        "COUNT",
                                        "SUM",
                                        "MAX",
                                        "MIN",
                                        "AVG"
                                    ],
                                    "Min5": [
                                        "COUNT",
                                        "SUM",
                                        "MAX",
                                        "MIN",
                                        "AVG"
                                    ],
                                    "Min30": [
                                        "COUNT",
                                        "SUM",
                                        "MAX",
                                        "MIN",
                                        "AVG"
                                    ],
                                    "Hour2": [
                                        "COUNT",
                                        "SUM",
                                        "MAX",
                                        "MIN",
                                        "AVG"
                                    ],
                                    "Day1": [
                                        "COUNT",
                                        "SUM",
                                        "MAX",
                                        "MIN",
                                        "AVG"
                                    ]
                                },
                                "threshold": "0"
                            }
                        ],
                        "prodKey": "**********",
                        "prodType": "system",
                        "regionCode": "KR",
                        "temporaryGroup": false,
                        "updateTime": **********
                    }
                ],
                "monitorGroups": [
                    {
                        "groupDesc": "監視対象グループのテスト",
                        "groupName": "test-group",
                        "id": "**********",
                        "monitorGroupItemList": [
                            {
                                "nrn": "**********",
                                "resourceId": "**********",
                                "resourceName": "**********"
                            }
                        ],
                        "prodKey": "**********",
                        "prodName": "Server(VPC)",
                        "temporaryGroup": false,
                        "type": "NORMAL"
                    }
                ],
                "prodKey": "**********",
                "recipientNotifications": [
                    {
                        "enableNotiWhenEventClose": false,
                        "groupName": "",
                        "groupNum": **********,
                        "notifyTypes": [
                            "SMS",
                            "EMAIL"
                        ]
                    }
                ],
                "regionCode": "KR",
                "ruleVersion": "V2",
                "suspendRuleItems": [
                    {
                        "metricGroupItemId": "**********",
                        "resourceId": "**********"
                    }
                ],
                "updateTime": **********
            }
        ]
    }
]
```