CreateSecurityGroup - ENS: Central de Documentação do Alibaba Cloud

Cria um grupo de segurança.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ens:CreateSecurityGroup

create

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
SecurityGroupName	string	Não	O nome do grupo de segurança. O nome deve ter de 2 a 128 caracteres e pode conter dígitos, dois-pontos (:), sublinhados (_) e hifens (-). Deve começar com uma letra e não pode começar com http:// ou https://. Por padrão, este parâmetro está vazio.	Dcdn1:2_3-4
Description	string	Não	A descrição do grupo de segurança. A descrição deve ter de 2 a 256 caracteres. Deve começar com uma letra e não pode começar com http:// ou https://.	testDescription
Permissions	array<object>	Não	As regras do grupo de segurança. Valores válidos de N: 0 a 200.
	object	Não	As regras do grupo de segurança.
Direction	string	Sim	A direção da regra do grupo de segurança. Valores válidos: egress: saída ingress: entrada	ingress
IpProtocol	string	Sim	O protocolo da camada de transporte. Valores válidos: TCP UDP ICMP ALL Valores válidos: TCP : TCP. UDP : UDP. ALL : ALL. ICMP : ICMP.	TCP
PortRange	string	Sim	O intervalo das portas de destino para a regra do grupo de segurança. Valores válidos: Se você definir o IpProtocol como TCP ou UDP, o intervalo de portas será de 1 a 65535. Você deve usar uma barra (/) para separar a porta inicial e a porta final, por exemplo, 1/200. Se você definir o IpProtocol como ICMP, o intervalo de portas será -1/-1. Se você definir o IpProtocol como ALL, o intervalo de portas será -1/-1.	80/80
SourcePortRange	string	Não	O intervalo das portas de origem para a regra do grupo de segurança. Valores válidos: Se você definir o IpProtocol como TCP ou UDP, o intervalo de portas será de 1 a 65535. Você deve usar uma barra (/) para separar a porta inicial e a porta final, por exemplo, 1/200. Se você definir o IpProtocol como ICMP, o intervalo de portas será -1/-1. Se você definir o IpProtocol como ALL, o intervalo de portas será -1/-1.	22/22
Policy	string	Sim	A política da regra do grupo de segurança. Valores válidos: Accept: permite o acesso. Drop: nega o acesso. Valores válidos: Accept : Accept. Drop : Drop.	Accept
DestCidrIp	string	Não	O bloco CIDR IPv4 de destino. Há suporte para blocos CIDR e endereços IPv4.	0.0.0.0/0
Description	string	Não	A descrição da regra do grupo de segurança. A descrição deve ter de 2 a 256 caracteres e não pode começar com http:// ou https://.	testDescription
Priority	integer	Sim	A prioridade da regra do grupo de segurança. Um valor menor indica uma prioridade maior. Valores válidos: 1 a 100.	1
SourceCidrIp	string	Não	O bloco CIDR IPv4 de origem. Há suporte para blocos CIDR e endereços IPv4.	0.0.0.0/0
Ipv6SourceCidrIp	string	Não
Ipv6DestCidrIp	string	Não

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	760bad53276431c499e30dc36f6b26be
SecurityGroupId	string	O ID do grupo de segurança recém-criado.	sg-bp1fg655nh68xyz9i***

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "760bad53276431c499e30dc36f6b26be",
  "SecurityGroupId": "sg-bp1fg655nh68xyz9i***"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	NoPermission	Permission denied.
400	CallInterface	Call Interface Happen Error.	An error occurred when you call the operation.
400	ens.interface.error	Failed to call API.
400	Invalid%s	The specified parameter %s is invalid.
400	Missing%s	You must specify the parameter %s.
400	AuthorizationLimitExceed	The limit of authorization records in the security group reaches.	The number of security group rules exceeds the limit.
400	SecurityGroupRuleConflict.Duplicated	The SecurityGroup rule already exists.	duplicate security group rules.
400	InvalidParameter.PortRange	The parameter PortRange is not valid.	The port range is not configured correctly.
400	InvalidParameter.CidrIp	The parameter CidrIp is not valid.	The security group rule CIDR block parameter is invalid.
400	QuotaExceed.SecurityGroup	The maximum number of security groups is reached.	The number of security groups exceeds the quota limit.
400	InvalidParameter.DestIpConflict	The Parameters DestCidrIp and Ipv6DestCidrIp cannot be set at the same time.	Parameter DestCidrIp and Ipv6DestCidrIp cannot be set at the same time.
400	InvalidParameter.Ipv4ProtocolConflictWithIpv6Address	IPv6 address cannot be specified for IPv4-specific protocol.	The IPv4 protocol cannot specify an IPv6 address.
400	InvalidParameter.Ipv6ProtocolConflictWithIpv4Address	IPv4 address cannot be specified for IPv6-specific protocol.	The IPv6 protocol cannot specify an IPv4 address.
400	InvalidParameter.SourceIpConflict	The Parameters SourceCidrIp and Ipv6SourceCidrIp cannot be set at the same time.	Parameter SourceCidrIp and Ipv6SourceCidrIp cannot be set at the same time.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.