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.

Centro de ayuda/ Elastic Cloud Server/ Referencia de la API/ API fuera de fecha/ Gestión de grupos de seguridad (API de OpenStack Nova)/ Creación de una regla de grupo de seguridad (descartada)

Actualización más reciente 2022-11-08 GMT+08:00

Creación de una regla de grupo de seguridad (descartada)

Función

Esta API se utiliza para crear una regla de grupo de seguridad.

Esta API ha sido descartada. Utilice la API descrita en Creación de una regla de grupo de seguridad.

URI

POST /v2.1/{project_id}/os-security-group-rules

Tabla 1 describe los parámetros en el URI.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Descripción
project_id	Sí	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto.

Solicitud

Tabla 2 describe los parámetros de solicitud.

**Tabla 2** Parámetros de solicitud
Parámetro	Obligatorio	Tipo	Descripción
security_group_rule	Sí	Object	Especifica la regla de grupo de seguridad, que se configura en el cuerpo del mensaje. Para más detalles, consulte Tabla 3.

**Tabla 3** Objetos del parámetro de solicitud security_group_rule
Parámetro	Obligatorio	Tipo	Descripción
parent_group_id	Sí	String	Especifica el ID de grupo de seguridad asociado en formato UUID.
ip_protocol	Sí	String	Especifica el protocolo IP, que puede ser icmp, tcp o udp.
from_port	Sí	Integer	Especifica el puerto de inicio. El valor varía de 1 a 65,535 y no es mayor que el valor de to_port. Si el valor de ip_protocol es icmp, este parámetro especifica el tipo ICMP. El valor varía de 0 a 255.
to_port	Sí	Integer	Especifica el puerto final. El valor oscila entre 1 y 65,535 y no puede ser menor que from_port. Si ip_protocol es icmp, este parámetro especifica el código ICMP. El valor varía de 0 a 255. Si ambos from_port y to_port son -1, se puede transmitir cualquier paquete ICMP.
cidr	No	String	Especifica el intervalo de direcciones IP. La dirección está en formato CIDR, como 192.168.0.0/24.
group_id	No	String	Especifica el ID del grupo de seguridad de origen. Si se establecen tanto group_id como cidr, se utiliza group_id.

Respuesta

Tabla 4 describe los parámetros de respuesta.

**Tabla 4** Parámetros de respuesta
Parámetro	Obligatorio	Tipo	Descripción
security_group_rule	Sí	Object	Especifica la regla de grupo de seguridad, que se configura en el cuerpo del mensaje. Para más detalles, consulte Tabla 5.

**Tabla 5** Objetos del parámetro de respuesta security_group_rule
Parámetro	Obligatorio	Tipo	Descripción
parent_group_id	Sí	String	Especifica el ID de grupo de seguridad asociado en formato UUID.
ip_protocol	Sí	String	Especifica el protocolo IP, que puede ser icmp, tcp o udp.
from_port	Sí	Integer	Especifica el número de puerto inicial. El valor oscila entre 1 y 65,535 y no puede ser mayor que to_port. Cuando el tipo de protocolo se establece en ICMP, from_port es el tipo ICMP y varía de 0 a 255.
to_port	Sí	Integer	Especifica el número de puerto final. El valor oscila entre 1 y 65,535. Cuando el tipo de protocolo se establece en ICMP, to_port es el código ICMP y varía de 0 a 255. Si ambos from_port y to_port son -1, indica que se puede transmitir cualquier paquete ICMP.
ip_range	Sí	Object	Especifica el intervalo de direcciones IP, incluida la información CIDR, como "ip_range": {"cidr": "0.0.0.0/0"}. Para obtener más información, consulte el objeto ip_range.
group	Sí	Object	No se devuelve nada.
id	Sí	String	Especifica el ID de regla del grupo de seguridad en formato UUID.

**Tabla 6** Objetos ip_range
Parámetro	Obligatorio	Tipo	Descripción
cidr	Sí	String	Especifica el intervalo de direcciones IP. La dirección está en formato CIDR, como 192.168.0.0/24.

Ejemplo de la solicitud

POST https://{endpoint}/v2.1/{project_id}/os-security-group-rules

{
	"security_group_rule": {
		"from_port": "443",
		"ip_protocol": "tcp",
		"to_port": "443",
		"cidr": "0.0.0.0/0",
		"parent_group_id": "48700ff3-30b8-4e63-845f-a79c9633e9fb"
	}
}

Ejemplo de la respuesta

{
	"security_group_rule": {
		"id": "F4966B29-D21D-B211-B6B4-0018E1C5D866",
		"ip_range": {
			"cidr": "0.0.0.0/0"
		},
		"parent_group_id": "48700ff3-30b8-4e63-845f-a79c9633e9fb",
		"to_port": 443,
		"ip_protocol": "tcp",
		"group": {
		},
		"from_port": 443
	}
}