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
Compartir

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"
    }
}

Código de estado

Consulte Códigos de estado

Tema principal: Dirección IP flotante