MENU
      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/rollingUpgrade [KR]
        POST https://clouddatastreamingservice.apigw.ntruss.com/api/sgn-v1/cluster/rollingUpgrade [SGN]
        POST https://clouddatastreamingservice.apigw.ntruss.com/api/jpn-v1/cluster/rollingUpgrade [JPN]
        HTTP

        요청 헤더

        헤더명설명
        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-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/rollingUpgrade
        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
        }
        HTTP
        curl -X 'POST' \
          'https://clouddatastreamingservice.beta-apigw.ntruss.com/api/v1/cluster/rollingUpgrade' \
          -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
        }'
        Bash

        응답 예시

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

        오류 응답 예시

        {
          "code": 10153,
          "message": "업데이트된 Kafka 버전은 현재 클러스터 버전보다 이후여야 합니다.",
          "result": null,
          "requestId": "251afd18-167c-4ce6-9b91-81831013ee88"
        }
        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.