Querying IP Addresses of a BMS (Native OpenStack API)

Function

This API is used to query private IP addresses of a BMS.

Constraints

Pagination query is not supported.

URI

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

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 Querying BMSs (Native OpenStack API).

Request

  • Request parameters

    None

  • Example request

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

Response

  • Response parameters

    Parameter

    Type

    Description

    addresses

    Map<String,Array of address objects>

    Specifies the VPC used by the BMS.

    • key: indicates the ID of the VPC used by the BMS.

    • value indicates the VPC details.

    Table 2 address 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

    {
        "addresses": {
            "08a7715f-7de6-4ff9-a343-95ba4209f24a": [
                {
                    "version": 4,
                    "addr": "192.168.2.90"
                }
            ]
        }
    }
    

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.