Help Center/ Cloud Service Engine/ API Reference/ ServiceComb API/ Microservice Instance/ Querying a Microservice Instance Based on service_id
Updated on 2023-11-08 GMT+08:00

Querying a Microservice Instance Based on service_id

Function

This API is used to query all instances of a microservice based on service_id after the instances are registered.

URI

GET /v4/{project_id}/registry/microservices/{service_id}/instances

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Fixed value: default.

service_id

Yes

String

Microservice ID, which must be unique. The value contains 1 to 64 characters. Regular expression: ^.*$. See Querying Information About All Microservices.

Table 2 Query parameter

Parameter

Mandatory

Type

Description

tags

No

String

Tag. When there are multiple tags, separate them using commas (,). Regular expression: ^[a-zA-Z][a-zA-Z0-9_-.]{0,63}$

Request

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-ConsumerId

No

String

Microservice consumer ID, which must be unique.

Authorization

No

String

This parameter is mandatory if security authentication is enabled for an exclusive ServiceComb engine. Otherwise, this parameter is not required.

The token of an exclusive ServiceComb engine with security authentication enabled is in the following format:

Authorization:Bearer {Token}

For details about how to obtain the token, see Obtaining the User Token of an Exclusive ServiceComb Engine.

Response

Status code: 200

Table 4 Response body parameter

Parameter

Type

Description

instances

Array of MicroServiceInstance objects

Instance list.

Table 5 MicroServiceInstance

Parameter

Type

Description

instanceId

String

Instance ID, which must be unique. The instance ID is generated by the service center.

serviceId

String

Microservice ID, which must be unique. During instance creation, use the microservice ID in the URL instead of the microservice ID specified here.

version

String

Microservice version.

hostName

String

Host information.

endpoints

Array of strings

Access address information.

status

String

Instance status. Value: UP, DOWN, STARTING, or OUTOFSERVICE. Default value: UP.

properties

Object

Extended attribute. You can customize a key and value. The value must be at least 1 byte long.

healthCheck

HealthCheck object

Health check information.

dataCenterInfo

DataCenterInfo object

Data center information.

timestamp

String

Time when an instance is created, which is automatically generated.

modTimestamp

String

Update time.

Table 6 HealthCheck

Parameter

Type

Description

mode

String

Heartbeat mode. Value: push or pull.

port

Integer

Port.

interval

Integer

Heartbeat interval. Unit: s. If the value is less than 5s, the registration is performed at an interval of 5s.

times

Integer

Maximum retries.

Table 7 DataCenterInfo

Parameter

Type

Description

name

String

Region name.

region

String

Region.

availableZone

String

AZ.

Status code: 400

Table 8 Response body parameters

Parameter

Type

Description

errorCode

String

Error code.

errorMessage

String

Error message.

detail

String

Location details.

Status code: 500

Table 9 Response body parameters

Parameter

Type

Description

errorCode

String

Error code.

errorMessage

String

Error message.

detail

String

Location details.

Example Request

Query instance information about a microservice with specified service_id.

GET https://{endpoint}/v4/{project_id}/registry/microservices/{service_id}/instances

Example Response

Status code: 200

Successfully queried.

{
    "instances": [
        {
            "instanceId": "8540bb8b693c4ad1a7fb6a756c415244",
            "serviceId": "8aed80ea052ac04a64dfc79c24f2170224d074f5",
            "endpoints": [
                "rest:127.0.0.1:8080"
            ],
            "hostName": "hostNameTest",
            "status": "UP",
            "properties": {
                "engineID": "30c263e5-2eac-4da1-9c72-5abb9ac94550",
                "engineName": "cse-fkln1-HA"
            },
            "healthCheck": {
                "mode": "push",
                "interval": 30,
                "times": 3
            },
            "timestamp": "1650545035",
            "modTimestamp": "1650545035",
            "version": "1.0.0"
        }
    ]
}

Status Code

Status Code

Description

200

OK

400

Bad Request

500

Internal Server Error

Error Code

See ServiceComb Error Codes.