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

Adiciona uma ou mais regras de grupo de segurança de saída. Esta operação permite especificar permissões de acesso de saída para um grupo de segurança, permitindo ou negando que instâncias no grupo de segurança enviem tráfego de saída para outros dispositivos para um controle de acesso à rede refinado.

Descrição da operação

Antes de começar

Limite de cota: O número total de regras (incluindo regras de entrada e regras de saída) em todos os grupos de segurança associados a uma única Elastic Network Interface (ENI) não pode exceder 1.000. Para mais informações sobre os limites, consulte Limites de grupos de segurança.
Configurações de prioridade: A prioridade de uma regra de grupo de segurança de saída varia de 1 a 100. Um valor menor indica uma prioridade maior. Se várias regras de grupo de segurança tiverem a mesma prioridade, a regra de negação (drop) terá 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

Para definir uma regra de grupo de segurança de saída, você deve especificar os seguintes parâmetros:

Configurações de destino: Especifique um dos seguintes parâmetros: DestCidrIp (endereço IPv4), Ipv6DestCidrIp (endereço IPv6), DestPrefixListId (ID da lista de prefixos) ou DestGroupId (grupo de segurança de destino).
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 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

Suponha que você queira adicionar várias regras de saída com destinos diferentes 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",  // Defina a região.
"SecurityGroupId":"sg-bp17vs63txqxbds9***", // Defina o grupo de segurança.
"Permissions":[
     {
       "DestCidrIp":"10.0.0.0/8", // Defina o endereço IPv4 de destino.
       "PortRange":"-1/-1", // Defina o intervalo de portas.
       "IpProtocol":"ICMP", // Defina o tipo de protocolo.
       "Policy":"Accept" // Defina 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-bp17vs63txqxbds9***",
"Permissions":[
     {
       "DestGroupId":"sg-bp67acfmxazb4pi***", // Defina o grupo de segurança de destino.
       "PortRange":"22/22",
       "IpProtocol":"TCP",
       "Policy":"Drop"
     },{
       "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", // Defina a lista de prefixos de destino.
       "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 de origem. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
ClientToken	string	Não	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 mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000
SecurityGroupId	string	Sim	O ID do grupo de segurança.	sg-bp67acfmxazb4p****
Permissions	array<object>	Não	A matriz de regras de grupo de segurança. Comprimento: 1 a 100.
	object	Não	A regra de permissão do grupo de segurança.
Policy	string	Não	As configurações de permissão de acesso. Valores válidos: accept: permite o acesso. drop: nega o acesso e não retorna uma mensagem de rejeição. A solicitação da origem sofre um tempo limite ou falha ao estabelecer uma conexão. 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 protocolo que não diferenciam maiúsculas de minúsculas. Valores válidos: ICMP GRE TCP UDP ALL: todos os protocolos. Números de protocolo padrão IANA, que são inteiros de 0 a 255. Isso é suportado nas seguintes regiões: Filipinas Reino Unido Malásia China (Hohhot) China (Qingdao) Oeste dos EUA Cingapura	ALL
DestCidrIp	string	Não	As configurações do bloco CIDR (Classless Inter-Domain Routing) IPv4 de destino para permissões de acesso. Suporta o formato CIDR e intervalos de endereços IP no formato IPv4.	10.0.0.0/8
Ipv6DestCidrIp	string	Não	As configurações do bloco CIDR (Classless Inter-Domain Routing) IPv6 de destino para permissões de acesso. Suporta o formato CIDR e intervalos de endereços IP no formato IPv6. Nota Este parâmetro é válido apenas para instâncias ECS do tipo VPC que suportam IPv6. Você não pode especificar este parâmetro e o parâmetro DestCidrIp simultaneamente.	2001:db8:1233:1a00::***
DestGroupId	string	Não	O ID do grupo de segurança de destino para o qual você deseja configurar permissões de acesso. Você deve especificar pelo menos um dos seguintes parâmetros: DestGroupId, DestCidrIp, Ipv6DestCidrIp e DestPrefixListId. Se você especificar DestGroupId, mas não especificar DestCidrIp, o parâmetro NicType só poderá ser definido como intranet. Se você especificar tanto DestGroupId quanto DestCidrIp, o parâmetro DestCidrIp terá precedência.	sg-bp67acfmxazb4p****
DestPrefixListId	string	Não	O ID da lista de prefixos de destino para a qual você deseja configurar permissões de acesso. Você pode chamar a operação DescribePrefixLists para consultar os IDs das listas de prefixos disponíveis. Precauções: Se você especificar o parâmetro DestCidrIp, Ipv6DestCidrIp ou DestGroupId, este parâmetro será ignorado. Para mais informações, consulte Limites de grupos de segurança.	pl-x1j1k5ykzqlixdcy****
PortRange	string	Não	O intervalo de portas de destino para os protocolos habilitados no grupo de segurança. Valores válidos: TCP ou UDP: 1 a 65535. Separe a porta inicial e a porta final com uma barra (/). Exemplo: 1/200. ICMP: -1/-1. GRE: -1/-1. ALL: -1/-1.	80/80
SourceCidrIp	string	Não	O bloco CIDR IPv4 de origem. Blocos CIDR e intervalos 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 para grupos de segurança.	10.0.0.0/8
Ipv6SourceCidrIp	string	Não	O bloco CIDR IPv6 de origem. Blocos CIDR e intervalos de endereços IPv6 são suportados. Este parâmetro é usado para suportar regras de quíntupla. Para mais informações, consulte Regras de quíntupla para grupos de segurança. Nota Este parâmetro é válido apenas para instâncias ECS do tipo VPC que suportam IPv6. Você não pode especificar este parâmetro e o parâmetro DestCidrIp simultaneamente.	2001:db8:1234:1a00::***
SourcePortRange	string	Não	O intervalo de portas de origem para os protocolos habilitados no grupo de segurança. Valores válidos: TCP ou UDP: 1 a 65535. Separe a porta inicial e a porta final com uma barra (/). Exemplo: 1/200. ICMP: -1/-1. GRE: -1/-1. ALL: -1/-1. Este parâmetro é usado para suportar regras de quíntupla. Para mais informações, consulte Regras de quíntupla para grupos de segurança.	80/80
DestGroupOwnerAccount	string	Não	A conta Alibaba Cloud à qual o grupo de segurança de destino pertence ao configurar regras de grupo de segurança entre contas. Se nem DestGroupOwnerAccount nem DestGroupOwnerId forem especificados, a regra será considerada como configuração de permissões de acesso para seus outros grupos de segurança. Se o parâmetro DestCidrIp for especificado, o parâmetro DestGroupOwnerAccount será inválido.	Test@aliyun.com
DestGroupOwnerId	integer	Não	O ID da conta Alibaba Cloud à qual o grupo de segurança de destino pertence ao configurar regras de grupo de segurança entre contas. Se nem DestGroupOwnerId nem DestGroupOwnerAccount forem especificados, a regra será considerada como configuração de permissões de acesso para seus outros grupos de segurança. Se o parâmetro DestCidrIp for especificado, o parâmetro DestGroupOwnerId será inválido.	12345678910
NicType	string	Não	O tipo de controlador de interface de rede (NIC) para regras de grupo de segurança no tipo de rede clássica. Valores válidos: internet: NIC pública. intranet: NIC de rede interna. Para regras de grupo de segurança em uma VPC, você não precisa definir as configurações de tipo de NIC. O valor padrão é intranet. Ao configurar o acesso mútuo entre grupos de segurança especificando apenas o parâmetro DestGroupId, o valor padrão é intranet. 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 da lista de intervalos de portas. Você pode invocar a operação DescribePortRangeLists para consultar os IDs das listas de intervalos de portas disponíveis. Se você especificar o parâmetro Permissions.N.PortRange, este parâmetro será ignorado. As configurações de lista de intervalos de portas não são suportadas quando o tipo de rede do grupo de segurança é a rede clássica. Para mais informações sobre os limites de grupos de segurança e listas de intervalos de portas, consulte Limites de grupos de segurança.	prl-2ze9743****
Policy `deprecated`	string	Não	[Deprecated] Use Permissions.N.Policy para as configurações de permissão de acesso.	accept
Priority `deprecated`	string	Não	[Deprecated] Use Permissions.N.Priority para especificar a prioridade da regra.	1
IpProtocol `deprecated`	string	Não	[Deprecated] Use Permissions.N.IpProtocol para especificar o tipo de protocolo.	ALL
DestCidrIp `deprecated`	string	Não	[Deprecated] Use Permissions.N.DestCidrIp para especificar o bloco CIDR (Classless Inter-Domain Routing) IPv4 de destino.	10.0.0.0/8
Ipv6DestCidrIp `deprecated`	string	Não	[Deprecated] Use Permissions.N.Ipv6DestCidrIp para especificar o bloco CIDR (Classless Inter-Domain Routing) IPv6 de destino.	2001:db8:1233:1a00::***
DestGroupId `deprecated`	string	Não	[Deprecated] Use Permissions.N.DestGroupId para especificar o ID do grupo de segurança de destino.	sg-bp67acfmxazb4p****
DestPrefixListId `deprecated`	string	Não	[Deprecated] Use Permissions.N.DestPrefixListId para especificar o ID da lista de prefixos de destino.	pl-x1j1k5ykzqlixdcy****
PortRange `deprecated`	string	Não	[Deprecated] Use Permissions.N.PortRange para especificar o intervalo de portas.	80/80
SourceCidrIp `deprecated`	string	Não	[Deprecated] Use Permissions.N.SourceCidrIp para especificar o bloco CIDR IPv4 de origem.	10.0.0.0/8
Ipv6SourceCidrIp `deprecated`	string	Não	[Deprecated] Use Permissions.N.Ipv6SourceCidrIp para especificar o bloco CIDR IPv6 de origem.	2001:db8:1234:1a00::***
SourcePortRange `deprecated`	string	Não	[Deprecated] Use Permissions.N.SourcePortRange para especificar o intervalo de portas de origem.	80/80
DestGroupOwnerAccount `deprecated`	string	Não	[Deprecated] Use Permissions.N.DestGroupOwnerAccount para especificar a conta Alibaba Cloud à qual o grupo de segurança de destino pertence.	Test@aliyun.com
DestGroupOwnerId `deprecated`	integer	Não	[Deprecated] Use Permissions.N.DestGroupOwnerId para especificar o ID da conta Alibaba Cloud à qual o grupo de segurança de destino pertence.	12345678910
NicType `deprecated`	string	Não	[Deprecated] Use Permissions.N.NicType para especificar o tipo de NIC.	intranet
Description `deprecated`	string	Não	[Deprecated] Use Permissions.N.Description para especificar a descrição da regra.	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	InvalidDestCidrIp.Malformed	The specified parameter DestCidrIp is not valid.	O DestCidrIp especificado é inválido. Verifique se o parâmetro está correto.
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	InvalidDestGroupId.Mismatch	Specified security group and destination group are not in the same VPC.	O grupo de segurança especificado e o grupo de segurança de destino não estão na mesma VPC.
400	InvalidDestGroup.NotFound	Specified destination security group does not exist.	O grupo de segurança de saída especificado não existe.
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.Dest	One of the parameters DestCidrIp, Ipv6DestCidrIp, DestGroupId or DestPrefixListId in %s must be specified.	Os parâmetros DestCidrIp e DestGroupId 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	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.DestCidrIp	The specified parameter %s is not valid.	O parâmetro DestCidrIp especificado é inválido.
400	InvalidParam.SourceCidrIp	The specified param SourceCidrIp is not valid.	O parâmetro SourceCidrIp é inválido.
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	InvalidDestGroupId.Mismatch	NicType is required or NicType expects intranet.	O grupo de segurança especificado e o grupo de segurança de destino não estão na mesma VPC.
403	MissingParameter	The input parameter DestGroupId or DestCidrIp 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.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	InvalidSecurityGroup.IsSame	The authorized SecurityGroupId should be different from the DestGroupId.	O SecurityGroupId autorizado não pode ser igual ao DestGroupId.
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	InvalidDestGroupId.NotFound	The DestGroupId provided does not exist in our records.	O grupo de segurança de saída 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.