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.0/snat_rules

Solicitud

Tabla 1 describe los parámetros de solicitud.

Tabla 1 Parámetro de solicitud

Parámetro

Obligatorio

Tipo

Descripción

snat_rule

Object

Especifica el objeto de la regla de SNAT. Para más detalles, consulte Tabla 2.

Tabla 2 Descripción del campo snat_rule

Parámetro

Obligatorio

Tipo

Descripción

nat_gateway_id

String

Especifica el ID del gateway de NAT.

network_id

No

String

Especifica el ID de red utilizado por la regla de SNAT. Debe especificarse este parámetro o cidr.

cidr

No

String

Especifica CIDR, que puede tener el formato de un segmento de red o una dirección IP de host. Este parámetro y network_id son alternativos.

Si Source_type se establece en 0, el bloque CIDR debe ser un subconjunto del bloque CIDR de subred de VPC.

Si Source_type se establece en 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 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.

Respuesta

Tabla 3 enumera los parámetros de respuesta.

Tabla 3 Parámetro de respuesta

Parámetro

Tipo

Descripción

snat_rule

Object

Especifica el objeto de la regla de SNAT. Para más detalles, consulte Tabla 4.

Tabla 4 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(4096)

  • Especifica el ID de EIP. Se deben separar varios identificadores de EIP con las comas (,).
  • La longitud máxima del ID es de 4096 bytes.

floating_ip_address

String(1024)

  • Especifica la EIP. Múltiples EIPs deben separarse con las comas (,).
  • La longitud máxima es de 1024 bytes.

status

String

  • Especifica el estado de la regla SNAT.
  • Para obtener más información sobre todos sus valores, consulte Tabla 1.

admin_state_up

Boolean

  • Especifica si la regla de SNAT está congelada.
  • El valor puede ser:
    • true: La regla de SNAT está descongelada.
    • false: la regla de SNAT está congelada.

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.

Ejemplos

  • Ejemplo de la solicitud
    1. Configurar el parámetro network_id en una VPC.
      POST https://{Endpoint}/v2.0/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"
          }
      }
    1. Configurar el parámetro cidr en una VPC.
      POST https://{Endpoint}/v2.0/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"
            }
        }
    1. Configurar el parámetro cidr a través de una conexión Direct Connect.
      POST https://{Endpoint}/v2.0/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"
            }
        }
  • 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", 
               "cidr": null, 
               "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", 
               "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", 
               "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"
           } 
       }

Códigos de estado

Consulte Códigos de estado.