MENU
      Usage Planと関連付けられた Stageの照会

        Usage Planと関連付けられた Stageの照会


        記事の要約

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

        指定した APIに属する Stageの中で、特定の Usage Planが関連付けられた Stageを照会します。

        リクエスト

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

        メソッドURI
        POST/products/{product-id}/apis/{api-id}/stages/search

        リクエストヘッダ

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

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

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

        フィールドタイプ必須の有無説明
        product-idStringRequiredAPIが属する Product ID
        api-idStringRequiredStage照会対象の API ID

        リクエスト構文

        リクエスト構文は次の通りです。

        {
            "usagePlanId" : "usagePlanId"
        }
        JSON

        リクエストボディ

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

        フィールドタイプ必須の有無説明
        usagePlanIdStringRequiredStage照会対象の Usage Plan ID

        リクエスト例

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

        curl --location --request POST 'https://apigateway.apigw.ntruss.com/api/v1/products/***ksk9***/apis/***51hs***/stages/search' \
        --header 'x-ncp-apigw-timestamp: {Timestamp}' \
        --header 'x-ncp-iam-access-key: {Access Key}' \
        --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
        --header 'Content-Type: application/json' \
        --data '{
            "usagePlanId" : "***833g***"
        }'
        Curl

        レスポンス

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

        レスポンス構文

        レスポンス構文は次の通りです。

        {
            "stages" : [ {
                "stageName" : "stageName",
                "stageId" : "stageId"
            } ]
        }
        JSON

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

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

        レスポンス例

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

        {
            "stages": [
                {
                    "stageId": "***fh5o***",
                    "stageName": "stage000"
                },
                {
                    "stageId": "***5ei7***",
                    "stageName": "stage"
                }
            ]
        }
        JSON

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

        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.