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-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.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"
}
이 문서가 도움이 되었습니까?