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.
Actualización más reciente 2023-01-11 GMT+08:00

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

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

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

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

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
    1. 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" 
           } 
       }
    1. 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" 
           } 
       }
    1. 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
    1. 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"
           } 
       }
    2. 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"
           } 
       }
    3. 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"
           } 
       }