Rolling UpGrade の事前チェック

印刷する
共有
Twitter
Linkedin
Facebook
Email
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-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	Request body content typeを application/jsonに指定 `Content-Type: application/json`

リクエストパラメータ

パラメータ	タイプ	必須有無	説明
serviceGroupInstanceNo	Integer	Y	アップグレードする Cluster番号
upgradeKafkaVersionCode	Integer	Y	アップグレードする上位バージョンの kafkaVersionCode
upgradeConfigGroupNo	Integer	Y	アップグレードする上位バージョンの 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"
}

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

説明
リクエスト