getCloudRedisInstanceList
    • PDF

    getCloudRedisInstanceList

    • PDF

    記事の要約

    VPC環境で利用できます。

    Cloud DB for Redisインスタンスリストを照会します。

    リクエスト

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

    メソッドURI
    GET, POST/getCloudRedisInstanceList

    リクエストヘッダ

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

    リクエストパラメータ

    パラメータの説明は次の通りです。

    フィールドタイプ必須の有無説明
    regionCodeStringOptional照会対象の Cloud DB for Redisインスタンスのリージョンコード
    • getRegionListを通じて確認
    • getRegionList照会結果の最初のリージョン(デフォルト)
    zoneCodeStringOptionalゾーンコードでフィルタリング
    vpcNoStringOptionalVPC番号でフィルタリング
    subnetNoStringOptionalSubnet番号でフィルタリング
    cloudRedisServiceNameStringOptionalCloud DB for Redisサービス名でフィルタリング
    cloudRedisInstanceNoList.NList<String>OptionalCloud DB for Redisインスタンス番号リスト
    • Cloud DB for Redisインスタンス番号でフィルタリング
    • getCloudRedisInstanceListを通じて確認
    • <例> cloudRedisInstanceNoList.1=1234&cloudRedisInstanceNoList.2=2345
    cloudRedisServerNameStringOptionalCloud DB for Redisサーバ名でフィルタリング
    cloudRedisServerInstanceNoList.NList<String>OptionalCloud DB for Redisサーバインスタンス番号リスト
    • Cloud DB for Redisサーバインスタンス番号でフィルタリング
    • getCloudRedisInstanceListを通じて確認
    • <例> cloudRedisServerInstanceNoList.1=1234&cloudRedisServerInstanceNoList.2=2345
    generationCodeStringOptionalサーバの世代コードでフィルタリング
    pageNoIntegerOptionalページングされた結果のページ番号
    • pageNopageSizeを利用してページング処理
    • 0 (最小)
    pageSizeIntegerConditionalページごとに表示する結果数
    • pageNopageSizeを利用してページング処理
    • pageNo入力時、必須
    • 1 (最小)
    responseFormatTypeStringOptionalレスポンス結果の形式
    • xml(デフォルト) | json

    リクエスト例

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

    curl --location --request GET 'https://ncloud.apigw.ntruss.com/vredis/v2/getCloudRedisInstanceList
    ?regionCode=KR
    &zoneCode=KR-1
    &vpcNo=****83
    &subnetNo=****91
    &cloudRedisServiceName=test-****
    &cloudRedisInstanceNoList.1=****511
    &cloudRedisServerName=test-****
    &cloudRedisServerInstanceNoList.1=****613
    &generationCode=G2
    &pageNo=0
    &pageSize=10'
    --header 'x-ncp-apigw-timestamp: {Timestamp}'
    --header 'x-ncp-iam-access-key: {Access Key}' 
    --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
    

    レスポンス

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

    レスポンスボディ

    レスポンスボディの詳細は、CloudRedisInstanceListをご参照ください。

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

    NAVERクラウドプラットフォームでで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

    レスポンス例

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

    • responseFormatType=jsonの場合
    {
        "getCloudRedisInstanceListResponse": {
            "totalRows": 1,
            "cloudRedisInstanceList": [
                {
                    "cloudRedisInstanceNo": "****511",
                    "cloudRedisServiceName": "test-****",
                    "cloudRedisInstanceStatusName": "running",
                    "cloudRedisInstanceStatus": {
                        "code": "CREAT",
                        "codeName": "CLOUD DATABASE(VPC) Created State"
                    },
                    "cloudRedisInstanceOperation": {
                        "code": "NULL",
                        "codeName": "CLOUD DATABASE(VPC) Null OP"
                    },
                    "isHa": true,
                    "generationCode": "G2",
                    "role": {
                        "code": "CLUSTER",
                        "codeName": "CLOUD REDIS(VPC) Cluster Role"
                    },
                    "cloudRedisServerInstanceList": [
                        {
                            "cloudRedisServerInstanceNo": "****613",
                            "cloudRedisServerName": "test-****-001-001-ehs",
                            "cloudRedisServerRole": {
                                "code": "M",
                                "codeName": "Master"
                            },
                            "cloudRedisServerInstanceStatusName": "running",
                            "cloudRedisServerInstanceStatus": {
                                "code": "RUN",
                                "codeName": "CLOUD DATABASE(VPC) Server Running State"
                            },
                            "cloudRedisServerInstanceOperation": {
                                "code": "NOOP",
                                "codeName": "CLOUD DATABASE(VPC) Server Null OP"
                            },
                            "regionCode": "KR",
                            "zoneCode": "KR-1",
                            "vpcNo": "****83",
                            "subnetNo": "****91",
                            "cpuCount": 4,
                            "memorySize": 1610612736
                        },
                        {
                            "cloudRedisServerInstanceNo": "****616",
                            "cloudRedisServerName": "test-****-002-001-eht",
                            "cloudRedisServerRole": {
                                "code": "M",
                                "codeName": "Master"
                            },
                            "cloudRedisServerInstanceStatusName": "running",
                            "cloudRedisServerInstanceStatus": {
                                "code": "RUN",
                                "codeName": "CLOUD DATABASE(VPC) Server Running State"
                            },
                            "cloudRedisServerInstanceOperation": {
                                "code": "NOOP",
                                "codeName": "CLOUD DATABASE(VPC) Server Null OP"
                            },
                            "regionCode": "KR",
                            "zoneCode": "KR-1",
                            "vpcNo": "****83",
                            "subnetNo": "****91",
                            "cpuCount": 4,
                            "memorySize": 1610612736
                        },
                        {
                            "cloudRedisServerInstanceNo": "****619",
                            "cloudRedisServerName": "test-****-003-001-ehu",
                            "cloudRedisServerRole": {
                                "code": "M",
                                "codeName": "Master"
                            },
                            "cloudRedisServerInstanceStatusName": "running",
                            "cloudRedisServerInstanceStatus": {
                                "code": "RUN",
                                "codeName": "CLOUD DATABASE(VPC) Server Running State"
                            },
                            "cloudRedisServerInstanceOperation": {
                                "code": "NOOP",
                                "codeName": "CLOUD DATABASE(VPC) Server Null OP"
                            },
                            "regionCode": "KR",
                            "zoneCode": "KR-1",
                            "vpcNo": "****83",
                            "subnetNo": "****91",
                            "cpuCount": 4,
                            "memorySize": 1610612736
                        },
                        {
                            "cloudRedisServerInstanceNo": "****622",
                            "cloudRedisServerName": "test-****-001-002-ehv",
                            "cloudRedisServerRole": {
                                "code": "S",
                                "codeName": "Slave"
                            },
                            "cloudRedisServerInstanceStatusName": "running",
                            "cloudRedisServerInstanceStatus": {
                                "code": "RUN",
                                "codeName": "CLOUD DATABASE(VPC) Server Running State"
                            },
                            "cloudRedisServerInstanceOperation": {
                                "code": "NOOP",
                                "codeName": "CLOUD DATABASE(VPC) Server Null OP"
                            },
                            "regionCode": "KR",
                            "zoneCode": "KR-1",
                            "vpcNo": "****83",
                            "subnetNo": "****91",
                            "cpuCount": 4,
                            "memorySize": 1610612736
                        },
                        {
                            "cloudRedisServerInstanceNo": "****625",
                            "cloudRedisServerName": "test-****-002-002-ehw",
                            "cloudRedisServerRole": {
                                "code": "S",
                                "codeName": "Slave"
                            },
                            "cloudRedisServerInstanceStatusName": "running",
                            "cloudRedisServerInstanceStatus": {
                                "code": "RUN",
                                "codeName": "CLOUD DATABASE(VPC) Server Running State"
                            },
                            "cloudRedisServerInstanceOperation": {
                                "code": "NOOP",
                                "codeName": "CLOUD DATABASE(VPC) Server Null OP"
                            },
                            "regionCode": "KR",
                            "zoneCode": "KR-1",
                            "vpcNo": "****83",
                            "subnetNo": "****91",
                            "cpuCount": 4,
                            "memorySize": 1610612736
                        },
                        {
                            "cloudRedisServerInstanceNo": "****628",
                            "cloudRedisServerName": "test-****-003-002-ehx",
                            "cloudRedisServerRole": {
                                "code": "S",
                                "codeName": "Slave"
                            },
                            "cloudRedisServerInstanceStatusName": "running",
                            "cloudRedisServerInstanceStatus": {
                                "code": "RUN",
                                "codeName": "CLOUD DATABASE(VPC) Server Running State"
                            },
                            "cloudRedisServerInstanceOperation": {
                                "code": "NOOP",
                                "codeName": "CLOUD DATABASE(VPC) Server Null OP"
                            },
                            "regionCode": "KR",
                            "zoneCode": "KR-1",
                            "vpcNo": "****83",
                            "subnetNo": "****91",
                            "cpuCount": 4,
                            "memorySize": 1610612736
                        }
                    ]
                }
            ],
            "requestId": "02c8adab-****-****-****-6d6b37885670",
            "returnCode": "0",
            "returnMessage": "success"
        }
    }
    
    • responseFormatType=xml(デフォルト)の場合
    <?xml version="1.0" encoding="UTF-8"?>
    <getCloudRedisInstanceListResponse>
        <requestId>02c8adab-****-****-****-6d6b37885670</requestId>
        <returnCode>0</returnCode>
        <returnMessage>success</returnMessage>
        <totalRows>1</totalRows>
        <cloudRedisInstanceList>
            <cloudRedisInstance>
                <cloudRedisInstanceNo>****511</cloudRedisInstanceNo>
                <cloudRedisServiceName>test-****</cloudRedisServiceName>
                <cloudRedisInstanceStatusName>running</cloudRedisInstanceStatusName>
                <cloudRedisInstanceStatus>
                    <code>CREAT</code>
                    <codeName>CLOUD DATABASE(VPC) Created State</codeName>
                </cloudRedisInstanceStatus>
                <cloudRedisInstanceOperation>
                    <code>NULL</code>
                    <codeName>CLOUD DATABASE(VPC) Null OP</codeName>
                </cloudRedisInstanceOperation>
                <isHa>true</isHa>
                <generationCode>G2</generationCode>
                <role>
                    <code>CLUSTER</code>
                    <codeName>CLOUD REDIS(VPC) Cluster Role</codeName>
                </role>
                <cloudRedisServerInstanceList>
                    <cloudRedisServerInstance>
                        <cloudRedisServerInstanceNo>****613</cloudRedisServerInstanceNo>
                        <cloudRedisServerName>test-****-001-001-ehs</cloudRedisServerName>
                        <cloudRedisServerRole>
                            <code>M</code>
                            <codeName>Master</codeName>
                        </cloudRedisServerRole>
                        <cloudRedisServerInstanceStatusName>running</cloudRedisServerInstanceStatusName>
                        <cloudRedisServerInstanceStatus>
                            <code>RUN</code>
                            <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                        </cloudRedisServerInstanceStatus>
                        <cloudRedisServerInstanceOperation>
                            <code>NOOP</code>
                            <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                        </cloudRedisServerInstanceOperation>
                        <regionCode>KR</regionCode>
                        <zoneCode>KR-1</zoneCode>
                        <vpcNo>****83</vpcNo>
                        <subnetNo>****92</subnetNo>
                        <cpuCount>4</cpuCount>
                        <memorySize>1610612736</memorySize>
                    </cloudRedisServerInstance>
                    <cloudRedisServerInstance>
                        <cloudRedisServerInstanceNo>****616</cloudRedisServerInstanceNo>
                        <cloudRedisServerName>test-****-002-001-eht</cloudRedisServerName>
                        <cloudRedisServerRole>
                            <code>M</code>
                            <codeName>Master</codeName>
                        </cloudRedisServerRole>
                        <cloudRedisServerInstanceStatusName>running</cloudRedisServerInstanceStatusName>
                        <cloudRedisServerInstanceStatus>
                            <code>RUN</code>
                            <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                        </cloudRedisServerInstanceStatus>
                        <cloudRedisServerInstanceOperation>
                            <code>NOOP</code>
                            <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                        </cloudRedisServerInstanceOperation>
                        <regionCode>KR</regionCode>
                        <zoneCode>KR-1</zoneCode>
                        <vpcNo>****83</vpcNo>
                        <subnetNo>****92</subnetNo>
                        <cpuCount>4</cpuCount>
                        <memorySize>1610612736</memorySize>
                    </cloudRedisServerInstance>
                    <cloudRedisServerInstance>
                        <cloudRedisServerInstanceNo>****619</cloudRedisServerInstanceNo>
                        <cloudRedisServerName>test-****-003-001-ehu</cloudRedisServerName>
                        <cloudRedisServerRole>
                            <code>M</code>
                            <codeName>Master</codeName>
                        </cloudRedisServerRole>
                        <cloudRedisServerInstanceStatusName>running</cloudRedisServerInstanceStatusName>
                        <cloudRedisServerInstanceStatus>
                            <code>RUN</code>
                            <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                        </cloudRedisServerInstanceStatus>
                        <cloudRedisServerInstanceOperation>
                            <code>NOOP</code>
                            <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                        </cloudRedisServerInstanceOperation>
                        <regionCode>KR</regionCode>
                        <zoneCode>KR-1</zoneCode>
                        <vpcNo>****83</vpcNo>
                        <subnetNo>****92</subnetNo>
                        <cpuCount>4</cpuCount>
                        <memorySize>1610612736</memorySize>
                    </cloudRedisServerInstance>
                    <cloudRedisServerInstance>
                        <cloudRedisServerInstanceNo>****622</cloudRedisServerInstanceNo>
                        <cloudRedisServerName>test-****-001-002-ehv</cloudRedisServerName>
                        <cloudRedisServerRole>
                            <code>S</code>
                            <codeName>Slave</codeName>
                        </cloudRedisServerRole>
                        <cloudRedisServerInstanceStatusName>running</cloudRedisServerInstanceStatusName>
                        <cloudRedisServerInstanceStatus>
                            <code>RUN</code>
                            <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                        </cloudRedisServerInstanceStatus>
                        <cloudRedisServerInstanceOperation>
                            <code>NOOP</code>
                            <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                        </cloudRedisServerInstanceOperation>
                        <regionCode>KR</regionCode>
                        <zoneCode>KR-1</zoneCode>
                        <vpcNo>****83</vpcNo>
                        <subnetNo>****92</subnetNo>
                        <cpuCount>4</cpuCount>
                        <memorySize>1610612736</memorySize>
                    </cloudRedisServerInstance>
                    <cloudRedisServerInstance>
                        <cloudRedisServerInstanceNo>****625</cloudRedisServerInstanceNo>
                        <cloudRedisServerName>test-****-002-002-ehw</cloudRedisServerName>
                        <cloudRedisServerRole>
                            <code>S</code>
                            <codeName>Slave</codeName>
                        </cloudRedisServerRole>
                        <cloudRedisServerInstanceStatusName>running</cloudRedisServerInstanceStatusName>
                        <cloudRedisServerInstanceStatus>
                            <code>RUN</code>
                            <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                        </cloudRedisServerInstanceStatus>
                        <cloudRedisServerInstanceOperation>
                            <code>NOOP</code>
                            <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                        </cloudRedisServerInstanceOperation>
                        <regionCode>KR</regionCode>
                        <zoneCode>KR-1</zoneCode>
                        <vpcNo>****83</vpcNo>
                        <subnetNo>****92</subnetNo>
                        <cpuCount>4</cpuCount>
                        <memorySize>1610612736</memorySize>
                    </cloudRedisServerInstance>
                    <cloudRedisServerInstance>
                        <cloudRedisServerInstanceNo>****628</cloudRedisServerInstanceNo>
                        <cloudRedisServerName>test-****-003-002-ehx</cloudRedisServerName>
                        <cloudRedisServerRole>
                            <code>S</code>
                            <codeName>Slave</codeName>
                        </cloudRedisServerRole>
                        <cloudRedisServerInstanceStatusName>running</cloudRedisServerInstanceStatusName>
                        <cloudRedisServerInstanceStatus>
                            <code>RUN</code>
                            <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                        </cloudRedisServerInstanceStatus>
                        <cloudRedisServerInstanceOperation>
                            <code>NOOP</code>
                            <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                        </cloudRedisServerInstanceOperation>
                        <regionCode>KR</regionCode>
                        <zoneCode>KR-1</zoneCode>
                        <vpcNo>****83</vpcNo>
                        <subnetNo>****92</subnetNo>
                        <cpuCount>4</cpuCount>
                        <memorySize>1610612736</memorySize>
                    </cloudRedisServerInstance>
                </cloudRedisServerInstanceList>
            </cloudRedisInstance>
        </cloudRedisInstanceList>
    </getCloudRedisInstanceListResponse>
    

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

    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.