Updated on 2025-12-31 GMT+08:00

Querying the Kafka Instance Version

Function

This API is used to query the Kafka instance version information.

Calling Method

For details, see Calling APIs.

URI

GET /v2/{project_id}/kafka/instances/{instance_id}/upgrade

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

Project ID. For details, see Obtaining a Project ID.

Constraints

N/A

Range

N/A

Default Value

N/A

instance_id

Yes

String

Definition

Instance ID. You can call the API for querying all instances to obtain the instance ID. The instance ID is in the response body.

Constraints

N/A

Range

N/A

Default Value

N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

current_version

String

Definition

Current version.

Range

N/A

latest_version

String

Definition

Latest version.

Range

N/A

Example Requests

GET https://{endpoint}/v2/{project_id}/kafka/instances/{instance_id}/upgrade

Example Responses

Status code: 200

Kafka instance version queried.

{
  "current_version" : "2.7.1-h0.cbu.dms.100.r0",
  "latest_version" : "2.7.1-h0.cbu.dms.101.r0"
}

Status Codes

Status Code

Description

200

Kafka instance version queried.

Error Codes

See Error Codes.