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
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
String |
Especifica el ID del proyecto. |
Solicitud
Tabla 2 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 obtener más información, véase Tabla 3. |
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.
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. |
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 |
|
description |
String |
Proporciona información adicional sobre la regla de SNAT. Puede introducir hasta 255 caracteres. |
status |
String |
|
admin_state_up |
Boolean |
|
created_at |
String |
|
floating_ip_address |
String |
|
freezed_ip_address |
String |
|
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" } }
- 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", "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" } }
- Respuesta a la solicitud para especificar el network_id para una VPC