Search Engine Clusterリストの照会
    • PDF

    Search Engine Clusterリストの照会

    • PDF

    Article Summary

    VPC環境で利用できます。

    説明

    Search Engine Clusterリストを照会します。

    リクエスト

    リクエストURL

    GET https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getClusterInfoList
    ?inputText={inputText}
    &pageNo={pageNo}
    &pageSize={pageSize}
    &vpcName={vpcName} [KR]
    
    GET https://vpcsearchengine.apigw.ntruss.com/api/sgn-v2/cluster/getClusterInfoList
    ?inputText={inputText}
    &pageNo={pageNo}
    &pageSize={pageSize}
    &vpcName={vpcName} [SGN]
    
    GET https://vpcsearchengine.apigw.ntruss.com/api/jpn-v2/cluster/getClusterInfoList
    ?inputText={inputText}
    &pageNo={pageNo}
    &pageSize={pageSize}
    &vpcName={vpcName} [JPN]
    

    リクエストヘッダ

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

    リクエストパラメータ

    パラメータタイプ必須有無説明
    inputTextStringN照会するクラスタ名です。
    vpcNameStringN当該VPCを使用しているクラスタを照会します。
    pageNoIntegerNページ番号です。Default : 1
    ex) 1, 2
    pageSizeIntegerNページサイズです。Default : 10
    ex) 10, 20

    リクエスト例

    GET https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/getClusterInfoList
    ?inputText=ses
    &pageNo=1
    &pageSize=10
    &vpcName=clean
    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/getClusterInfoList?inputText=ses&
    pageNo=1
    &pageSize=10
    &vpcName=clean \
    -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 GetClusterInfoListResponseVo {
        private List<AllowedClusterInfo> allowedClusters;
        private List<DisallowedClusterInfo> disallowedClusters;
        private Integer currentPage;
        private Boolean isFirst;
        private Boolean isLast;
        private Integer pageSize;
        private Long totalCount;
        private Integer totalPage;
    }
    
    public class AllowedClusterInfo {
        private String clusterName;
        private String dataNodeType;
        private String dataNodeProductName;
        private Integer dataNodeCount;
        private String clusterStatus;
        private String elasticSearchStatus;
        private String elasticSearchVersion;
        private String softwareProductName;
        private Date createDate;
        private String managerNodeType;
        private Integer managerNodeCount;
        private Long dataStorageVolumeSize;
        private Integer managerNodeAccessControlGroupSequence;
        private String managerNodeAccessControlGroupName;
        private Integer dataNodeAccessControlGroupSequence;
        private String dataNodeAccessControlGroupName;
        private String elasticSearchHttpPort;
        private String kibanaHttpPort;
        private String loginKeyName;
        private String serviceGroupInstanceNo;
        private String kibanaUserName;
        private String memberNo;
        private String vpcName;
        private Integer vpcNo;
        private String managerNodeSubnetName;
        private Integer managerNodeSubnetNo;
        private String dataNodeSubnetName;
        private Integer dataNodeSubnetNo;
        private Boolean isMasterOnlyNodeActivated;
        private Integer masterNodeAccessControlGroupSequence;
        private String masterNodeAccessControlGroupName;
        private String masterNodeSubnetName;
        private Integer masterNodeSubnetNo;
        private String masterNodeType;
        private String masterNodeProductName;
        private Integer masterNodeCount;
        private Boolean isPluginInstalled;
        private String accessKeyId;
    }
    
    public class DisallowedClusterInfo {
        private String clusterName;
        private String clusterStatus;
        private String elasticSearchStatus;
    }
    

    フィールド

    パラメータ名タイプ説明
    serviceGroupInstanceNoString作成されたクラスタのserviceGroupInstanceNo
    allowedClustersList<AllowedClusterInfo>クラスタリスト
    disallowedClustersList<DisallowedClusterInfo>Subaccountで呼び出す際、getClusterDetail権限がないクラスタリスト
    currentPageInteger現在のページ
    isFirstBooleanfirstページかどうか
    isLastBooleanlastページかどうか
    pageSizeIntegerページのサイズ
    totalCountLongクラスタの総リスト数
    totalPageInteger総ページ数
    clusterNameStringクラスタ名
    dataNodeTypeStringデータノードタイプ
    dataNodeProductNameStringデータノードタイプ名
    dataNodeCountIntegerデータノード数
    clusterStatusStringクラスタの状態
    elasticSearchStatusStringElasticsearchの状態
    elasticSearchVersionStringElasticsearchバージョン
    softwareProductNameStringOS商品名
    createDateDate作成日時
    managerNodeTypeStringマネージャーノードタイプ
    managerNodeCountIntegerマネージャーノード数
    dataStorageVolumeSizeLongデータノードのストレージ容量
    managerNodeAccessControlGroupSequenceIntegerマネージャーノードのACG番号
    managerNodeAccessControlGroupNameStringマネージャーノードのACG名
    dataNodeAccessControlGroupSequenceIntegerデータノードのACG番号
    dataNodeAccessControlGroupNameStringデータノードのACG名
    elasticSearchHttpPortStringElasticsearch HTTP Port
    kibanaHttpPortStringKibana HTTP Port
    loginKeyNameString認証キー名
    serviceGroupInstanceNoStringクラスタインスタンス番号
    kibanaUserNameStringKibanaアクセスID
    memberNoStringお客様番号
    vpcNameStringサーバが位置しているVPC名
    vpcNoIntegerサーバが位置しているVPC番号
    managerNodeSubnetNameStringマネージャーノードが位置しているSubnet名
    managerNodeSubnetNoIntegerマネージャーノードが位置しているSubnet番号
    dataNodeSubnetNameStringデータノードが位置しているSubnet名
    dataNodeSubnetNoIntegerデータノードが位置しているSubnet名
    isDualManagerBooleanマネージャーノードの二重化有無
    isMasterOnlyNodeActivatedBooleanマスター専用ノードの有効化有無
    masterNodeAccessControlGroupSequenceIntegerマスターノードのACG番号
    masterNodeAccessControlGroupNameStringマスターノードのACG名
    masterNodeSubnetNameStringマスターノードが位置しているSubnet名
    masterNodeSubnetNoIntegerマスターノードが位置しているSubnet番号
    masterNodeTypeStringデータノードのタイプ
    masterNodeProductNameStringマスターノードのタイプ名
    masterNodeCountIntegerマスターノード数
    isPluginInstalledBooleanObject Storage Pluginのインストール有無
    accessKeyIdStringObject Storageアクセス用API Access Key

    レスポンス例

    {
      "code": 0,
      "message": "SUCCESS",
      "result": {
        "currentPage": 1,
        "isFirst": true,
        "isLast": true,
        "pageSize": 10,
        "totalCount": 1,
        "totalPage": 1,
        "allowedClusters": [
          {
            "clusterName": "openapitest11",
            "dataNodeType": "2vCPU, 4GB Mem",
            "dataNodeProductName": "vCPU2個、メモリ4GB、[SSD]ディスク50GB",
            "dataNodeCount": 3,
            "clusterStatus": "running",
            "elasticSearchStatus": "green",
            "elasticSearchVersion": "ElasticSearch-OSS 7.7.0",
            "softwareProductName": "CentOS 7.3 (64-bit)",
            "createDate": "2020-10-06 18:06:40",
            "managerNodeType": "2vCPU, 4GB Mem",
            "managerNodeCount": 2,
            "dataStorageVolumeSize": 322122547200,
            "managerNodeAccessControlGroupSequence": 62222,
            "managerNodeAccessControlGroupName": "elasticsearch-m-vtps",
            "dataNodeAccessControlGroupSequence": 62221,
            "dataNodeAccessControlGroupName": "elasticsearch-d-vtps",
            "elasticSearchHttpPort": "9200",
            "kibanaHttpPort": "5601",
            "loginKeyName": "testkey",
            "serviceGroupInstanceNo": "1484848",
            "kibanaUserName": "test",
            "memberNo": "774",
            "vpcName": "test",
            "vpcNo": 36752,
            "managerNodeSubnetName": "testpri | KR-1 | Private",
            "managerNodeSubnetNo": 22630,
            "dataNodeSubnetName": "testpri | KR-1 | Private",
            "dataNodeSubnetNo": 22630,
            "isPluginInstalled": true,
            "isDualManager": true,
            "accessKeyId": null,
            "isMasterOnlyNodeActivated": false,
            "masterNodeAccessControlGroupSequence": null,
            "masterNodeAccessControlGroupName": null,
            "masterNodeSubnetName": null,
            "masterNodeSubnetNo": null,
            "masterNodeType": null,
            "masterNodeProductName": null,
            "masterNodeCount": null,
          }
        ],
        "disallowedClusters": []
      },
      "requestId": "857c253d-a8b7-4795-983a-b50c15f180a2"
    }
    

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

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.