Consulta das NIC de um ECS
Função
Essa API é usada para consultar as NIC de um ECS.
URI
GET /v1/{project_id}/cloudservers/{server_id}/os-interface
Parâmetro |
Obrigatório |
Descrição |
---|---|---|
project_id |
Sim |
Especifica a ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto. |
server_id |
Sim |
Especifica a ID de ECS. |
Solicitação
Nenhum
Resposta
Parâmetro |
Tipo |
Descrição |
---|---|---|
interfaceAttachments |
Array of objects |
Especifica as NIC do ECS. Para mais detalhes, consulte Tabela 3. |
attachableQuantity |
Object |
Especifica o número de NICs que podem ser anexadas a um ECS. Para mais detalhes, consulte Tabela 4. |
Parâmetro |
Tipo |
Descrição |
---|---|---|
port_state |
String |
Especifica o status da porta NIC. |
fixed_ips |
Array of objects |
Especifica endereços IP privados para as NIC. Para mais detalhes, consulte Tabela 5. |
net_id |
String |
Especifica a ID de rede à qual a porta NIC pertence. |
port_id |
String |
Especifica a ID da porta NIC. |
mac_addr |
String |
Especifica o endereço MAC da NIC. |
delete_on_termination |
Boolean |
Especifica se uma NIC deve ser excluída ao desanexá-la. true: A NIC será excluída. false: A NIC não será excluída. |
driver_mode |
String |
Especifica o tipo de driver NIC no SO convidado. O valor pode ser virtio ou hinic. O valor padrão é virtio. |
min_rate |
Integer |
Especifica a largura de banda mínima da NIC. |
multiqueue_num |
Integer |
Especifica o número de filas. O valor pode ser 1, 2, 4, 8, 16, ou 28. |
pci_address |
String |
Especifica o número BDF da interface de rede no Linux GuestOS.
NOTA:
Se a NIC não for suportada, nenhuma informação será retornada. |
Exemplo de solicitação
GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-interface
Exemplo de resposta
{ "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" } ] }