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.

Centro de ayuda> Elastic IP> Referencia de la API> API nativa de OpenStack Neutron V2.0> Dirección IP flotante> Consulta de direcciones IP flotantes

Actualización más reciente 2022-11-08 GMT+08:00

Ver PDF

Consulta de direcciones IP flotantes

Función

Esta API se utiliza para consultar todas las direcciones IP flotantes accesibles para el tenant que envía la solicitud. Se puede devolver un máximo de 2000 registros para cada operación de consulta. Si el número de registros es superior a 2000, se devolverá el marcador de paginación. Para obtener más información, consulte la sección Paginación.

Puede consultar la información detallada sobre una dirección IP flotante especificada mediante la API para consulta de una dirección IP flotante.

URI

GET /v2.0/floatingips

Tabla 1 describe los parámetros.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Tipo	Descripción
id	No	String	Especifica el ID de dirección IP flotante.
floating_ip_address	No	String	Especifica la dirección IPv4 flotante.
floating_network_id	No	String	Especifica el ID de red externa. Solo puede utilizar una red externa fija. Puede usar GET /v2.0/networks?router:external=True o GET /v2.0/networks?name={floating_network} o ejecute el comando neutron net-external-list para obtener información sobre la red externa.
router_id	No	String	Especifica el ID del enrutador perteneciente.
port_id	No	String	Especifica el ID de puerto.
fixed_ip_address	No	String	Especifica la dirección IP privada del puerto asociado.
tenant_id	No	String	Especifica el ID del proyecto.
limit	Integer	No	Especifica un ID de recurso para la consulta de paginación, que indica que la consulta comienza desde el siguiente registro del ID de recurso especificado. Este parámetro puede funcionar junto con el límite de parámetro. Si no se pasan los parámetros de marcador y límite, se devolverán los registros de recursos de la primera página. Si el marcador de parámetro no se pasa y el valor del límite de parámetro se establece en 10, se devolverán los primeros 10 registros de recursos. Si el valor del marcador de parámetro se establece en el ID de recurso del 10º registro y el valor del límite de parámetro se establece en 10, se devolverán los registros de recursos del 11º al 20º. Si el valor del marcador de parámetro se establece en el ID de recurso del 10º registro y no se pasa el límite de parámetro, se devolverán los registros de recursos que comienzan desde el 11º registro (incluido el 11º).
marker	String	No	Especifica el número de registros que se devolverán en cada página. El valor es de 0 a intmax. se puede utilizar junto con el marcador. Para obtener más información, consulte la descripción de parámetros del marcador.
page_reverse	Boolean	No	Especifica la dirección de la página. El valor puede ser True o False.

Por ejemplo:

GET https://{Endpoint}/v2.0/floatingips?id={fip_id}&router_id={router_id}&floating_network_id={net_id}&floating_ip_address={floating_ip}&port_id={port_id}&fixed_ip_address={fixed_ip}&tenant_id={tenant_id}

mensaje de solicitud

**Tabla 2** Parámetro de cabecera de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	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 3** Parámetro de respuesta
Parámetro	Tipo	Descripción
floatingips	Array of floatingip objects	Especifica la lista de direcciones IP flotante. Para más detalles, consulte Tabla 4.
floatingips_links	Array of floatingips_link objects	Especifica la lista de objetos de direcciones IP flotantes. Para más detalles, consulte Tabla 5. Solo cuando se utiliza limit para filtrar y el número de recursos excede el valor de limit o 2000 (valor predeterminado de limit), se devolverá el valor next para rel y un enlace para href.

**Tabla 4** Objetos **floatingip**
Parámetro	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

**Tabla 5** Objeto **floatingips_link**
Parámetro	Tipo	Descripción
href	String	Especifica el enlace API.
rel	String	Especifica la relación entre el enlace de API y la versión de API.

Por ejemplo:

Ejemplo de la solicitud

GET https://{Endpoint}/v2.0/floatingips?limit=1

Ejemplo de la respuesta

{
    "floatingips": [
        {
            "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"
        }
    ]
}