Files

wanghuijuan738 0d02528aaa ECS api 20241223 version

Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Co-authored-by: wanghuijuan738 <wanghuijuan738@huawei.com>
Co-committed-by: wanghuijuan738 <wanghuijuan738@huawei.com>

2025-01-16 16:29:19 +00:00

13 KiB

Raw Blame History

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.

Parent topic: Network Management

13 KiB Raw Blame History