Rolling UpGrade 사전 체크

Prev Next

VPC 환경에서 이용 가능합니다.

설명

Cloud Data Streaming Service의 Cluster에서 사용 중인 Kafka 버전을 순차적으로 업그레이드하기 위해 사전에 가능 여부를 체크합니다.

주의

업그레이드 시 주의해야 할 사항은 다음과 같습니다.

  • ConfigGroup 을 버전에 맞게 선택해 주십시오.
  • 복제 중인 topic이 있는 경우, 먼저 해결이 되어야 다음 진행이 가능합니다.
  • 롤링 업그레이드 중 데이터 유실이나 간헐적인 순단이 발생할 수 있습니다.

요청

요청 URL

POST https://clouddatastreamingservice.apigw.gov-ntruss.com/api/v1/cluster/rollingUpgradePreCheck [수도권]
POST https://clouddatastreamingservice.apigw.gov-ntruss.com/api/krs-v1/cluster/rollingUpgradePreCheck [남부권]

요청 헤더

헤더명 설명
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 네이버 클라우드 플랫폼 포털에서 발급받은 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.gov-ntruss.com/api/v1/cluster/rollingUpgradePreCheck
HOST: clouddatastreamingservice.apigw.gov-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.apigw.gov-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"
}