Querying the Networks of a Specified ECS¶

Function¶

This API is used to query the networks of a specified ECS.

Constraints¶

None

URI¶

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

GET /v2/{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.
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/{project_id}/servers/{server_id}/ips
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"
            }
        ]
    }
}

Returned Values¶

See Returned Values for General Requests.

last updated: 2025-04-21 14:56 UTC - commit: 5daaab80a92ea2ed09734ccede9bee51a7c8bd9a