Creación de una regla de ACL de red
Función
Esta API se utiliza para crear una regla de ACL de red.
URI
POST /v2.0/fwaas/firewall_rules
Mensaje de solicitud
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
|---|---|---|---|
|
firewall_rule |
Sí |
firewall_rule object |
Especifica los objetos de regla de firewall. Para obtener más información, véase Tabla 2. |
|
Atributo |
Obligatorio |
Tipo |
Restricción |
Descripción |
|---|---|---|---|---|
|
name |
No |
String |
El valor puede contener un máximo de 255 caracteres. |
Especifica el nombre de la regla de ACL de red. El valor puede contener un máximo de 255 caracteres. |
|
description |
No |
String |
El valor puede contener un máximo de 255 caracteres. |
Proporciona la información adicional sobre la regla de ACL de red. El valor puede contener un máximo de 255 caracteres. |
|
protocol |
No |
String |
El valor puede ser TCP, UDP, o ICMP. |
Especifica el protocolo IP. El valor puede ser TCP, UDP, o ICMP. |
|
source_port |
No |
String |
El valor puede ser un número entero de 1 a 65535 o un rango de número de puerto en el formato a:b. |
Especifica el número de puerto de origen o el intervalo de números de puerto. El valor puede ser un número entero de 1 a 65535 o un rango de número de puerto en el formato a:b. |
|
destination_port |
No |
String |
El valor puede ser un número entero de 1 a 65535 o un rango de número de puerto en el formato a:b. |
Especifica el número de puerto de destino o el intervalo de números de puerto. El valor puede ser un número entero de 1 a 65535 o un rango de número de puerto en el formato a:b. |
|
ip_version |
No |
Integer |
4/6 |
Especifica la versión del protocolo IP. El valor puede ser 4 y 6 indicando la dirección IPv4 y la dirección IPv6, respectivamente. |
|
source_ip_address |
No |
String |
N/A |
Especifica la dirección IP de origen o el bloque CIDR. |
|
destination_ip_address |
No |
String |
N/A |
Especifica la dirección IP de destino o el bloque CIDR. |
|
action |
No |
String |
negar/permitir |
Especifica la acción realizada en el tráfico que pasa por la ACL de red. El valor puede ser deny o allow. |
|
enabled |
No |
Boolean |
El valor puede ser true o false. |
Especifica si la regla de ACL de red está habilitada. El valor puede ser true o false. |
Ejemplo de la solicitud
POST https://{Endpoint}/v2.0/fwaas/firewall_rules
{
"firewall_rule": {
"action": "allow",
"enabled": true,
"destination_port": "80",
"protocol": "tcp",
"name": "ALLOW_HTTP"
}
}
Mensaje de la respuesta
|
Parámetro |
Tipo |
Descripción |
|---|---|---|
|
firewall_rule |
firewall_rule object |
Especifica los objetos de regla de firewall. Para obtener más información, véase Tabla 4. |
|
Atributo |
Tipo |
Descripción |
|---|---|---|
|
id |
String |
Especifica el UUID de la regla de ACL de red. |
|
name |
String |
Especifica el nombre de la regla de ACL de red. |
|
description |
String |
Proporciona la información adicional sobre la regla de ACL de red. |
|
tenant_id |
String |
Especifica el ID del proyecto. |
|
public |
Boolean |
Especifica si la regla del firewall puede ser compartida por diferentes tenants. |
|
protocol |
String |
Especifica el protocolo IP. |
|
source_port |
String |
Especifica el número de puerto de origen o el intervalo de números de puerto. |
|
destination_port |
String |
Especifica el número de puerto de destino o el intervalo de números de puerto. |
|
ip_version |
Integer |
Especifica la versión del protocolo IP. |
|
source_ip_address |
String |
Especifica la dirección IP de origen o el bloque CIDR. |
|
destination_ip_address |
String |
Especifica la dirección IP de destino o el bloque CIDR. |
|
action |
String |
Especifica la acción realizada en el tráfico que pasa por la ACL de red. |
|
enabled |
Boolean |
Especifica si la regla de ACL de red está habilitada. |
|
project_id |
String |
Especifica el ID del proyecto. Para obtener más información sobre cómo obtener un ID de proyecto, consulte Obtención de un ID de proyecto. |
Ejemplo de la respuesta
{
"firewall_rule": {
"protocol": "tcp",
"description": "",
"source_ip_address": null,
"destination_ip_address": null,
"source_port": null,
"destination_port": "80",
"id": "b94acf06-efc2-485d-ba67-a61acf2a7e28",
"name": "ALLOW_HTTP",
"tenant_id": "23c8a121505047b6869edf39f3062712",
"enabled": true,
"action": "allow",
"ip_version": 4,
"public": false,
"project_id": "23c8a121505047b6869edf39f3062712"
}
}
Código de estado
Consulte Códigos de estado.
Código de error
Consulte Códigos de error.