クラスタ ACGリストの照会

Prev Next

VPC環境で利用できます。

Cloud Data Streaming Serviceクラスタの ACGルールリストを照会します。

リクエスト

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

メソッド URI
GET /api/v1/cluster/getAcgInfoList/{serviceGroupInstanceNo} (韓国リージョン)
GET /api/sgn-v1/cluster/getAcgInfoList/{serviceGroupInstanceNo} (シンガポールリージョン)
GET /api/jpn-v1/cluster/getAcgInfoList/{serviceGroupInstanceNo} (日本リージョン)

リクエストヘッダ

Cloud Data Streaming Service APIで共通して使用されるヘッダの詳細は、Cloud Data Streaming Serviceのリクエストヘッダをご参照ください。

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

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

フィールド タイプ 必須の有無 説明
serviceGroupInstanceNo Integer Required クラスタインスタンス番号

リクエスト例

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

curl --location --request GET 'https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/getAcgInfoList/1009*****' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

レスポンス

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

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
code Integer - レスポンスコード
message String - レスポンスメッセージ
result Object - レスポンス結果
result.managerNodeAcgRule Object - マネージャノードの ACGルール
result.managerNodeAcgRule.inboundAcgRules Array - Inbound ACGルール: ACGルール情報
result.managerNodeAcgRule.outboundAcgRules Array - Outbound ACGルール: ACGルール情報
result.brokerNodeAcgRule Object - ブローカーノードの ACGルール
result.brokerNodeAcgRule.inboundAcgRules Array - Inbound ACGルール: ACGルール情報
result.brokerNodeAcgRule.outboundAcgRules Array - Outbound ACGルール: ACGルール情報
requestId String - リクエスト ID
  • UUID形式

ACGルール情報

ACGルール情報の説明は次の通りです。

フィールド タイプ 必須の有無 説明
accessControlGroupName String - ACG名
accessControlGroupNo Integer - ACG ID
createdYmdt Object - ルールの作成日時
createdYmdt.formattedDate String - ルールの作成日
  • yyyy-MM-dd形式
createdYmdt.formattedDateTime String - ルールの作成日時
  • yyyy-MM-dd HH:mm:ss SSSSSS形式
createdYmdt.utc Integer - ルールの作成日時(ミリ秒)
  • Unix Timestamp形式
description String - ルールの説明
statusCode String - ルールの状態
accessControlGroupRuleNo Integer - ルール ID
accessControlGroupSequence Integer - アクセスソースの ACG ID
  • Inboundルールのアクセスソースが ACGの場合、有効値を表示
ipBlock String - アクセスソースまたは目的地 IPアドレス
  • アクセスソースまたは目的地が単一の IPアドレスの場合、有効値を表示
isInboundRule Boolean - Inboundルールかどうか
  • true | false
    • true: Inboundルール
    • false: Outboundルール
portRange String - 許可ポート番号
protocolTypeCode String - 許可プロトコル

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

Cloud Data Streaming Service APIで共通して使用されるレスポンスステータスコードの詳細は、Cloud Data Streaming Serviceのレスポンスステータスコードをご参照ください。

レスポンス例

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

{
    "code": 0,
    "message": "SUCCESS",
    "result": {
        "managerNodeAcgRule": {
            "inboundAcgRules": [
                {
                    "accessControlGroupName": null,
                    "accessControlGroupNo": 59***,
                    "createdYmdt": {
                        "formattedDate": "2025-04-16",
                        "formattedDateTime": "2025-04-16 10:53:04 000254",
                        "utc": 1744768384254
                    },
                    "description": null,
                    "statusCode": "RUN",
                    "accessControlGroupRuleNo": 268***,
                    "accessControlGroupSequence": null,
                    "ipBlock": "10.3.0.153/32",
                    "isInboundRule": true,
                    "portRange": "1-65535",
                    "protocolTypeCode": "tcp"
                },
                ...
            ],
            "outboundAcgRules": [
                {
                    "accessControlGroupName": null,
                    "accessControlGroupNo": 59***,
                    "createdYmdt": {
                        "formattedDate": "2025-04-16",
                        "formattedDateTime": "2025-04-16 09:37:25 000006",
                        "utc": 1744763845006
                    },
                    "description": "automatically created, don't delete it",
                    "statusCode": "RUN",
                    "accessControlGroupRuleNo": 147***,
                    "accessControlGroupSequence": null,
                    "ipBlock": "0.0.0.0/0",
                    "isInboundRule": false,
                    "portRange": null,
                    "protocolTypeCode": "icmp"
                },
                ...
            ]
        },
        "brokerNodeAcgRule": {
            "inboundAcgRules": [
                {
                    "accessControlGroupName": "cdss-m-1o2xag",
                    "accessControlGroupNo": 59***,
                    "createdYmdt": {
                        "formattedDate": "2025-04-16",
                        "formattedDateTime": "2025-04-16 09:37:25 000163",
                        "utc": 1744763845163
                    },
                    "description": "(automatically created, don't delete it) for the Cloud Data Streaming Service Cluster itself",
                    "statusCode": "RUN",
                    "accessControlGroupRuleNo": 268***,
                    "accessControlGroupSequence": 59***,
                    "ipBlock": null,
                    "isInboundRule": true,
                    "portRange": "9394",
                    "protocolTypeCode": "tcp"
                },
                ...
            ],
            "outboundAcgRules": [
                {
                    "accessControlGroupName": null,
                    "accessControlGroupNo": 59***,
                    "createdYmdt": {
                        "formattedDate": "2025-04-16",
                        "formattedDateTime": "2025-04-16 09:37:25 000172",
                        "utc": 1744763845172
                    },
                    "description": "automatically created, don't delete it",
                    "statusCode": "RUN",
                    "accessControlGroupRuleNo": 147***,
                    "accessControlGroupSequence": null,
                    "ipBlock": "0.0.0.0/0",
                    "isInboundRule": false,
                    "portRange": null,
                    "protocolTypeCode": "icmp"
                },
                ...
            ]
        }
    },
    "requestId": "add066d1-****-****-****-92a4e42ed89e"
}