Files

wanghuijuan738 69783f9e3e bms api 20241225 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-07-16 09:58:55 +00:00

16 KiB

Raw Blame History

Querying the Specified IP Address of a BMS

Function

This API is used to query the specified IP address of a BMS based on the network name.

URI

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

Table 1 lists the parameters.

**Table 1** Parameter description
Parameter	Mandatory	Description
project_id	Yes	Specifies the project ID. For how to obtain the project ID, see Obtaining Required Information.
server_id	Yes	Specifies the BMS ID. You can obtain the BMS ID from the BMS console or by calling the API Querying BMSs.
vpc_id	Yes	Specifies the ID of the VPC where the BMS is located.

Request Parameters

None

Example Request

Querying the IP address of a BMS (ID: 95bf2490-5428-432c-ad9b-5e3406f869dd) in a specified VPC

1
GET https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/ips/{vpc_id}

Response Parameters

Parameter	Type	Description
Vpc_id	Array of address objects	Specifies the VPC used by the BMS. Vpc_id indicates the ID of the VPC used by the BMS.

Parameter

Type

Description

Vpc_id

Array of address objects

Specifies the VPC used by the BMS.

Vpc_id indicates the ID of the VPC used by the BMS.

**Table 2** Network parameter structure description
Parameter	Type	Description
version	Integer	Specifies the IP address version. The value can be: 4: IPv4 address 6: IPv6 address
addr	String	Specifies the IP address.

Example Response

1
2
3
4
5
6
7
8
{
    "5849fdf1-9d79-4589-80c2-fe557990c417": [
        {
            "version": 4,
            "addr": "192.168.1.159"
        }
    ]
}

Returned Values

Normal values

Returned Values	Description
200	The request has been successfully processed.

For details about other returned values, see Status Codes.

Error Codes

See Error Codes.

Parent topic: BMS IP Address Query (OpenStack Nova APIs)

16 KiB Raw Blame History