Creación de una regla de SNAT
Función
Esta API se utiliza para crear una regla SNAT.
![](https://support.huaweicloud.com/intl/es-us/api-natgateway/public_sys-resources/note_3.0-es-us.png)
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.
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
snat_rule |
Sí |
Object |
Especifica el objeto de la regla de SNAT. Para más detalles, consulte Tabla 2. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
nat_gateway_id |
Sí |
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 |
Sí |
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.
Parámetro |
Tipo |
Descripción |
---|---|---|
snat_rule |
Object |
Especifica el objeto de la regla de SNAT. Para más detalles, consulte Tabla 4. |
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) |
|
floating_ip_address |
String(1024) |
|
status |
String |
|
admin_state_up |
Boolean |
|
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
- 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" } }
- 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" } }
- 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" } }
- Configurar el parámetro network_id en una VPC.
- 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", "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" } }
- 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" } }
- 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" } }
- Respuesta a la solicitud para especificar el network_id para una VPC
Códigos de estado
Consulte Códigos de estado.