Updated on 2024-04-18 GMT+08:00

Querying the Networks of a Specified ECS

Function

This API is used to query the networks of an ECS.

Constraints

None

URI

GET /v2.1/{project_id}/servers/{server_id}/ips

Table 1 describes the parameters in the URI.
Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

For details about how to obtain the ID, see Obtaining a Project ID.

server_id

Yes

Specifies the ECS ID.

Request

None

Response

Table 2 describes the response parameters.

Table 2 Response parameters

Parameter

Mandatory

Type

Description

addresses

Yes

Object

Specifies the network address of the ECS. For details, see Table 3.

Table 3 addresses parameter structure description

Parameter

Mandatory

Type

Description

Network address of the ECS

Yes

Array of objects

Specifies the network where the ECS accesses. For details about the network parameter, see Table 4.

Table 4 ECS network parameter structure description

Attribute

Type

CRUD

Default Value

Constraint

Remarks

version

Integer

R

N/A

4 or 6

Specifies the IP address version. The value of this parameter can be 4 or 6.

addr

String

R

N/A

IP address format

Specifies the IP address.

Example Request

Query the networks of a specified ECS.

GET https://{endpoint}/v2.1/{project_id}/servers/{server_id}/ips

Example Response

{
    "addresses": {
        "Network address of the ECS": [
            {
                "version": 4,
                "addr": "10.176.42.16"
            },
            {
                "version": 6,
                "addr": "::babe:10.176.42.16"
            }
        ]
    }
}