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

Querying RocketMQ Configurations

Function

This API is used to query RocketMQ configurations. Configuration details will be returned.

URI

GET /v2/{project_id}/rocketmq/instances/{instance_id}/configs

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

Project ID. For details about how to obtain it, 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

total

Number

Definition

Total number.

Range

N/A

next_offset

Integer

Definition

Offset of the next page.

Range

N/A

previous_offset

Integer

Definition

Offset of the previous page.

Range

N/A

rocketmq_configs

Array of RocketMQConfigResp objects

Definition

RocketMQ configuration.

Table 3 RocketMQConfigResp

Parameter

Type

Description

name

String

Definition

RocketMQ configuration name.

Range

N/A

value

String

Definition

RocketMQ configuration current value.

Range

N/A

config_type

String

Definition

RocketMQ configuration type.

Range

  • dynamic

  • static

default_value

String

Definition

RocketMQ configuration default value.

Range

N/A

valid_values

String

Definition

RocketMQ configuration value range.

Range

N/A

value_type

String

Definition

RocketMQ configuration value type.

Range

  • integer

  • boolean

Example Requests

GET  https://{endpoint}/v2/{project_id}/rocketmq/instances/{instance_id}/configs

Example Responses

Status code: 200

Successful.

{
  "total" : 1,
  "next_offset" : -1,
  "previous_offset" : -1,
  "rocketmq_configs" : [ {
    "name" : "fileReservedTime",
    "value" : 48,
    "config_type" : "dynamic",
    "default_value" : 48,
    "valid_values" : "1~720",
    "value_type" : "integer"
  } ]
}

Status Codes

Status Code

Description

200

Successful.

Error Codes

See Error Codes.