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/ TaurusDB/ Referencia de la API/ Las API (recomendadas)/ Gestión de instancias/ Consulta de una EIP
Actualización más reciente 2025-03-21 GMT+08:00
Ver PDF
Compartir

Consulta de una EIP

Función

Esta API se utiliza para consultar una EIP. Antes de invocar a esta API:

URI

GET /v3/{project_id}/instances/{instance_id}/eip

Tabla 1 Parámetros de URI

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID de proyecto de un tenant en una región.

Para obtener este valor, consulte Obtención de un ID de proyecto.

instance_id

Sí

String

ID de instancia.

Parámetros de solicitud

Tabla 2 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

Sí

String

Token de usuario.

Para obtener el valor, invoque a la API para obtener un token de usuario.

El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.

Content-Type

Sí

String

Tipo de contenido.

Valor: application/json

X-Language

No

String

Idioma.

Parámetros de respuesta

Código de estado: 200

Tabla 3 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

can_enable_public_access

Boolean

Si se puede habilitar el acceso público.

id

String

ID de EIP.

type

String

Tipo de red de la EIP.

port_id

String

ID del puerto.

public_ip_address

String

EIP.

private_ip_address

String

Dirección IP privada.

status

String

Estado de EIP.

tenant_id

String

ID de tenant.

create_time

String

Tiempo de creación.

bandwidth_id

String

ID de ancho de banda.

bandwidth_name

String

Nombre del ancho de banda.

bandwidth_size

String

Tamaño del ancho de banda.

bandwidth_share_type

String

Tipo de ancho de banda. El valor puede ser PER o WHOLE.

profile

Object

Parámetros adicionales, incluidos el ID de pedido y el ID de producto. Si profile no está vacío, la EIP se factura anualmente/mensualmente.

Código de estado: 400

Tabla 4 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Código de estado: 500

Tabla 5 Parámetros del cuerpo de respuesta

Parámetro

Tipo

Descripción

error_code

String

Código de error.

error_msg

String

Mensaje de error.

Ejemplo de la solicitud

Consulta de una EIP

GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/12a49c2dc32648df8dd25e2976f70180in07/eip

Ejemplo de respuesta

Código de estado: 200

Operación exitosa.

{
  "can_enable_public_access" : true,
  "id" : "45a0ed37-cfa7-4403-8aeb-d720b4e831cf",
  "type" : "5_bgp",
  "port_id" : "2c02dc5b-a136-4921-b7ad-27e084548616",
  "public_ip_address" : "10.83.35.151",
  "private_ip_address" : "172.16.1.137",
  "status" : "ACTIVE",
  "tenant_id" : "23a50154cf494ec9ad6883979a12db0a",
  "create_time" : "2024-04-09 13:42:11",
  "bandwidth_id" : "2a4b2bc5-2a0a-42df-8f13-2fbe3d8bbbb2",
  "bandwidth_name" : "bandwidth-d3f4",
  "bandwidth_size" : 1,
  "bandwidth_share_type" : "PER",
  "profile" : { }
}

Código de estado

Código de estado

Descripción

200

Operación exitosa.

400

Error de cliente.

500

Error de servidor.

Código de error

Para obtener más información, véase Códigos de error.

Tema principal: Gestión de instancias