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> Asignación de una dirección IP flotante

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

Ver PDF

Asignación de una dirección IP flotante

Función

Al asignar una dirección IP flotante, debe obtener el ID de red externa floating_network_id de la dirección IP flotante.

Puede usar GET /v2.0/networks?router:external=True o ejecutar el comando neutron net-external-list para obtener el UUID de la red externa necesaria para asignar una dirección IP flotante.

URI

POST /v2.0/floatingips

Mensaje de solicitud

**Tabla 1** 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.

**Tabla 2** Parámetro de solicitud
Parámetro	Tipo	Obligatorio	Descripción
floatingip	floatingip object	Sí	Especifica la lista de direcciones IP flotante. Para más detalles, consulte Tabla 3.

**Tabla 3** Objetos **floatingip**
Parámetro	Obligatorio	Tipo	Descripción
floating_ip_address	No	String	Especifica la dirección IP flotante.
floating_network_id	Sí	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 ejecutar el comando neutron net-external-list mode para obtener información sobre la red externa.
port_id	No	String	Especifica el ID de puerto.
fixed_ip_address	No	String	Especifica la dirección IP privada del puerto asociado.

Mensaje de la respuesta

**Tabla 4** 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 5.

**Tabla 5** 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.
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.

Por ejemplo:

Ejemplo de la solicitud

POST https://{Endpoint}/v2.0/floatingips 

{
    "floatingip": {
           "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975"
    }
}

Ejemplo de la respuesta

{
    "floatingip": {
        "id": "b997e0d4-3359-4c74-8f88-bc0af81cd5a2",
        "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": "88.88.215.205",
        "port_id": null,
        "created_at": "2018-09-20T02:10:02",
        "updated_at": "2018-09-20T02:10:02"
    }
}