Distributed Message Service RocketMQ

Querying the Instance List

2024-07-04 06:26:55

API Introduction

Used to query information about the message service instance list.

API Restrictions

None.

URl

GET       https://[endpoint]/v2/instance/list

Request Parameters

None.

Response Parameter

Response Parameter

Parameter Type

Description

statusCode

String

The status code of the interface on   the system layer. Success: 800; failure: 900.

message

String

Status Description

returnObj

String

Return the object. The parameters   included in this parameter are described in the comments in Response   Examples.

Description of Return Value returnObj

Response Parameter

Parameter Type

Description

prodInstList

List

Instance   List

Description of Return Value prodInstList

Response Parameter

Parameter Type

Description

prodInstId

String

Instance   ID

billMode

String

Billing   Modes

1:   subscription-based

2:   pay-as-you-go

prodInstName

String

Instance   Name

runningState

String

Instance   Status:

Running

Unsubscribed

prodType

String

Specification   Name

machineSpec

String

ECS   Type

tpsLimit

String

TPS   Peak

topicLimit

String

Max   Number of Topics

diskSpace

String

Disk   Space

netName

String

Network   Name

subnet

String

Subnet

securityGroup

String

Security   Group

expTime

Long

Expired   at

crtTime

Long

Created   at

Sample Request

GET https://[endpoint]/v2/instance/list

Examples of a Successful Response

{

    "returnObj":{

        "prodInstList":[

            {

                "prodInstId":"mq_test",

                "billMode":null,

                "prodInstName":"ctgmq_mq_test",

                "runningState":"Running",

                "prodType":"Others",

                "machineSpec":"4-core 16G",

                "tpsLimit":"20000",

                "topicLimit":"500",

                "diskSpace":"1000G",

                "netName":null,

                "subnet":null,

                "securityGroup":null,

                "expTime":1661858790649,

                "crtTime":1652841984000

            }

        ]

    },

    "message":"success",

    "statusCode":800

}

Example of a Failed Response

{

    "returnObj": {},

    "message": "...",

    "statusCode": "900"

}


hd83EYiVETaE