Rolling UpGrade の事前チェック
    • PDF

    Rolling UpGrade の事前チェック

    • PDF

    記事の要約

    VPC環境で利用できます。

    説明

    Cloud Data Streaming Serviceの Clusterで使用している Kafkaのバージョンを順次アップグレードするため、事前に可能かどうかを確認します。

    注意

    アップグレード時に注意すべき事項は、次の通りです。

    • ConfigGroupをバージョンに合わせて選択してください。
    • クローン中の topicがある場合、先に解決しないと次に進めません。
    • ローリングアップグレード中にデータ消失や断続的な瞬断が発生する場合があります。

    リクエスト

    リクエスト URL

    POST https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/rollingUpgradePreCheck [KR]
    POST https://clouddatastreamingservice.apigw.ntruss.com/api/sgn-v1/cluster/rollingUpgradePreCheck [SGN]
    POST https://clouddatastreamingservice.apigw.ntruss.com/api/jpn-v1/cluster/rollingUpgradePreCheck [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-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-TypeRequest body content typeを application/jsonに指定
    Content-Type: application/json

    リクエストパラメータ

    パラメータタイプ必須有無説明
    serviceGroupInstanceNoIntegerYアップグレードする Cluster番号
    upgradeKafkaVersionCodeIntegerYアップグレードする上位バージョンの kafkaVersionCode
    upgradeConfigGroupNoIntegerYアップグレードする上位バージョンの kafkaVersionに合わせて作成された KafkaconfigGroup番号

    リクエスト例

    POST https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/rollingUpgradePreCheck
    HOST: clouddatastreamingservice.apigw.ntruss.com
    Content-Type: application/json
    x-ncp-apigw-signature-v2: fC/exK+2vx8RSdIWAOePNakOOCp3BO3qy8XHzso15gI=
    x-ncp-apigw-timestamp: 1709716893293
    x-ncp-iam-access-key: ANJNnR1jz1gUzaiS0aV2
    {
      "serviceGroupInstanceNo": 3432149,
      "upgradeKafkaVersionCode": 2823006,
      "upgradeConfigGroupNo": 170
    }
    
    curl -X 'POST' \
      'https://clouddatastreamingservice.beta-apigw.ntruss.com/api/v1/cluster/rollingUpgradePreCheck' \
      -H 'accept: application/json' \
      -H 'Content-Type: application/json' \
      -H 'x-ncp-iam-access-key: ANJNnR1jz1gUzaiS0aV2' \
      -H 'x-ncp-apigw-timestamp: 1709716893293' \
      -H 'x-ncp-apigw-signature-v2: fC/exK+2vx8RSdIWAOePNakOOCp3BO3qy8XHzso15gI=' \
      -d '{
      "serviceGroupInstanceNo": 3432149,
      "upgradeKafkaVersionCode": 2823006,
      "upgradeConfigGroupNo": 170
    }'
    

    レスポンス例

    {
      "code": 0,
      "message": "SUCCESS",
      "result": true,
      "requestId": "ec3559a4-00c8-42c7-ac87-6a60ba4df08e"
    }
    

    エラーレスポンス例

    {
      "code": 10153,
      "message": "アップデートされた Kafkaのバージョンは、現在のクラスタバージョン以降である必要があります。",
      "result": null,
      "requestId": "251afd18-167c-4ce6-9b91-81831013ee88"
    }
    

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

    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.