AuthorizeSecurityGroup - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Adiciona uma ou mais regras de entrada a um grupo de segurança no Elastic Compute Service (ECS). Esta operação permite especificar permissões de acesso de entrada para um grupo de segurança, a fim de permitir ou negar o tráfego de entrada de outros dispositivos para as instâncias no grupo de segurança, implementando assim um controle de acesso à rede granular.

Descrição da operação

Antes de começar

Limite de cota: O número total de regras (incluindo regras de entrada e saída) em todos os grupos de segurança associados a uma única Elastic Network Interface (ENI) não pode exceder 1.000. Para obter mais informações sobre os limites, consulte Limites de grupos de segurança.
Configurações de prioridade: A prioridade de uma regra de entrada varia de 1 a 100. Um valor menor indica uma prioridade maior. Para regras de grupo de segurança com a mesma prioridade, as regras que negam acesso (drop) têm precedência.

Precauções

Se a regra de grupo de segurança especificada já existir, a chamada será bem-sucedida, mas nenhuma nova regra será adicionada.

Definição de regra

Os seguintes parâmetros são necessários para definir uma regra de entrada:

Configurações de origem: Especifique um dos seguintes parâmetros: SourceCidrIp (endereço IPv4), Ipv6SourceCidrIp (endereço IPv6), SourcePrefixListId (ID da lista de prefixos) ou SourceGroupId (grupo de segurança de origem).
Intervalo de portas de destino: PortRange.
Tipo de protocolo: IpProtocol.
Política de acesso: Policy.

Nota

Grupos de segurança avançados não suportam autorização para acesso de outros grupos de segurança. Um grupo de segurança básico suporta autorização para até 20 grupos de segurança.

Exemplos de solicitação

Os exemplos a seguir mostram como adicionar regras de entrada com diferentes origens a um grupo de segurança especificado na região China (Hangzhou):

Adicionar permissões de acesso para um intervalo de endereços IP especificado.

"RegionId":"cn-hangzhou", // Especifique o ID da região.
"SecurityGroupId":"sg-bp67acfmxazb4p****", // Especifique o ID do grupo de segurança.
"Permissions":[
     {
       "SourceCidrIp":"10.0.0.0/8", // Especifique o endereço IPv4 de origem.
       "PortRange":"22/22", // Especifique o intervalo de portas.
       "IpProtocol":"TCP", // Especifique o tipo de protocolo.
       "Policy":"Accept" // Especifique a política de acesso.
     }
]

Adicionar permissões de acesso para outro grupo de segurança e uma lista de prefixos.

"RegionId":"cn-hangzhou",
"SecurityGroupId":"sg-bp67acfmxazb4p****",
"Permissions":[
     {
       "SourceGroupId":"sg-bp17vs63txqxbd****", // Especifique o ID do grupo de segurança de origem.
       "PortRange":"22/22",
       "IpProtocol":"TCP",
       "Policy":"Drop"
     },{
       "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", // Especifique o ID da lista de prefixos de origem.
       "PortRange":"22/22",
       "IpProtocol":"TCP",
       "Policy":"Drop"
     }
]

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do grupo de segurança. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
RegionId	string	Sim	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para obter mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000
RegionId	string	Sim	O ID do grupo de segurança.	sg-bp67acfmxazb4p****
ClientToken	string	Não	As regras do grupo de segurança. Comprimento do array: 1 a 100.	123e4567-e89b-12d3-a456-426655440000
ClientToken	string	Não	[Deprecated] Use Permissions.N.Policy para configurar a política de acesso.	accept
SecurityGroupId	string	Sim	[Deprecated] Use Permissions.N.Priority para especificar a prioridade da regra do grupo de segurança.	1
SecurityGroupId	string	Sim	[Deprecated] Use Permissions.N.IpProtocol para especificar o tipo de protocolo.	ALL
Permissions	array<object>	Não	[Deprecated] Use Permissions.N.SourceCidrIp para especificar o bloco CIDR IPv4 de origem.	10.0.0.0/8
	object	Não	A regra do grupo de segurança.
