Zaoxu, Li 4edaa4a4cc ECS API 20231016 version

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

2024-04-29 11:04:13 +00:00

19 KiB

Raw Blame History

Querying NICs of an ECS

Function

This API is used to query NICs of an ECS.

URI

GET /v1/{project_id}/cloudservers/{server_id}/os-interface

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	Type	Description
interfaceAttachments	Array of objects	Specifies ECS NICs. For details, see Table 3.
attachableQuantity	Object	Specifies the number of NICs that can be attached to an ECS. For details, see Table 4.

**Table 3** **interfaceAttachments** field description
Parameter	Type	Description
port_state	String	Specifies the NIC port status.
fixed_ips	Array of objects	Specifies private IP addresses for NICs. For details, see Table 5.
net_id	String	Specifies the network ID to which the NIC port belongs.
port_id	String	Specifies the NIC port ID.
mac_addr	String	Specifies the MAC address of the NIC.
delete_on_termination	Boolean	Specifies whether to delete a NIC when detaching it. true: The NIC will be deleted. false: The NIC will not be deleted.
driver_mode	String	Specifies the NIC driver type, which is virtio by default. This parameter is a reserved field.
min_rate	Integer	Specifies the minimum NIC bandwidth.
multiqueue_num	Integer	Specifies the number of queues. The value can be 1, 2, 4, 8, 16, or 28.
pci_address	String	Specifies the BDF number of the NIC in Linux GuestOS. NOTE: If the NIC is not supported, no information will be returned.

**Table 4** **attachableQuantity** field description
Parameter	Type	Description
free_nic	Integer	Specifies the remaining number of NICs that can be attached to an ECS.
free_efi_nic	Integer	Specifies the remaining number of EFIs that can be attached to an ECS.

**Table 5** **fixed_ips** field description
Parameter	Type	Description
subnet_id	String	Specifies the subnet of the NIC private IP address.
ip_address	String	Specifies the NIC private IP address.

Example Request

Query NICs of an ECS.

GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-interface

Example Response

{
    "attachableQuantity": {
        "free_nic": 1,
        "free_efi_nic": 0
    },
    "interfaceAttachments": [
        {
            "port_state": "ACTIVE",
            "fixed_ips": [
                {
                    "subnet_id": "ba31e1f5-fa76-4530-862c-5176fad033cf",
                    "ip_address": "192.168.0.33"
                }
            ],
            "net_id": "610a4af2-1d90-4d2b-8057-dc238b26febf",
            "port_id": "04819c0a-6a07-44b6-945e-fb932071888e",
            "mac_addr": "fa:16:3e:45:65:c4",
            "delete_on_termination": false,
            "driver_mode": null,
            "min_rate": null,
            "multiqueue_num": null,
            "pci_address": null
        }
    ]
}

Returned Values

See Returned Values for General Requests.

Parent topic: NIC Management

19 KiB Raw Blame History