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/ Las API/ Elastic IP/ Consulta de un EIP

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

Ver PDF

Consulta de un EIP

Función

Esta API se utiliza para consultar un EIP específico.

URI

GET /v1/{project_id}/publicips/{publicip_id}

Tabla 1 describe los parámetros.

**Tabla 1** Descripción del parámetro
Nombre	Obligatorio	Descripción
project_id	Sí	Especifica el ID del proyecto.
publicip_id	Sí	Especifica el identificador único de un EIP.

Mensaje de solicitud

Parámetro 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.

Ejemplo de la solicitud

Get https://{Endpoint}/v1/{project_id}/publicips/{publicip_id}

Mensaje de la respuesta

Parámetro de respuesta

**Tabla 3** Parámetro de respuesta
Nombre	Tipo	Descripción
publicip	publicip object	Especifica el objeto EIP. Para más detalles, consulte Tabla 4.

**Tabla 4** Descripción del campo **publicip**
Nombre	Tipo	Descripción
id	String	Especifica el identificador único de un EIP.
status	String	Especifica el estado de EIP. Los valores posibles son los siguientes: FREEZED (Congelado) BIND_ERROR (Error de enlace) BINDING (Encuadernación) PENDING_DELETE (Liberación) PENDING_CREATE (Asignación) PENDING_UPDATE (Actualización) NOTIFYING (Asignación) NOTIFY_DELETE (Liberación) DOWN (sin consolidar) ACTIVE (Enlazado) ELB (Unido a un balanceador de carga) VPN (enlazado a una VPN) ERROR (Excepciones)
profile	profile object	Especifica los parámetros adicionales, incluidos el ID de pedido y el ID de producto. Para más detalles, consulte Tabla 5.
type	String	Especifica el tipo de EIP. El valor puede ser 5_bgp (BGP dinámico) o 5_sbgp (BGP estático). CN South-Guangzhou: 5_bgp y 5_sbgp CN East-Shanghai1: 5_bgp y 5_sbgp CN East-Shanghai2: 5_bgp y 5_sbgp CN North-Beijing1: 5_bgp y 5_sbgp CN-Hong Kong: 5_bgp AP-Bangkok: 5_bgp AP-Singapore: 5_bgp AF-Johannesburg: 5_bgp CN Southwest-Guiyang1: 5_sbgp CN North-Beijing4: 5_bgp y 5_sbgp LA-Santiago: 5_bgp LA-Sao Paulo1: 5_bgp LA-Mexico City1: 5_bgp LA-Buenos Aires1: 5_bgp LA-Lima1: 5_bgp LA-Santiago2: 5_bgp Restricciones: El valor configurado debe ser compatible con el sistema. publicip_id es un puerto IPv4. Si no se especifica publicip_type, el valor predeterminado es 5_bgp.
public_ipv6_address	String	Especifica el EIP obtenido si los EIP IPv6 están disponibles. Este parámetro no existe si solo están disponibles EIP IPv4.
public_ip_address	String	Especifica el EIP obtenido si sólo están disponibles los EIP IPv4. Especifica la dirección IPv4 correspondiente a la dirección IPv6 si están disponibles los EIP IPv6.
ip_version	Integer	Especifica la versión de la dirección IP. El valor puede ser 4 o 6. 4: IPv4 6: IPv6
private_ip_address	String	Especifica la dirección IP privada enlazada al EIP. Este parámetro se devuelve solo si la dirección IP privada está enlazada al EIP.
port_id	String	Especifica el ID de puerto. Este parámetro se devuelve solo cuando un puerto está asociado con el EIP.
tenant_id	String	Especifica el ID del proyecto.
create_time	String	Especifica la hora (UTC) cuando se asigna el EIP.
bandwidth_id	String	Especifica el ID del ancho de banda EIP.
bandwidth_size	Integer	Especifica el ancho de banda (Mbit/s).
bandwidth_share_type	String	Especifica el tipo de ancho de banda EIP. El valor puede ser PER o WHOLE. PER: Ancho de banda dedicado WHOLE: Ancho de banda compartido
bandwidth_name	String	Especifica el nombre del ancho de banda.
alias	String	Especifica el nombre de EIP.
enterprise_project_id	String	Especifica el ID del proyecto de empresa. El valor es 0 o una string que contiene un máximo de 36 caracteres en formato UUID con guiones (-). Al asignar un EIP, debe asociar un ID de proyecto de empresa con el EIP. Si no se especifica este parámetro, el valor predeterminado es 0, que indica que se utiliza el proyecto de empresa predeterminado. NOTA: Para obtener más información acerca de los proyectos de empresa y cómo obtener los ID de proyecto de empresa, consulte la Guía del usuario de Enterprise Management.
public_border_group	String	Especifica si se encuentra en una ubicación central o en una ubicación de borde. Valores: center Edge site name Este recurso solo puede asociarse con un EIP de la misma región.
allow_share_bandwidth_types	Array of strings	Especifica los tipos de ancho de banda compartido al que se puede agregar el EIP. Si la lista está vacía, el EIP no se puede agregar a ningún ancho de banda compartido. El EIP solo se puede agregar al ancho de banda compartido de estos tipos.

**Tabla 5** Descripción del campo **profile**
Nombre	Tipo	Descripción
order_id	String	Especifica el ID de pedido.
product_id	String	Especifica el ID del producto.
region_id	String	Especifica el ID de la región.
user_id	String	Especifica el ID de usuario.

Ejemplo de la respuesta

{
    "publicip": {
        "id": "2ec9b78d-9368-46f3-8f29-d1a95622a568",
        "status": "DOWN",
        "type": "5_bgp",
        "public_ip_address": "161.xx.xx.12",
        "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
        "private_ip_address": "192.168.10.5",
        "create_time": "2015-07-16 04:32:50",
        "bandwidth_id": "49c8825b-bed9-46ff-9416-704b96d876a2",
        "bandwidth_share_type": "PER",
"bandwidth_size": 10,    //The EIP bandwidth size is 10 Mbit/s.
        "bandwidth_name": "bandwidth-test",
        "ip_version": 4
    }
}