Upgrade version

Available in VPC

Upgrade the Kafka version of a Cloud Data Streaming Service cluster using the rolling method. Before upgrading, make sure to Check version upgrade availability.

Caution

Please note the following when upgrading.

Select the appropriate config group for your version.
If there are topics being replicated, you can proceed after replication is complete.
Upgrade may cause data loss or intermittent interruptions.

Request

This section describes the request format. The method and URI are as follows:

Method	URI
POST	/api/v1/cluster/rollingUpgrade (Korea Region)
POST	/api/sgn-v1/cluster/rollingUpgrade (Singapore Region)
POST	/api/jpn-v1/cluster/rollingUpgrade (Japan Region)

Request headers

For information about the headers common to all Cloud Data Streaming Service APIs, see Cloud Data Streaming Service request headers.

Request body

You can include the following data in the body of your request:

Field	Type	Required	Description
`serviceGroupInstanceNo`	Integer	Required	Cluster instance number See Get cluster list.
`upgradeKafkaVersionCode`	Integer	Required	Kafka version code See Get version.
`upgradeConfigGroupNo`	Integer	Required	Config group number of the upgrade Kafka version See Get config group list. If there is no config group created with the applicable version, Create config group.

Request example

The request example is as follows:

curl --location --request POST 'https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/rollingUpgrade' \
--header 'Content-Type: application/json' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--data '{
  "serviceGroupInstanceNo": 1009*****,
  "upgradeKafkaVersionCode": 3713006,
  "upgradeConfigGroupNo": 3**
}'

Response

This section describes the response format.

Response body

The response body includes the following data:

Field	Type	Required	Description
`code`	Integer	-	Response code
`message`	String	-	Response message
`result`	Boolean	-	Response result `true` \| `null` `true`: succeeded `null`: failed
`requestId`	String	-	ID for the request UUID format

Response status codes

For information about the HTTP status codes common to all Cloud Data Streaming Service APIs, see Cloud Data Streaming Service response status codes.

Response example

The response example is as follows:

{
    "code": 0,
    "message": "SUCCESS",
    "result": true,
    "requestId": "b07a66de-****-****-****-49e8ba031d2c"
}