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 fuera de fecha> API v2.0> Servicio de gateway de NAT> Consulta de los gateways de NAT

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

Ver PDF

Consulta de los gateways de NAT

Función

Esta API se utiliza para consultar una lista de gateways de NAT. A menos que se especifique lo contrario, se aplica una coincidencia exacta.

URI

GET /v2.0/nat_gateways

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
id	No	String	Especifica el ID del gateway de NAT.
limit	No	Integer	Especifica el número de registros de cada página.
tenant_id	No	String	Especifica el ID del proyecto.
name	No	String(64)	Especifica el nombre del gateway de NAT. El nombre solo puede contener dígitos, letras, guiones bajos (_), y guiones (-).
description	No	String(255)	Proporciona información adicional sobre el gateway de NAT.
spec	No	String	Especifica el tipo de gateway de NAT. El tipo puede ser: 1: tipo pequeño, que soporta hasta 10,000 conexiones SNAT. 2: tipo medio, que soporta hasta 50,000 conexiones SNAT. 3: tipo grande, que soporta hasta 200,000 conexiones SNAT. 4: tipo extragrande, que soporta hasta 1,000,000 conexiones SNAT.
router_id	No	String	Especifica el ID de VPC.
internal_network_id	No	String	Especifica el ID de red de la interfaz descendente (el salto siguiente del DVR) de los gateway de NAT.
status	No	String	Especifica el estado de los gateway de NAT. Para obtener más información sobre todos sus valores, consulte Tabla 1.
admin_state_up	No	Boolean	Especifica si los gateway de NAT están congelados. El valor puede ser: true: Los gateway de NAT están descongelados. false: Los gateway de NAT están congelados.
created_at	No	String	Especifica cuándo se crean los gateway de NAT (hora UTC). Su valor redondea a 6 decimales durante segundos. El formato es aaaa-mm-dd hh:mm:ss.

Solicitud

No hay

Respuesta

Tabla 2 enumera los parámetros de respuesta.

**Tabla 2** Parámetro de respuesta
Parámetro	Tipo	Descripción
nat_gateways	List (NAT gateways)	Especifica los objetos de los gateway de NAT. Para más detalles, consulte Tabla 3.

**Tabla 3** Descripción del campo **nat_gateway**
Parámetro	Tipo	Descripción
id	String	Especifica el ID del gateway de NAT.
tenant_id	String	Especifica el ID del proyecto.
name	String(64)	Especifica el nombre del gateway de NAT. El nombre solo puede contener dígitos, letras, guiones bajos (_), y guiones (-).
description	String(255)	Proporciona información adicional sobre el gateway de NAT.
spec	String	Especifica el tipo de gateway de NAT. El tipo puede ser: 1: tipo pequeño, que soporta hasta 10,000 conexiones SNAT. 2: tipo medio, que soporta hasta 50,000 conexiones SNAT. 3: tipo grande, que soporta hasta 200,000 conexiones SNAT. 4: tipo extragrande, que soporta hasta 1,000,000 conexiones SNAT.
router_id	String	Especifica el ID de VPC.
internal_network_id	String	Especifica el ID de red de la interfaz descendente (el salto siguiente del DVR) de los gateway de NAT.
status	String	Especifica el estado de los gateway de NAT. Para obtener más información sobre todos sus valores, consulte Tabla 1.
admin_state_up	Boolean	Especifica si los gateway de NAT están congelados. El valor puede ser: true: Los gateway de NAT están descongelados. false: Los gateway de NAT están congelados.
created_at	String	Especifica cuándo se crean los gateway de NAT (hora UTC). Su valor redondea a 6 decimales durante segundos. El formato es aaaa-mm-dd hh:mm:ss.

Ejemplos

Ejemplo de la solicitud

GET https://{Endpoint}/v2.0/nat_gateways?limit=10

Ejemplo de la respuesta

{
     "nat_gateways": [ 
         { 
             "router_id": "b1d81744-5165-48b8-916e-e56626feb88f", 
             "status": "ACTIVE", 
             "description": "", 
             "admin_state_up": true, 
             "tenant_id": "27e25061336f4af590faeabeb7fcd9a3", 
             "created_at": "2017-11-15 14:50:39.505112", 
             "spec": "2", 
             "internal_network_id": "5930796a-6026-4d8b-8790-6c6bfc9f87e8", 
             "id": "a253be25-ae7c-4013-978b-3c0785eccd63",
             "name": "wj3" 
         }, 
         { 
             "router_id": "305dc52f-13dd-429b-a2d4-444a1039ba0b", 
             "status": "ACTIVE", 
             "description": "", 
             "admin_state_up": true, 
             "tenant_id": "27e25061336f4af590faeabeb7fcd9a3", 
             "created_at": "2017-11-17 07:41:07.538062", 
             "spec": "2", 
             "internal_network_id": "fc09463b-4ef8-4c7a-93c8-92d9ca6daf9d", 
             "id": "e824f1b4-4290-4ebc-8322-cfff370dbd1e", 
             "name": "lyl001" 
        }
    ]
}