Rolling UpGrade 요청
    • PDF

    Rolling UpGrade 요청

    • PDF

    기사 요약

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

    설명

    Cloud Data Streaming Service의 Cluster에서 사용 중인 Kafka 버전을 순차적으로 업그레이드합니다.

    주의

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

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

    요청

    요청 URL

    POST https://fin-clouddatastreamingservice.apigw.fin-ntruss.com/api/v1/cluster/rollingUpgrade
    

    요청 헤더

    헤더명설명
    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://fin-clouddatastreamingservice.apigw.fin-ntruss.com/api/v1/cluster/rollingUpgrade
    HOST: fin-clouddatastreamingservice.apigw.fin-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://fin-clouddatastreamingservice.apigw.fin-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
    }'
    

    응답 예시

    {
      "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.