Policy	string	Não	Configurações para permissões de acesso. Valores válidos: accept: Aceita o acesso. drop: Nega o acesso sem retornar uma resposta de negação. A solicitação parece atingir o tempo limite ou a conexão não pode ser estabelecida. Valor padrão: accept.	accept
Priority	string	Não	A prioridade da regra do grupo de segurança. Um valor menor indica uma prioridade maior. Valores válidos: 1 a 100. Valor padrão: 1.	1
IpProtocol	string	Não	O protocolo da camada de rede ou da camada de transporte. Dois tipos de valores são suportados: Nomes de protocolos sem distinção entre maiúsculas e minúsculas. Valores válidos: ICMP GRE TCP UDP ALL: Todos os protocolos são suportados. Números de protocolo que estão em conformidade com as especificações da IANA, que são inteiros de 0 a 255. As seguintes regiões atualmente suportam este recurso: Filipinas Reino Unido Malásia Hohhot Qingdao Oeste dos EUA Singapura	ALL
SourceCidrIp	string	Não	O bloco CIDR IPv4 de origem para o qual você deseja definir permissões de acesso. As configurações suportam faixas de endereços no formato CIDR e no formato IPv4.	10.0.0.0/8
Ipv6SourceCidrIp	string	Não	O bloco CIDR IPv6 de origem para o qual você deseja definir permissões de acesso. As configurações suportam faixas de endereços no formato CIDR e no formato IPv6. Nota Este parâmetro entra em vigor apenas para instâncias ECS conectadas à VPC que suportam IPv6. Este parâmetro e `SourceCidrIp` não podem ser especificados ao mesmo tempo.	2001:250:6000::***
SourceGroupId	string	Não	O ID do grupo de segurança de origem para o qual você deseja definir permissões de acesso. Especifique pelo menos um dos seguintes parâmetros: `SourceGroupId`, `SourceCidrIp`, `Ipv6SourceCidrIp` ou `SourcePrefixListId`. Se `SourceGroupId` for especificado, mas `SourceCidrIp` ou `Ipv6SourceCidrIp` não for especificado, o parâmetro `NicType` só poderá ser definido como `intranet`. Se ambos `SourceGroupId` e `SourceCidrIp` forem especificados, `SourceCidrIp` terá precedência.	sg-bp67acfmxazb4p****
SourcePrefixListId	string	Não	O ID da lista de prefixos de origem para a qual você deseja definir permissões de acesso. Você pode chamar DescribePrefixLists para consultar IDs de listas de prefixos disponíveis. Notas de uso: Se você especificar um dos parâmetros `SourceCidrIp`, `Ipv6SourceCidrIp` ou `SourceGroupId`, este parâmetro será ignorado. Para mais informações, consulte Limites de grupos de segurança.	pl-x1j1k5ykzqlixdcy****
PortRange	string	Não	A faixa de portas de destino correspondentes ao protocolo para o grupo de segurança. Valores válidos: TCP/UDP: Os valores válidos são de 1 a 65535. Separe a porta inicial e a porta final com uma barra (/). Exemplo: 1/200. ICMP: -1/-1. GRE: -1/-1. Se IpProtocol estiver definido como ALL: -1/-1. Para mais informações sobre cenários comuns de portas, consulte Portas comuns.	80/80
DestCidrIp	string	Não	O bloco CIDR IPv4 de destino. Blocos CIDR e faixas de endereços IPv4 são suportados. Este parâmetro é usado para suportar regras de quíntupla. Para mais informações, consulte Regras de quíntupla de grupo de segurança.	10.0.0.0/8
Ipv6DestCidrIp	string	Não	O bloco CIDR IPv6 de destino. As configurações suportam faixas de endereços no formato CIDR e no formato IPv6. Este parâmetro é usado para suportar regras de quíntupla. Para mais informações, consulte Regras de quíntupla de grupo de segurança. Nota Este parâmetro entra em vigor apenas para instâncias ECS conectadas à VPC que suportam IPv6. Este parâmetro e `DestCidrIp` não podem ser especificados ao mesmo tempo.	2001:250:6000::***
SourcePortRange	string	Não	A faixa de portas de origem correspondentes ao protocolo para o grupo de segurança. Valores válidos: TCP/UDP: Os valores válidos são de 1 a 65535. Separe a porta inicial e a porta final com uma barra (/). Exemplo: 1/200. ICMP: -1/-1. GRE: -1/-1. Se IpProtocol estiver definido como ALL: -1/-1. Este parâmetro é usado para suportar regras de quíntupla. Para mais informações, consulte Regras de quíntupla de grupo de segurança.	7000/8000
SourceGroupOwnerAccount	string	Não	A conta Alibaba Cloud que possui o grupo de segurança de origem quando você define uma regra de grupo de segurança entre contas. As configurações se aplicam da seguinte forma: Se nem `SourceGroupOwnerAccount` nem `SourceGroupOwnerId` estiverem definidos, a regra será criada para definir permissões de acesso para outro grupo de segurança dentro da sua conta. Se o parâmetro `SourceCidrIp` for especificado, o parâmetro `SourceGroupOwnerAccount` será ignorado.	test@aliyun.com
SourceGroupOwnerId	integer	Não	O ID da conta Alibaba Cloud que possui o grupo de segurança de origem quando você define uma regra de grupo de segurança entre contas. As configurações se aplicam da seguinte forma: Se nem `SourceGroupOwnerAccount` nem `SourceGroupOwnerId` estiverem definidos, a regra será criada para definir permissões de acesso para outro grupo de segurança dentro da sua conta. Se o parâmetro `SourceCidrIp` for especificado, o parâmetro `SourceGroupOwnerAccount` será ignorado.	1234567890
NicType	string	Não	O tipo de placa de interface de rede (NIC) para uma regra de grupo de segurança de rede clássica. As configurações incluem os seguintes valores válidos: internet: placa de interface de rede (NIC) pública. intranet: placa de interface de rede (NIC) interna. Para regras de grupo de segurança VPC, você não precisa definir o tipo de placa de interface de rede (NIC). O valor padrão é intranet, e apenas intranet é suportado. Quando você configura grupos de segurança para acessarem uns aos outros, ou seja, apenas o parâmetro DestGroupId é especificado, apenas intranet é suportado. Valor padrão: internet.	intranet
Description	string	Não	A descrição da regra do grupo de segurança. A descrição deve ter de 1 a 512 caracteres de comprimento.	This is description.
PortRangeListId	string	Não	O ID do catálogo de endereços de portas. Você pode invocar `DescribePortRangeLists` para consultar IDs de catálogos de endereços de portas disponíveis. Se você especificar `Permissions.N.PortRange`, este parâmetro será ignorado. Catálogos de endereços de portas não são suportados quando o tipo de rede do grupo de segurança é rede clássica. Para mais informações sobre limites de grupos de segurança e catálogos de endereços de portas, consulte Limites de grupos de segurança. As configurações para catálogos de endereços de portas estão sujeitas a esses limites.	prl-2ze9743****
Policy `deprecated`	string	Não	[Deprecated] Use Permissions.N.Ipv6SourceCidrIp para especificar o bloco CIDR IPv6 de origem.	2001:250:6000::***
Priority `deprecated`	string	Não	[Deprecated] Use Permissions.N.SourceGroupId para especificar o ID do grupo de segurança de origem.	sg-bp67acfmxazb4p****
IpProtocol `deprecated`	string	Não	[Deprecated] Use Permissions.N.SourcePrefixListId para especificar o ID da lista de prefixos de origem.	pl-x1j1k5ykzqlixdcy****
SourceCidrIp `deprecated`	string	Não	[Deprecated] Use Permissions.N.PortRange para especificar o intervalo de portas.	22/22
Ipv6SourceCidrIp `deprecated`	string	Não	[Deprecated] Use Permissions.N.DestCidrIp para especificar o bloco CIDR IPv4 de destino.	10.0.0.0/8
SourceGroupId `deprecated`	string	Não	[Deprecated] Use Permissions.N.Ipv6DestCidrIp para especificar o bloco CIDR IPv6 de destino.	null
SourcePrefixListId `deprecated`	string	Não	[Deprecated] Use Permissions.N.SourcePortRange para especificar o intervalo de portas de origem.	22/22
PortRange `deprecated`	string	Não	[Deprecated] Use Permissions.N.SourceGroupOwnerAccount para especificar a conta Alibaba Cloud à qual o grupo de segurança de origem pertence.	test@aliyun.com
DestCidrIp `deprecated`	string	Não	[Deprecated] Use Permissions.N.SourceGroupOwnerId para especificar o ID da conta Alibaba Cloud à qual o grupo de segurança de origem pertence.	1234567890
Ipv6DestCidrIp `deprecated`	string	Não	[Deprecated] Use Permissions.N.NicType para especificar o tipo de NIC.	intranet
SourcePortRange `deprecated`	string	Não	[Deprecated] Use Permissions.N.Description para especificar a descrição da regra do grupo de segurança.	This is description.
SourceGroupOwnerAccount `deprecated`	string	Não	Obsoleto. Use `Permissions.N.SourceGroupOwnerAccount` para especificar a conta Alibaba Cloud que possui o grupo de segurança de origem.	test@aliyun.com
SourceGroupOwnerId `deprecated`	integer	Não	Obsoleto. Use `Permissions.N.SourceGroupOwnerId` para especificar o ID da conta Alibaba Cloud que possui o grupo de segurança de origem.	1234567890
NicType `deprecated`	string	Não	Obsoleto. Use `Permissions.N.NicType` para especificar o tipo de NIC.	intranet
Description `deprecated`	string	Não	Obsoleto. Use `Permissions.N.Description` para especificar a descrição da regra do grupo de segurança.	This is description.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	OperationDenied	The specified IpProtocol does not exist or IpProtocol and PortRange do not match.	O snapshot especificado não pode ser usado para criar um disco de dados.
400	InvalidIpProtocol.Malformed	The specified parameter PortRange is not valid.	O formato do parâmetro de protocolo IP é inválido e o parâmetro PortRange é inválido.
400	InvalidSourceCidrIp.Malformed	The specified parameter SourceCidrIp is not valid.	O formato do parâmetro de intervalo de endereços IP de origem é inválido.
400	InvalidPolicy.Malformed	The specified parameter Policy is not valid.	O parâmetro especificado é inválido. Verifique se o parâmetro está correto.
400	InvalidNicType.ValueNotSupported	The specified NicType does not exist.	O tipo de rede especificado não existe. Verifique se o tipo de rede está correto.
400	InvalidNicType.Mismatch	The specified NicType conflicts with the authorization record.	O tipo de NIC especificado entra em conflito com as informações da regra.
400	InvalidSourceGroupId.Mismatch	Specified security group and source group are not in the same VPC.	O grupo de segurança especificado e o grupo de segurança de origem não estão na mesma VPC.
400	InvalidSourceGroup.NotFound	Specified source security group does not exist.	A regra de entrada especificada do grupo de segurança não existe ou os parâmetros relevantes estão ausentes.
400	InvalidPriority.Malformed	The parameter Priority is invalid.	O parâmetro Priority especificado é inválido.
400	InvalidPriority.ValueNotSupported	The specified parameter %s is invalid.	A prioridade da regra do grupo de segurança é inválida. O intervalo válido é de 1 a 100.
400	InvalidSecurityGroupDiscription.Malformed	The specified security group rule description parameter %s is not valid.	A descrição do grupo de segurança especificada é inválida.
400	InvalidSecurityGroup.InvalidNetworkType	The specified security group network type is not support this operation, please check the security group network types. For VPC security groups, ClassicLink must be enabled.	O tipo de rede do grupo de segurança especificado não oferece suporte a esta operação.
400	MissingParameter.Source	One of the parameters SourceCidrIp, Ipv6SourceCidrIp, SourceGroupId or SourcePrefixListId in %s must be specified.	Os parâmetros SourceCidrIp e SourceGroupId não podem estar ambos vazios.
400	InvalidParam.PortRange	The specified parameter %s is not valid. It should be two integers less than 65535 in ?/? format.	Especifique um intervalo de portas de destino ou um intervalo de portas de origem. O número da porta deve ser menor que 65535. Use uma barra (/) para separar as portas inicial e final em um intervalo de portas.
400	InvalidIpProtocol.ValueNotSupported	The parameter %s must be specified with case insensitive TCP, UDP, ICMP, GRE or All.	O valor especificado para o parâmetro de protocolo IP não é suportado.
400	InvalidSecurityGroupId.Malformed	The specified parameter SecurityGroupId is not valid.	O SecurityGroupId especificado é inválido.
400	InvalidParamter.Conflict	The specified SourceCidrIp should be different from the DestCidrIp.	Os grupos de segurança autorizador e autorizado devem ser diferentes.
400	InvalidSourcePortRange.Malformed	The specified parameter SourcePortRange is not valid.	O parâmetro SourcePortRange especificado é inválido.
400	InvalidPortRange.Malformed	The specified parameter PortRange must set.	O parâmetro PortRange deve ser especificado.
400	InvalidParam.SourceIp	The Parameters SourceCidrIp and Ipv6SourceCidrIp in %s cannot be set at the same time.	O parâmetro SourceIp especificado é inválido.
400	InvalidParam.DestIp	The Parameters DestCidrIp and Ipv6DestCidrIp in %s cannot be set at the same time.	O parâmetro DestIp especificado é inválido.
400	InvalidParam.Ipv6DestCidrIp	The specified parameter %s is not valid.	O parâmetro especificado é inválido.
400	InvalidParam.Ipv6SourceCidrIp	The specified parameter %s is not valid.	O parâmetro especificado é inválido.
400	InvalidParam.Ipv4ProtocolConflictWithIpv6Address	IPv6 address cannot be specified for IPv4-specific protocol.	O parâmetro especificado é inválido. Verifique se um endereço IPv6 foi especificado para o protocolo IPv4.
400	InvalidParam.Ipv6ProtocolConflictWithIpv4Address	IPv4 address cannot be specified for IPv6-specific protocol.	O parâmetro especificado é inválido. Verifique se um endereço IPv4 foi especificado para o protocolo IPv6.
400	InvalidParameter.Ipv6CidrIp	The specified Ipv6CidrIp is not valid.	O parâmetro Ipv6CidrIp especificado é inválido.
400	InvalidGroupAuthParameter.OperationDenied	The security group can not authorize to enterprise level security group.	Um grupo de segurança não pode ser autorizado para um grupo de segurança avançado.
400	InvalidDestCidrIp.Malformed	The specified parameter DestCidrIp is not valid.	O DestCidrIp especificado é inválido. Verifique se o parâmetro está correto.
400	InvalidParameter.Conflict	IPv6 and IPv4 addresses cannot exist at the same time.	Os parâmetros especificados estão em conflito entre si.
400	InvalidParam.PrefixListAddressFamilyMismatch	The address family of the specified prefix list does not match the specified CidrIp.	A família de endereços da lista de prefixos especificada não corresponde à família de endereços do CidrIP especificado.
400	NotSupported.ClassicNetworkPrefixList	The prefix list is not supported when the network type of security group is classic.	O tipo de rede do grupo de segurança é a rede clássica. As listas de prefixos não são suportadas.
400	AuthorizedGroupRule.LimitExceed	You have reached the limit on the number of group authorization rules that you can add to a security group.When authorization object of rule is security group, the limit is 20.	Um grupo de segurança básico pode conter no máximo 20 regras que autorizam outros grupos de segurança.
400	InvalidParam.SourceCidrIp	The specified parameter %s is not valid.	O parâmetro SourceCidrIp é inválido.
400	InvalidParam.DestCidrIp	The specified parameter %s is not valid.	O parâmetro DestCidrIp especificado é inválido.
400	MissingParameter	%s	Um parâmetro obrigatório está ausente.
400	InvalidParam.Permissions	The specified parameter Permissions cannot coexist with other parameters.	O parâmetro Permissions especificado não pode ser usado junto com outros parâmetros.
400	InvalidParam.DuplicatePermissions	There are duplicate permissions in the specified parameter Permissions.	O parâmetro Permissions especificado contém regras duplicadas.
400	InvalidGroupParameter.OperationDenied	The attributes Policy, SourceGroupId, DestGroupId of enterprise level security groups are not allowed to be set or modified.	Os atributos Priority, Policy, SourceGroupId e DestGroupId de um grupo de segurança avançado não podem ser definidos ou modificados.
400	InvalidParam.ProtocolNotSupportPortRangeList	The specified protocol does not support the port range list.	O protocolo especificado não suporta listas de portas.
400	InvalidPortRangeListId.NotFound	The specified port range list was not found.	A lista de portas especificada não existe.
401	InvalidOperation.SecurityGroupNotAuthorized	The specified security group is not authorized to operate.	Você não tem permissões para realizar operações no grupo de segurança atual.
500	InternalError	The request processing has failed due to some unknown error.
403	InvalidSourceGroupId.Mismatch	NicType is required or NicType expects intranet.	O grupo de segurança especificado e o grupo de segurança de origem não estão na mesma VPC.
403	MissingParameter	The input parameter SourceGroupId or SourceCidrIp cannot be both blank.	Um parâmetro obrigatório está ausente.
403	AuthorizationLimitExceed	The limit of authorization records in the security group reaches.
403	InvalidParamter.Conflict	The specified SecurityGroupId should be different from the SourceGroupId.	Os grupos de segurança autorizador e autorizado devem ser diferentes.
403	InvalidNetworkType.Mismatch	The specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic).	O tipo de rede da instância não oferece suporte ao método de cobrança de rede especificado.
403	InvalidNetworkType.Conflict	The specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic).	O tipo de rede do SecurityGroup especificado deve ser o mesmo do SourceGroup.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Os grupos de segurança gerenciados por serviços de nuvem não podem ser modificados.
403	LimitExceed.PrefixListAssociationResource	The number of resources associated with the prefix list exceeds the limit.	O número de recursos associados à lista de prefixos excede o limite.
404	InvalidSecurityGroupId.NotFound	The specified SecurityGroupId does not exist.	O grupo de segurança especificado não existe na conta do usuário. Verifique se o ID do grupo de segurança está correto.
404	InvalidSourceGroupId.NotFound	The SourceGroupId provided does not exist in our records.	O grupo de segurança de entrada especificado não existe.
404	InvalidPrefixListId.NotFound	The specified prefix list was not found.	A lista de prefixos não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.