説明

Search Engine ClusterのACGを確認します。

リクエスト

リクエストURL

GET https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getAcgInfoList/{service-group-instance-no} [KR]
GET https://vpcsearchengine.apigw.ntruss.com/api/sgn-v2/cluster/getAcgInfoList/{service-group-instance-no} [SGN]
GET https://vpcsearchengine.apigw.ntruss.com/api/jpn-v2/cluster/getAcgInfoList/{service-group-instance-no} [JPN]

リクエストヘッダ

ヘッダ名	説明
x-ncp-apigw-timestamp	1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表したもので、 API Gatewayサーバとの時間差が5分以上の場合、有効ではないリクエストとみなす `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	NAVERクラウドプラットフォームのポータルから発行されたAccess Key ID値 `x-ncp-iam-access-key:{Account Access Key}`
x-ncp-apigw-signature-v2	Access Key ID値とSecret Keyで暗号化した署名 `x-ncp-apigw-signature-v2:{API Gateway Signature}`
Content-Type	リクエストボディーcontent typeをapplication/jsonに指定 `Content-Type: application/json`

リクエストパラメータ

パラメータ	タイプ	必須有無	説明
serviceGroupInstanceNo	String	Y	ACGを照会するクラスタ番号です。

リクエスト例

GET https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getAcgInfoList/1484848
HOST: vpcsearchengine.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: zq0FrtlU8JZJi9esTK31bCQUNG3H+jo4CMjMkJDoWSc=
x-ncp-apigw-timestamp: 1593848345548
x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw

curl -X GET "https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getAcgInfoList/1484848" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw" \
-H "x-ncp-apigw-timestamp: 1601971222179" \
-H "x-ncp-apigw-signature-v2: zrCelnR48AADdK/uh6Xe3yy468i8KpQoewYHUmeqYh4="

レスポンスパラメータ

public class GetAcgInfoList {
    GetAccessControlGroupRuleListResponseVo managerNodeAcgRule;
    GetAccessControlGroupRuleListResponseVo dataNodeAcgRule;
    GetAccessControlGroupRuleListResponseVo masterNodeAcgRule;
}

public class GetAccessControlGroupRuleListResponseVo {
    List<AcgRuleResponseDetailVo> inboundAcgRules;
    List<AcgRuleResponseDetailVo> outboundAcgRules;
}

public class AcgRuleResponseDetailVo {
    Integer accessControlGroupRuleNo;
    Integer accessControlGroupSequence;
    String ipBlock;
    Boolean isInboundRule;
    String portRange;
    String protocolTypeCode;
    String accessControlGroupName;
    Integer accessControlGroupNo;
    DateTimeVo createdYmdt;
    String description;
    String statusCode;
}

public class DateTimeVo {
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd", timezone = "Asia/Seoul")
    Date formattedDate;
    @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss SSSSSS", timezone = "Asia/Seoul")
    Date formattedDateTime;
    Long utc;
}

フィールド

パラメータ名	タイプ	説明
managerNodeAcgRule	GetAccessControlGroupRuleListResponseVo	マネージャーノードのACG Rule
dataNodeAcgRule	GetAccessControlGroupRuleListResponseVo	データノードのACG Rule
masterNodeAcgRule	GetAccessControlGroupRuleListResponseVo	マスターノードのACG Rule
inboundAcgRules	List<AcgRuleResponseDetailVo>	Inbound ACG Rule
outboundAcgRules	List<AcgRuleResponseDetailVo>	Outbound ACG Rule
accessControlGroupRuleNo	Integer	ACG番号
accessControlGroupSequence	Integer	ACG Ruleを適用するアクセスソースのACG番号
ipBlock	String	ACG Ruleを適用するアクセスソースのIP
isInboundRule	Boolean	Inbound Ruleかどうか
portRange	String	ポートの範囲とポートのプロトコルがICMPの場合には使用されません。
protocolTypeCode	String	プロトコルタイプ
accessControlGroupName	String	ACG名
accessControlGroupNo	Integer	ACG番号
createdYmdt	DateTimeVo	ACGが作成された時間
description	String	ACGの説明
statusCode	String	ACGの状態
formattedDate	Date	作成された日付
formattedDateTime	Date	作成された日付と時間
utc	Long	作成されたUTC時間をミリ秒に変換

レスポンス例

{
  "code": 0,
  "message": "SUCCESS",
  "result": {
    "managerNodeAcgRule": {
      "inboundAcgRules": [
        {
          "accessControlGroupName": "searchengine-m-vtps",
          "accessControlGroupNo": 62222,
          "createdYmdt": {
            "formattedDate": "2020-10-06",
            "formattedDateTime": "2020-10-06 18:06:40 000571",
            "utc": 1601975200571
          },
          "description": "(automatically created, don't delete it) for the Elasticsearch Cluster itself",
          "statusCode": "RUN",
          "accessControlGroupRuleNo": 118617,
          "accessControlGroupSequence": 62222,
          "ipBlock": null,
          "isInboundRule": true,
          "portRange": "22",
          "protocolTypeCode": "tcp"
        },
        {
          "accessControlGroupName": "searchengine-d-vtps",
          "accessControlGroupNo": 62222,
          "createdYmdt": {
            "formattedDate": "2020-10-06",
            "formattedDateTime": "2020-10-06 18:06:40 000559",
            "utc": 1601975200559
          },
          "description": "(automatically created, don't delete it) for the Elasticsearch Cluster itself",
          "statusCode": "RUN",
          "accessControlGroupRuleNo": 118616,
          "accessControlGroupSequence": 62221,
          "ipBlock": null,
          "isInboundRule": true,
          "portRange": "9300",
          "protocolTypeCode": "tcp"
        },
        {
          "accessControlGroupName": "searchengine-m-vtps",
          "accessControlGroupNo": 62222,
          "createdYmdt": {
            "formattedDate": "2020-10-06",
            "formattedDateTime": "2020-10-06 18:06:40 000547",
            "utc": 1601975200547
          },
          "description": "(automatically created, don't delete it) for the Elasticsearch Cluster itself",
          "statusCode": "RUN",
          "accessControlGroupRuleNo": 118615,
          "accessControlGroupSequence": 62222,
          "ipBlock": null,
          "isInboundRule": true,
          "portRange": "9300",
          "protocolTypeCode": "tcp"
        },
        {
          "accessControlGroupName": null,
          "accessControlGroupNo": 62222,
          "createdYmdt": {
            "formattedDate": "2020-10-06",
            "formattedDateTime": "2020-10-06 18:06:40 000535",
            "utc": 1601975200535
          },
          "description": "(automatically created, don't delete it) for the Elasticsearch Cluster itself",
          "statusCode": "RUN",
          "accessControlGroupRuleNo": 118614,
          "accessControlGroupSequence": null,
          "ipBlock": "0.0.0.0/0",
          "isInboundRule": true,
          "portRange": "80",
          "protocolTypeCode": "tcp"
        }
      ],
      "outboundAcgRules": [
        {
          "accessControlGroupName": null,
          "accessControlGroupNo": 62222,
          "createdYmdt": {
            "formattedDate": "2020-10-06",
            "formattedDateTime": "2020-10-06 18:06:40 000583",
            "utc": 1601975200583
          },
          "description": "automatically created, don't delete it",
          "statusCode": "RUN",
          "accessControlGroupRuleNo": 32871,
          "accessControlGroupSequence": null,
          "ipBlock": "0.0.0.0/0",
          "isInboundRule": false,
          "portRange": null,
          "protocolTypeCode": "icmp"
        },
        {
          "accessControlGroupName": null,
          "accessControlGroupNo": 62222,
          "createdYmdt": {
            "formattedDate": "2020-10-06",
            "formattedDateTime": "2020-10-06 18:06:40 000581",
            "utc": 1601975200581
          },
          "description": "automatically created, don't delete it",
          "statusCode": "RUN",
          "accessControlGroupRuleNo": 32870,
          "accessControlGroupSequence": null,
          "ipBlock": "0.0.0.0/0",
          "isInboundRule": false,
          "portRange": "1-65535",
          "protocolTypeCode": "udp"
        },
        {
          "accessControlGroupName": null,
          "accessControlGroupNo": 62222,
          "createdYmdt": {
            "formattedDate": "2020-10-06",
            "formattedDateTime": "2020-10-06 18:06:40 000579",
            "utc": 1601975200579
          },
          "description": "automatically created, don't delete it",
          "statusCode": "RUN",
          "accessControlGroupRuleNo": 32869,
          "accessControlGroupSequence": null,
          "ipBlock": "0.0.0.0/0",
          "isInboundRule": false,
          "portRange": "1-65535",
          "protocolTypeCode": "tcp"
        }
      ]
    },
    "dataNodeAcgRule": {
      "inboundAcgRules": [
        {
          "accessControlGroupName": "searchengine-d-vtps",
          "accessControlGroupNo": 62221,
          "createdYmdt": {
            "formattedDate": "2020-10-06",
            "formattedDateTime": "2020-10-06 18:06:40 000658",
            "utc": 1601975200658
          },
          "description": "(automatically created, don't delete it) for the Elasticsearch Cluster itself",
          "statusCode": "RUN",
          "accessControlGroupRuleNo": 118620,
          "accessControlGroupSequence": 62221,
          "ipBlock": null,
          "isInboundRule": true,
          "portRange": "9300",
          "protocolTypeCode": "tcp"
        },
        {
          "accessControlGroupName": "searchengine-m-vtps",
          "accessControlGroupNo": 62221,
          "createdYmdt": {
            "formattedDate": "2020-10-06",
            "formattedDateTime": "2020-10-06 18:06:40 000646",
            "utc": 1601975200646
          },
          "description": "(automatically created, don't delete it) for the Elasticsearch Cluster itself",
          "statusCode": "RUN",
          "accessControlGroupRuleNo": 118619,
          "accessControlGroupSequence": 62222,
          "ipBlock": null,
          "isInboundRule": true,
          "portRange": "9300",
          "protocolTypeCode": "tcp"
        },
        {
          "accessControlGroupName": "searchengine-m-vtps",
          "accessControlGroupNo": 62221,
          "createdYmdt": {
            "formattedDate": "2020-10-06",
            "formattedDateTime": "2020-10-06 18:06:40 000634",
            "utc": 1601975200634
          },
          "description": "(automatically created, don't delete it) for the Elasticsearch Cluster itself",
          "statusCode": "RUN",
          "accessControlGroupRuleNo": 118618,
          "accessControlGroupSequence": 62222,
          "ipBlock": null,
          "isInboundRule": true,
          "portRange": "22",
          "protocolTypeCode": "tcp"
        }
      ],
      "outboundAcgRules": [
        {
          "accessControlGroupName": null,
          "accessControlGroupNo": 62221,
          "createdYmdt": {
            "formattedDate": "2020-10-06",
            "formattedDateTime": "2020-10-06 18:06:40 000668",
            "utc": 1601975200668
          },
          "description": "automatically created, don't delete it",
          "statusCode": "RUN",
          "accessControlGroupRuleNo": 32874,
          "accessControlGroupSequence": null,
          "ipBlock": "0.0.0.0/0",
          "isInboundRule": false,
          "portRange": null,
          "protocolTypeCode": "icmp"
        },
        {
          "accessControlGroupName": null,
          "accessControlGroupNo": 62221,
          "createdYmdt": {
            "formattedDate": "2020-10-06",
            "formattedDateTime": "2020-10-06 18:06:40 000666",
            "utc": 1601975200666
          },
          "description": "automatically created, don't delete it",
          "statusCode": "RUN",
          "accessControlGroupRuleNo": 32873,
          "accessControlGroupSequence": null,
          "ipBlock": "0.0.0.0/0",
          "isInboundRule": false,
          "portRange": "1-65535",
          "protocolTypeCode": "udp"
        },
        {
          "accessControlGroupName": null,
          "accessControlGroupNo": 62221,
          "createdYmdt": {
            "formattedDate": "2020-10-06",
            "formattedDateTime": "2020-10-06 18:06:40 000664",
            "utc": 1601975200664
          },
          "description": "automatically created, don't delete it",
          "statusCode": "RUN",
          "accessControlGroupRuleNo": 32872,
          "accessControlGroupSequence": null,
          "ipBlock": "0.0.0.0/0",
          "isInboundRule": false,
          "portRange": "1-65535",
          "protocolTypeCode": "tcp"
        }
      ]
    },
   "masterNodeAcgRule": null
  },
  "requestId": "97d3fafd-a270-4bc3-8f7e-ecad1fb80487"
}

この記事は役に立ちましたか?

説明
リクエスト
レスポンスパラメータ
フィールド
- レスポンス例

タグ

Search Engine Service