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/NAT Gateway/Referencia de la API/API v2/Reglas de DNAT/Consulta de reglas de DNAT
Actualización más reciente 2025-09-05 GMT+08:00
Ver PDF
Compartir

Consulta de reglas de DNAT

Función

Esta API se utiliza para consultar reglas de DNAT.

URI

GET /v2/{project_id}/dnat_rules

Puede escribir el signo de interrogación (?) y ampersand (&) al final del URI para definir varios criterios de búsqueda. Todos los parámetros opcionales se pueden filtrar. Para obtener más información, consulte la solicitud de ejemplo.

Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

Especifica el ID del proyecto.

limit

No

Integer

Especifica el número de registros que se muestran en cada página.

id

No

String

Especifica el ID de la regla de DNAT.

tenant_id

No

String

Especifica el ID del proyecto.

nat_gateway_id

No

String

Especifica el ID del gateway de NAT.

port_id

No

String

Especifica el ID del puerto de un ECS o de un BMS.

private_ip

No

String

Especifica la dirección IP privada de un usuario, por ejemplo, la dirección IP de una VPC para la conexión de Direct Connect.

internal_service_port

No

Integer

Especifica el puerto utilizado por los ECS o BMS a proporcionar servicios para los sistemas externos.

floating_ip_id

No

String

Especifica el ID de la EIP.

floating_ip_address

No

String

Especifica la EIP.

external_service_port

No

Integer

Especifica el puerto para proporcionar los servicios externos.

protocol

No

String

Especifica el tipo de protocolo. Se admiten TCP, UDP y ANY.

El número de protocolo de TCP, UDP y ANY son 6, 17 y 0, respectivamente.

description

No

String

Proporciona la información complementaria sobre la regla de DNAT. Puede introducir hasta 255 caracteres.

status

No

String

  • Especifica el estado de la regla de DNAT.
  • Para obtener más información sobre todos sus valores.

admin_state_up

No

Boolean

  • Especifica el estado descongelado o congelado.
  • El valor puede ser:
    • true: indica el estado no congelado.
    • false: indica el estado congelado.

Solicitud

No hay

Respuesta

Tabla 2 enumera los parámetros de respuesta.

Tabla 2 Parámetro de respuesta

Parámetro

Tipo

Descripción

dnat_rules

Array(Object)

Especifica los objetos de la regla de DNAT. Para obtener más información, véase Tabla 3.

Tabla 3 Descripción del campo dnat_rule

Parámetro

Tipo

Descripción

id

String

Especifica el ID de la regla de DNAT.

tenant_id

String

Especifica el ID del proyecto.

nat_gateway_id

String

Especifica el ID del gateway de NAT.

port_id

String

Especifica el ID del puerto de un ECS o de un BMS.

private_ip

String

Especifica la dirección IP privada de un usuario, por ejemplo, la dirección IP de una VPC para la conexión de Direct Connect.

internal_service_port

Integer

Especifica el puerto utilizado por los ECS o BMS a proporcionar servicios para los sistemas externos.

floating_ip_id

String

Especifica el ID de la EIP.

floating_ip_address

String

Especifica la EIP.

external_service_port

Integer

Especifica el puerto para proporcionar los servicios externos.

protocol

String

Especifica el tipo de protocolo. Se admiten TCP, UDP y ANY.

El número de protocolo de TCP, UDP y ANY son 6, 17 y 0, respectivamente.

description

String

Proporciona la información complementaria sobre la regla de DNAT. Puede introducir hasta 255 caracteres.

status

String

  • Especifica el estado de la regla de DNAT.
  • Para obtener más información sobre todos sus valores.

admin_state_up

Boolean

  • Especifica el estado descongelado o congelado.
  • El valor puede ser:
    • true: indica el estado no congelado.
    • false: indica el estado congelado.

created_at

String

  • Especifica cuándo se crea la regla de DNAT (hora UTC). Su valor redondea a 6 decimales durante segundos. El formato es aaaa-mm-dd hh:mm:ss.

internal_service_port_range

String

Especifica el intervalo de puertos utilizado por los ECS o BMS a proporcionar servicios para los sistemas externos.

  • El rango de puertos es el mismo que el valor de external _service_port_range.
  • El valor varía de 1 a 65535.

external_service_port_range

String

Especifica el intervalo de puertos utilizado por la dirección IP flotante para proporcionar los servicios externos.

  • El rango de puertos es el mismo que el valor de internal _service_port_range.
  • El valor varía de 1 a 65535.

Ejemplos

  • Ejemplo de la solicitud 
    GET https://{Endpoint}/v2/d199ba7e0ba64899b2e81518104b1526d/dnat_rules?limit=10
  • Ejemplo de la respuesta 
    { 
     "dnat_rules": [ 
         { 
             "floating_ip_id": "bf99c679-9f41-4dac-8513-9c9228e713e1", 
             "status": "ACTIVE", 
             "nat_gateway_id": "cda3a125-2406-456c-a11f-598e10578541", 
             "admin_state_up": true, 
             "port_id": "9a469561-daac-4c94-88f5-39366e5ea193", 
             "private_ip": "", 
             "internal_service_port": 993, 
             "protocol": "tcp", 
             "tenant_id": "abc", 
             "created_at": "2017-11-15 15:44:42.595173", 
             "id": "79195d50-0271-41f1-bded-4c089b2502ff", 
             "floating_ip_address": "5.21.11.226", 
             "external_service_port": 242, 
             "description": "my dnat rule 01" 
         }, 
         { 
             "floating_ip_id": "cf99c679-9f41-4dac-8513-9c9228e713e1", 
             "status": "ACTIVE", 
             "nat_gateway_id": "dda3a125-2406-456c-a11f-598e10578541", 
             "admin_state_up": true, 
             "port_id": "", 
             "private_ip": "192.168.1.100", 
             "internal_service_port": 0, 
             "protocol": "any", 
             "tenant_id": "abc", 
             "created_at": "2017-11-16 15:44:42.595173", 
             "id": "89195d50-0271-41f1-bded-4c089b2502ff", 
             "floating_ip_address": "5.21.11.227", 
             "external_service_port": 0, 
             "description": "my dnat rule 01" 
         } 
     ] 
 }
Tema principal:Reglas de DNAT