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> Regla de SNAT> Creación de una regla de SNAT

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

Ver PDF

Creación de una regla de SNAT

Función

Esta API se utiliza para crear una regla SNAT.

Puede crear una regla SNAT solo cuando status de los gateway de NAT se establece en ACTIVE y admin_state_up del administrador de gateway de NAT en True.

URI

POST /v2/{project_id}/snat_rules

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	Especifica el ID del proyecto.

Solicitud

Tabla 2 describe los parámetros de solicitud.

**Tabla 2** Parámetro de solicitud
Parámetro	Obligatorio	Tipo	Descripción
snat_rule	Sí	Object	Especifica el objeto de la regla de SNAT. Para obtener más información, véase Tabla 3.

**Tabla 3** Descripción del campo **snat_rule**
Parámetro	Obligatorio	Tipo	Descripción
nat_gateway_id	Sí	String	Especifica el ID del gateway de NAT. Para obtener más información, véase Consulta de los gateway de NAT.
network_id	No	String	Especifica el ID de red utilizado por la regla de SNAT. Para obtener más información, consulte la sección Consulta de redes. Configure network_id o cidr.
cidr	No	String	Especifica un bloque CIDR o una dirección IP de host. Este parámetro y network_id son alternativos. Si el valor de source_type es de 0 el bloque CIDR debe ser un subconjunto del bloque CIDR de subred de VPC. Si el valor de Source_type es 1, cidr debe ser un bloque CIDR de conexión Direct Connect.
source_type	No	Integer	0: Puede especificarse network_id o cidr en una VPC. 1: Solo se puede especificar cidr a través de una conexión Direct Connect. Si no se introduce ningún valor, se utiliza el valor por defecto 0 (VPC).
floating_ip_id	Sí	String	Especifica el ID de la EIP. Se deben separar varios identificadores de EIP con las comas (,). La longitud máxima del ID es de 4096 bytes. El número de ID de EIP no puede exceder de 20.
description	No	String	Proporciona información adicional sobre la regla de SNAT. Puede introducir hasta 255 caracteres.

Respuesta

Tabla 4 enumera los parámetros de respuesta.

**Tabla 4** Parámetro de respuesta
Parámetro	Tipo	Descripción
snat_rule	Object	Especifica el objeto de la regla de SNAT. Para obtener más información, véase Tabla 5.

**Tabla 5** Descripción del campo **snat_rule**
Parámetro	Tipo	Descripción
id	String	Especifica el ID de regla de SNAT.
tenant_id	String	Especifica el ID del proyecto.
nat_gateway_id	String	Especifica el ID del gateway de NAT.
network_id	String	Especifica el ID de red utilizado por la regla de SNAT.
cidr	String	Especifica un subconjunto del bloque CIDR de subred de VPC o un bloque CIDR de conexión Direct Connect.
source_type	Integer	0: Puede especificarse network_id o cidr en una VPC. 1: Solo se puede especificar cidr a través de una conexión Direct Connect. Si no se introduce ningún valor, se utiliza el valor por defecto 0 (VPC).
floating_ip_id	String	Especifica el ID de la EIP. Se deben separar varios identificadores de EIP con las comas (,). La longitud máxima del ID es de 4096 bytes.
description	String	Proporciona información adicional sobre la regla de SNAT. Puede introducir hasta 255 caracteres.
status	String	Especifica el estado de la regla SNAT. 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 SNAT (hora UTC). Su valor redondea a 6 decimales durante segundos. El formato es aaaa-mm-dd hh:mm:ss.
floating_ip_address	String	Especifica la EIP. Múltiples EIP deben separarse con las comas (,). La longitud máxima es de 1024 bytes.
freezed_ip_address	String	Especifica la EIP congelada. Múltiples EIP deben separarse con las comas (,). La longitud máxima es de 1024 bytes.

Ejemplos

Ejemplo de la solicitud

Configurar el parámetro network_id en una VPC.

