Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Elastic Cloud Server/ Referência de API/ As API desatualizadas/ Gerenciamento de grupo de segurança (as API de Nova do OpenStack)/ Criação de uma regra de grupo de segurança (Descartado)

Atualizado em 2022-11-08 GMT+08:00

Criação de uma regra de grupo de segurança (Descartado)

Função

Essa API é usada para criar uma regra de grupo de segurança.

Esta API foi descartada. Use a API descrita em Criação de uma regra de grupo de segurança.

URI

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

Tabela 1 descreve os parâmetros no URI.

**Tabela 1** Descrição do parâmetro
Parâmetro	Obrigatório	Descrição
project_id	Sim	Especifica a ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto.

Solicitação

Tabela 2 descreve os parâmetros de solicitação.

**Tabela 2** Parâmetros de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
security_group_rule	Sim	Object	Especifica a regra de grupo de segurança, que é configurada no corpo da mensagem. Para mais detalhes, consulte Tabela 3.

**Tabela 3** Objetos do parâmetro de solicitação **security_group_rule**
Parâmetro	Obrigatório	Tipo	Descrição
parent_group_id	Sim	String	Especifica o ID do grupo de segurança associado no formato UUID.
ip_protocol	Sim	String	Especifica o protocolo IP, que pode ser icmp, tcp, ou udp.
from_port	Sim	Integer	Especifica a porta inicial. O valor varia de 1 a 65 535 e não é maior que o valor de to_port. Se o valor de ip_protocol for icmp, esse parâmetro especificará o tipo de ICMP. O valor varia de 0 a 255.
to_port	Sim	Integer	Especifica a porta final. O valor varia de 1 a 65.535 e não pode ser menor que from_port. Se ip_protocol for icmp, esse parâmetro especificará o código ICMP. O valor varia de 0 a 255. Se ambos from_port e to_port são -1, qualquer pacote ICMP pode ser transmitido.
cidr	Não	String	Especifica o intervalo de endereços IP. O endereço está no formato CIDR, como 192.168.0.0/24.
group_id	Não	String	Especifica a ID do grupo de segurança de origem. Se ambos group_id e cidr estão definidos, group_id é usado.

Resposta

Tabela 4 descreve os parâmetros de resposta.

**Tabela 4** Parâmetros de resposta
Parâmetro	Obrigatório	Tipo	Descrição
security_group_rule	Sim	Object	Especifica a regra de grupo de segurança, que é configurada no corpo da mensagem. Para mais detalhes, consulte Tabela 5.

**Tabela 5** Objetos do parâmetro de resposta **security_group_rule**
Parâmetro	Obrigatório	Tipo	Descrição
parent_group_id	Sim	String	Especifica o ID do grupo de segurança associado no formato UUID.
ip_protocol	Sim	String	Especifica o protocolo IP, que pode ser icmp, tcp, ou udp.
from_port	Sim	Integer	Especifica o número da porta inicial. O valor varia de 1 a 65 535 e não pode ser maior que to_port. Quando o tipo de protocolo é definido como ICMP, from_port é o tipo ICMP e varia de 0 a 255.
to_port	Sim	Integer	Especifica o número da porta final. O valor varia de 1 a 65.535. Quando o tipo de protocolo é definido como ICMP, to_port é o código ICMP e varia de 0 a 255. Se ambos from_port e to_port forem -1, isso indica que qualquer pacote ICMP pode ser transmitido.
ip_range	Sim	Object	Especifica o intervalo de endereços IP, incluindo as informações CIDR, como "ip_range": {"cidr": "0.0.0.0/0"}. Para obter detalhes, consulte o objeto ip_range.
group	Sim	Object	Nada é devolvido.
id	Sim	String	Especifica a ID da regra do grupo de segurança no formato UUID.

**Tabela 6** Objetos **ip_range**
Parâmetro	Obrigatório	Tipo	Descrição
cidr	Sim	String	Especifica o intervalo de endereços IP. O endereço está no formato CIDR, como 192.168.0.0/24.

Exemplo de solicitação

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"
	}
}

Exemplo de resposta

{
	"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
	}
}