Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2022-11-08 GMT+08:00

Consulta de una dirección IP flotante

Función

Esta API se utiliza para consultar detalles sobre una dirección IP flotante especificada, incluido el estado de la dirección IP flotante, el ID del router al que pertenece la dirección IP flotante y el ID de red externa de la dirección IP flotante.

URI

GET /v2.0/floatingips/{floatingip_id}

Mensaje de solicitud

Tabla 1 Parámetro de cabecera de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

String

Especifica el token de usuario. El token se puede obtener llamando a la API de IAM utilizada para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el token de usuario.

Mensaje de la respuesta

Tabla 2 Parámetro de respuesta

Parámetro

Tipo

Descripción

floatingip

floatingip object

Especifica la lista de direcciones IP flotante. Para más detalles, consulte Tabla 3.

Tabla 3 Objetos floatingip

Atributo

Tipo

Descripción

status

String

Especifica el estado de la dirección IP flotante. El valor puede ser ACTIVE, DOWN o ERROR.

  • DOWN indica que la dirección IP flotante no se ha enlazado.
  • ACTIVE indica que la dirección IP flotante se ha enlazado.
  • ERROR indica que la dirección IP flotante es anormal.

id

String

Especifica el ID de dirección IP flotante.

project_id

String

Especifica el ID del proyecto.

floating_ip_address

String

Especifica la dirección IP flotante.

floating_network_id

String

Especifica el ID de red externa.

router_id

String

Especifica el ID del enrutador perteneciente.

port_id

String

Especifica el ID de puerto.

fixed_ip_address

String

Especifica la dirección IP privada del puerto asociado.

tenant_id

String

Especifica el ID del proyecto.

dns_name

String

Especifica el nombre de DNS.

Este parámetro solo está disponible en la región CN South-Guangzhou.

dns_domain

String

Especifica el dominio de DNS.

Este parámetro solo está disponible en la región CN South-Guangzhou.

created_at

String

Especifica la hora a la que se creó la dirección IP flotante.

Se utiliza el tiempo UTC.

Formato: yyyy-MM-ddTHH:mm:ss

updated_at

String

Especifica la hora a la que se actualizó la dirección IP flotante.

Se utiliza el tiempo UTC.

Formato: yyyy-MM-ddTHH:mm:ss

Por ejemplo:

Ejemplo de la solicitud

GET https://{Endpoint}/v2.0/floatingips/1a3a2818-d9b4-4a9c-8a19-5252c499d1cd

Ejemplo de la respuesta

{
    "floatingip": {
        "id": "1a3a2818-d9b4-4a9c-8a19-5252c499d1cd",
        "status": "DOWN",
        "router_id": null,
        "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
        "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
        "fixed_ip_address": null,
        "floating_ip_address": "99.99.99.84",
        "port_id": null,
        "created_at": "2017-10-19T12:21:28",
        "updated_at": "2018-07-30T12:52:13"
    }
}

Código de estado

Consulte Códigos de estado