POST https://{Endpoint}/v2/d199ba7e0ba64899b2e81518104b1526/snat_rules    
 { 
     "snat_rule": { 
         "nat_gateway_id": "a78fb3eb-1654-4710-8742-3fc49d5f04f8", 
         "network_id": "eaad9cd6-2372-4be1-9535-9bd37210ae7b", 
         "source_type":0,
         "floating_ip_id": "bdc10a4c-d81a-41ec-adf7-de857f7c812a", 
         "description": "my snat rule 01" 
     } 
 }

Configurar el parámetro cidr en una VPC.

POST /v2/d199ba7e0ba64899b2e81518104b1526/snat_rules  
 {       
    "snat_rule": { 
          "nat_gateway_id": "a78fb3eb-1654-4710-8742-3fc49d5f04f8", 
          "cidr": "192.168.1.10/32", 
          "source_type":0, 
          "floating_ip_id": "bdc10a4c-d81a-41ec-adf7-de857f7c812a", 
          "description": "my snat rule 01" 
     } 
 }

Configurar el parámetro cidr a través de una conexión Direct Connect.

POST https://{Endpoint}/v2/d199ba7e0ba64899b2e81518104b1526/snat_rules 
  { 
       "snat_rule": {  
          "nat_gateway_id": "a78fb3eb-1654-4710-8742-3fc49d5f04f8", 
          "cidr": "172.30.0.0/24", 
          "source_type":1, 
          "floating_ip_id": "bdc10a4c-d81a-41ec-adf7-de857f7c812a", 
          "description": "my snat rule 01" 
       } 
   }

Ejemplo de la respuesta

Respuesta a la solicitud para especificar el network_id para una VPC

{ 
     "snat_rule": { 
         "floating_ip_id": "bdc10a4c-d81a-41ec-adf7-de857f7c812a", 
         "status": "PENDING_CREATE", 
         "nat_gateway_id": "a78fb3eb-1654-4710-8742-3fc49d5f04f8", 
         "admin_state_up": true, 
         "network_id": "eaad9cd6-2372-4be1-9535-9bd37210ae7b", 
         "description": "",
         "source_type":0, 
         "tenant_id": "27e25061336f4af590faeabeb7fcd9a3", 
         "created_at": "2017-11-18 07:54:21.665430", 
         "id": "5b95c675-69c2-4656-ba06-58ff72e1d338", 
         "floating_ip_address": "5.21.11.226"
     } 
 }

Respuesta a la solicitud de especificación del bloque CIDR en una VPC

{ 
     "snat_rule": { 
         "floating_ip_id": "bdc10a4c-d81a-41ec-adf7-de857f7c812a", 
         "status": "PENDING_CREATE", 
         "nat_gateway_id": "a78fb3eb-1654-4710-8742-3fc49d5f04f8", 
         "admin_state_up": true, 
         "cidr": "192.168.1.10/32", 
         "description": "",
         "source_type":0, 
         "tenant_id": "27e25061336f4af590faeabeb7fcd9a3", 
         "created_at": "2017-11-18 07:54:21.665430", 
         "id": "5b95c675-69c2-4656-ba06-58ff72e1d338", 
         "floating_ip_address": "5.21.11.226"
     } 
 }

Respuesta a la solicitud de especificación del bloque CIDR en una VPC

{ 
     "snat_rule": { 
         "floating_ip_id": "bdc10a4c-d81a-41ec-adf7-de857f7c812a", 
         "status": "PENDING_CREATE", 
         "nat_gateway_id": "a78fb3eb-1654-4710-8742-3fc49d5f04f8", 
         "admin_state_up": true, 
         "cidr": "172.30.0.0/24", 
         "description": "",
         "source_type":1, 
         "tenant_id": "27e25061336f4af590faeabeb7fcd9a3", 
         "created_at": "2017-11-18 07:54:21.665430", 
         "id": "5b95c675-69c2-4656-ba06-58ff72e1d338", 
         "floating_ip_address": "5.21.11.226"
     } 
 }

Tema principal: Regla de SNAT

Tema anterior: Regla de SNAT

Tema siguiente: Consulta de reglas de SNAT