Todos os produtos
Search
Central de documentação

:AuthorizeSecurityGroupEgress

Última atualização: Jul 03, 2026

Cria uma ou mais regras de saída em um grupo de segurança. Use as regras criadas para permitir ou negar o tráfego de saída das instâncias no grupo de segurança para outros objetos.

Descrição

Ao chamar esta operação, observe os seguintes itens:

  • O número total de regras de entrada e saída em cada grupo de segurança não pode exceder 200. Para obter mais informações, consulte a seção "Limites de grupos de segurança" em Limites.

  • Defina Policy como accept ou drop em cada regra do grupo de segurança para permitir ou negar o acesso.

  • Os valores válidos de Priority variam de 1 a 100. Um valor menor indica uma prioridade maior.

  • Quando várias regras do grupo de segurança têm a mesma prioridade, as regras drop têm precedência.

  • O destino pode ser um bloco CIDR especificado por DestCidrIp, Ipv6DestCidrIp ou DestPrefixListId, ou podem ser instâncias do Elastic Compute Service (ECS) em um grupo de segurança especificado por DestGroupId.

  • Em grupos de segurança avançados, não é possível usar grupos de segurança como objetos de autorização.

  • Para cada grupo de segurança básico, até 20 grupos de segurança podem ser usados como objetos de autorização.

  • Se a regra especificada já existir no grupo de segurança, a chamada para AuthorizeSecurityGroupEgress será bem-sucedida, mas nenhuma nova regra será criada.

  • O prefixo Permissions.N foi adicionado a alguns parâmetros para gerar novos parâmetros. Não é possível especificar simultaneamente os parâmetros originais e os correspondentes com o prefixo Permissions.N. Recomendamos o uso dos parâmetros com o prefixo Permissions.N.

  • Determine uma regra do grupo de segurança especificando um dos seguintes conjuntos de parâmetros. Não é possível definir uma regra usando apenas um parâmetro isolado.

    • Parâmetros para especificar uma regra de saída que controla o acesso a um bloco CIDR específico: SecurityGroupId, Permissions.N.IpProtocol, Permissions.N.PortRange, Permissions.N.SourcePortRange, Permissions.N.NicType, Permissions.N.Policy e Permissions.N.DestCidrIp. O parâmetro Permissions.N.SourcePortRange é opcional. Exemplo de solicitação:

      
              http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroupEgress
              &SecurityGroupId=sg-bp67acfmxazb4ph***
              &Permissions.1.IpProtocol=ICMP
              &Permissions.1.DestCidrIp=10.0.0.0/8
              &Permissions.1.PortRange=-1/-1
              &Permissions.1.NicType=intranet
              &Permissions.1.Policy=Accept
              &<Common request parameters>
              
    • Parâmetros para especificar uma regra de saída que controla o acesso a outro grupo de segurança: SecurityGroupId, Permissions.N.IpProtocol, Permissions.N.PortRange, Permissions.N.SourcePortRange, Permissions.N.NicType, Permissions.N.Policy, Permissions.N.DestGroupOwnerAccount e Permissions.N.DestGroupId. O parâmetro Permissions.N.SourcePortRange é opcional. Exemplo de solicitação:

      
              http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroupEgress
              &SecurityGroupId=sg-bp67acfmxazb4ph***
              &Permissions.1.DestGroupId=sg-bp67acfmxazb4pi***
              &Permissions.1.DestGroupOwnerAccount=Test@aliyun.com
              &Permissions.1.IpProtocol=TCP
              &Permissions.1.PortRange=22/22
              &Permissions.1.NicType=intranet
              &Permissions.1.Policy=Drop
              &<Common request parameters>
              
    • Parâmetros para especificar uma regra de saída que controla o acesso a uma lista de prefixos: SecurityGroupId, Permissions.N.IpProtocol, Permissions.N.PortRange, Permissions.N.SourcePortRange, Permissions.N.NicType, Permissions.N.Policy e Permissions.N.DestPrefixListId. O parâmetro Permissions.N.SourcePortRange é opcional. Neste caso, as listas de prefixos suportam apenas grupos de segurança em virtual private clouds (VPCs). NicType deve ser definido como intranet. Exemplo de solicitação:

      
              http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroupEgress
              &SecurityGroupId=sg-bp67acfmxazb4ph***
              &Permissions.1.DestPrefixListId=pl-x1j1k5ykzqlixdcy****
              &Permissions.1.DestGroupOwnerAccount=Test@aliyun.com
              &Permissions.1.IpProtocol=TCP
              &Permissions.1.PortRange=22/22
              &Permissions.1.NicType=intranet
              &Permissions.1.Policy=Drop
              &<Common request parameters>
              

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimAuthorizeSecurityGroupEgress

A operação a ser executada. Defina o valor como AuthorizeSecurityGroupEgress.

RegionIdStringSimcn-hangzhou

O ID da região do grupo de segurança de origem. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

ClientTokenStringNão123e4567-e89b-12d3-a456-426655440000

O token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o valor, mas certifique-se de que ele seja exclusivo entre diferentes solicitações. O valor de ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para obter mais informações, consulte Como garantir a idempotência.

SecurityGroupIdStringSimsg-bp67acfmxazb4p****

O ID do grupo de segurança.

Permissions.N.PolicyStringNãoaccept

A ação da regra N do grupo de segurança que determina se o acesso de saída é permitido. Valores válidos:

  • accept: permite o acesso.
  • drop: nega o acesso e não retorna respostas. Nesse caso, a solicitação expira ou a conexão não pode ser estabelecida.

Valor padrão: accept.

Valores válidos de N: 1 a 100.

Permissions.N.PriorityStringNão1

A prioridade da regra N do grupo de segurança. Um valor menor indica uma prioridade maior. Valores válidos: 1 a 100.

Valor padrão: 1.

Valores válidos de N: 1 a 100.

Permissions.N.IpProtocolStringNãoALL

O protocolo da camada de transporte da regra N do grupo de segurança. Os valores não diferenciam maiúsculas de minúsculas. Valores válidos:

  • TCP
  • UDP
  • ICMP
  • ICMPv6
  • GRE
  • ALL: todos os protocolos são suportados.

Valores válidos de N: 1 a 100.

Permissions.N.DestCidrIpStringNão10.0.0.0/8

O bloco CIDR IPv4 de destino para a regra N do grupo de segurança. Blocos CIDR e endereços IPv4 são suportados.

Valores válidos de N: 1 a 100.

Permissions.N.Ipv6DestCidrIpStringNão2001:db8:1233:1a00::***

O bloco CIDR IPv6 de destino para a regra N do grupo de segurança. Blocos CIDR e endereços IPv6 são suportados.

Valores válidos de N: 1 a 100.

Nota O parâmetro Permissions.N.Ipv6DestCidrIp é válido apenas quando o destino são instâncias ECS residentes em VPCs que suportam blocos CIDR IPv6. Não é possível especificar este parâmetro e o parâmetro DestCidrIp simultaneamente.
Permissions.N.DestGroupIdStringNãosg-bp67acfmxazb4p****

O ID do grupo de segurança de destino a ser referenciado na regra N do grupo de segurança.

  • Pelo menos um entre DestGroupId, DestCidrIp, Ipv6DestCidrIp e DestPrefixListId deve ser especificado.
  • Se DestGroupId for especificado, mas DestCidrIp não for, o parâmetro NicType deverá ser definido como intranet.
  • Se ambos DestGroupId e DestCidrIp forem especificados, DestCidrIp terá precedência.

Valores válidos de N: 1 a 100.

Observe os seguintes itens:

  • Em grupos de segurança avançados, grupos de segurança não podem ser usados como objetos de autorização.
  • Para cada grupo de segurança básico, até 20 grupos de segurança podem ser usados como objetos de autorização.
Permissions.N.DestPrefixListIdStringNãopl-x1j1k5ykzqlixdcy****

O ID da lista de prefixos de destino a ser referenciado na regra N do grupo de segurança. Chame a operação DescribePrefixLists para consultar os IDs das listas de prefixos disponíveis.

Observe os seguintes itens:

  • Se um grupo de segurança estiver na rede clássica, não será possível referenciar listas de prefixos nas regras desse grupo. Para obter informações sobre os limites de grupos de segurança e listas de prefixos, consulte a seção "Limites de grupos de segurança" em Limites.
  • Se você especificar DestCidrIp, Ipv6DestCidrIp ou DestGroupId, Permissions.N.DestPrefixListId será ignorado.

Valores válidos de N: 1 a 100.

Permissions.N.PortRangeStringNão80/80

O intervalo de portas de destino correspondente ao protocolo da camada de transporte para a regra N do grupo de segurança. Valores válidos:

  • Quando o parâmetro Permissions.N.IpProtocol é definido como TCP ou UDP, o intervalo de números de porta é de 1 a 65535. Especifique um intervalo de portas no formato <Número da porta inicial>/<Número da porta final>. Exemplo: 1/200.
  • Quando o parâmetro Permissions.N.IpProtocol é definido como ICMP, o intervalo de números de porta é -1/-1, o que indica todas as portas.
  • Quando o parâmetro Permissions.N.IpProtocol é definido como GRE, o intervalo de números de porta é -1/-1, o que indica todas as portas.
  • Quando o parâmetro Permissions.N.IpProtocol é definido como ALL, o intervalo de números de porta é -1/-1, o que indica todas as portas.

Valores válidos de N: 1 a 100.

Permissions.N.SourceCidrIpStringNão10.0.0.0/8

O bloco CIDR IPv4 de origem para a regra N do grupo de segurança. Blocos CIDR e endereços IPv4 são suportados.

Este parâmetro é compatível com regras de quíntupla. Para obter mais informações, consulte Regras de quíntupla de grupos de segurança.

Valores válidos de N: 1 a 100.

Permissions.N.Ipv6SourceCidrIpStringNão2001:db8:1234:1a00::***

O bloco CIDR IPv6 de origem para a regra N do grupo de segurança. Blocos CIDR e endereços IPv6 são suportados.

Este parâmetro é compatível com regras de quíntupla. Para obter mais informações, consulte Regras de quíntupla de grupos de segurança.

Valores válidos de N: 1 a 100.

Nota O parâmetro Permissions.N.Ipv6SourceCidrIp é válido apenas quando a origem são instâncias ECS residentes em VPCs que suportam blocos CIDR IPv6. Não é possível especificar este parâmetro e o parâmetro DestCidrIp simultaneamente.
Permissions.N.SourcePortRangeStringNão80/80

O intervalo de portas de origem correspondente ao protocolo da camada de transporte para a regra N do grupo de segurança. Valores válidos:

  • Quando o parâmetro Permissions.N.IpProtocol é definido como TCP ou UDP, o intervalo de números de porta é de 1 a 65535. Separe o número da porta inicial e o número da porta final com uma barra (/). Exemplo: 1/200.
  • Quando o parâmetro Permissions.N.IpProtocol é definido como ICMP, o intervalo de números de porta é -1/-1, o que indica todas as portas.
  • Quando o parâmetro Permissions.N.IpProtocol é definido como GRE, o intervalo de números de porta é -1/-1, o que indica todas as portas.
  • Quando o parâmetro Permissions.N.IpProtocol é definido como ALL, o intervalo de números de porta é -1/-1, o que indica todas as portas.

Este parâmetro é especificado para atender às regras de quíntupla. Para obter mais informações, consulte Regras de quíntupla de grupos de segurança.

Valores válidos de N: 1 a 100.

Permissions.N.DestGroupOwnerAccountStringNãoTest@aliyun.com

A conta Alibaba Cloud que gerencia o grupo de segurança de destino ao configurar a regra N do grupo de segurança entre contas.

  • Se nem DestGroupOwnerAccount nem DestGroupOwnerId forem especificados, a regra será criada para controlar o acesso a outro grupo de segurança dentro da sua conta Alibaba Cloud.
  • Se DestCidrIp for especificado, DestGroupOwnerAccount será ignorado.

Valores válidos de N: 1 a 100.

Permissions.N.DestGroupOwnerIdLongNão12345678910

O ID da conta Alibaba Cloud que gerencia o grupo de segurança de destino ao configurar a regra N do grupo de segurança entre contas.

  • Se nem DestGroupOwnerId nem DestGroupOwnerAccount forem especificados, a regra será criada para controlar o acesso a outro grupo de segurança dentro da sua conta Alibaba Cloud.
  • Se você especificar o parâmetro DestCidrIp, o parâmetro DestGroupOwnerId será ignorado.

Valores válidos de N: 1 a 100.

Permissions.N.NicTypeStringNãointranet

O tipo de controlador de interface de rede (NIC) da regra N do grupo de segurança quando o grupo está na rede clássica. Valores válidos:

  • internet: NIC pública
  • intranet: NIC interna
    • Se o grupo de segurança estiver em uma VPC, este parâmetro será definido como intranet por padrão e não poderá ser modificado.
    • Se você especificar apenas DestGroupId ao configurar o acesso entre grupos de segurança, este parâmetro deverá ser definido como intranet.

Valor padrão: internet.

Valores válidos de N: 1 a 100.

Permissions.N.DescriptionStringNãoThis is description.

A descrição da regra N do grupo de segurança. A descrição deve ter de 1 a 512 caracteres.

Valores válidos de N: 1 a 100.

PolicyStringNãoaccept

Este parâmetro foi descontinuado. Use Permissions.N.Policy para especificar se o acesso de saída é permitido.

PriorityStringNão1

Este parâmetro foi descontinuado. Use Permissions.N.Priority para especificar a prioridade da regra.

IpProtocolStringNãoALL

Este parâmetro foi descontinuado. Use Permissions.N.IpProtocol para especificar o protocolo da camada de transporte.

DestCidrIpStringNão10.0.0.0/8

Este parâmetro foi descontinuado. Use Permissions.N.DestCidrIp para especificar o bloco CIDR IPv4 de destino.

Ipv6DestCidrIpStringNão2001:db8:1233:1a00::***

Este parâmetro foi descontinuado. Use Permissions.N.Ipv6DestCidrIp para especificar o bloco CIDR IPv6 de destino.

DestGroupIdStringNãosg-bp67acfmxazb4p****

Este parâmetro foi descontinuado. Use Permissions.N.DestGroupId para especificar o ID do grupo de segurança de destino.

DestPrefixListIdStringNãopl-x1j1k5ykzqlixdcy****

Este parâmetro foi descontinuado. Use Permissions.N.DestPrefixListId para especificar o ID da lista de prefixos de destino.

PortRangeStringNão80/80

Este parâmetro foi descontinuado. Use Permissions.N.PortRange para especificar o intervalo de portas de destino.

SourceCidrIpStringNão10.0.0.0/8

Este parâmetro foi descontinuado. Use Permissions.N.SourceCidrIp para especificar o bloco CIDR IPv4 de origem.

Ipv6SourceCidrIpStringNão2001:db8:1234:1a00::***

Este parâmetro foi descontinuado. Use Permissions.N.Ipv6SourceCidrIp para especificar o bloco CIDR IPv6 de origem.

SourcePortRangeStringNão80/80

Este parâmetro foi descontinuado. Use Permissions.N.SourcePortRange para especificar o intervalo de portas de origem.

DestGroupOwnerAccountStringNãoTest@aliyun.com

Este parâmetro foi descontinuado. Use Permissions.N.DestGroupOwnerAccount para especificar a conta Alibaba Cloud que gerencia o grupo de segurança de destino.

DestGroupOwnerIdLongNão12345678910

Este parâmetro foi descontinuado. Use Permissions.N.DestGroupOwnerId para especificar o ID da conta Alibaba Cloud que gerencia o grupo de segurança de destino.

NicTypeStringNãointranet

Este parâmetro foi descontinuado. Use Permissions.N.NicType para especificar o tipo de NIC.

DescriptionStringNãoThis is description.

Este parâmetro foi descontinuado. Use Permissions.N.Description para especificar a descrição da regra N do grupo de segurança.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroupEgress
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000 
&SecurityGroupId=sg-bp67acfmxazb4p****
&Permissions.1.DestGroupId=sg-bp67acfmxazb4p****
&Permissions.1.DestGroupOwnerAccount=Test@aliyun.com
&Permissions.1.IpProtocol=ALL
&Permissions.1.PortRange=22/22
&Permissions.1.NicType=intranet
&Permissions.1.Policy=Drop
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<AuthorizeSecurityGroupEgressResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AuthorizeSecurityGroupEgressResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

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

A mensagem de erro retornada porque o parâmetro IpProtocol especificado não existe ou não corresponde ao parâmetro PortRange especificado.

400

InvalidIpProtocol.Malformed

The specified parameter PortRange is not valid.

A mensagem de erro retornada porque o protocolo da camada de transporte especificado ou o parâmetro PortRange é inválido.

400

InvalidDestCidrIp.Malformed

The specified parameter DestCidrIp is not valid.

A mensagem de erro retornada porque o parâmetro DestCidrIp especificado é inválido.

400

InvalidPolicy.Malformed

The specified parameter Policy is not valid.

A mensagem de erro retornada porque o parâmetro Policy especificado é inválido.

400

InvalidNicType.ValueNotSupported

The specified NicType does not exist.

A mensagem de erro retornada porque o parâmetro NicType especificado não existe.

400

InvalidDestGroupId.Mismatch

Specified security group and destination group are not in the same VPC.

A mensagem de erro retornada porque o grupo de segurança especificado e o grupo de segurança de destino não pertencem à mesma VPC.

400

InvalidDestGroup.NotFound

Specified destination security group does not exist.

A mensagem de erro retornada porque o grupo de segurança de destino especificado não existe.

400

InvalidPriority.Malformed

The parameter Priority is invalid.

A mensagem de erro retornada porque o parâmetro Priority especificado é inválido.

400

InvalidDestCidrIp.Malformed

The parameter DestCidrIp is not valid.

A mensagem de erro retornada porque o parâmetro DestCidrIp especificado é inválido.

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.

A mensagem de erro retornada porque a operação não é compatível com o tipo de rede atual do grupo de segurança. Para grupos de segurança em VPCs, o ClassicLink deve estar ativado.

400

InvalidSecurityGroupId.Malformed

The specified parameter SecurityGroupId is not valid.

A mensagem de erro retornada porque o parâmetro SecurityGroupId especificado é inválido.

400

InvalidParamter.Conflict

The specified SourceCidrIp should be different from the DestCidrIp.

A mensagem de erro retornada porque o valor de SourceCidrIp é igual ao de DestCidrIp.

400

InvalidSourcePortRange.Malformed

The specified parameter SourcePortRange is not valid.

A mensagem de erro retornada porque o parâmetro SourcePortRange especificado é inválido.

400

InvalidParameter.Conflict

IPv6 and IPv4 addresses cannot exist at the same time.

A mensagem de erro retornada porque endereços IPv6 e IPv4 foram especificados simultaneamente.

400

InvalidParam.PrefixListAddressFamilyMismatch

The address family of the specified prefix list does not match the specified CidrIp.

A mensagem de erro retornada porque a família de endereços da lista de prefixos especificada não corresponde à do bloco CIDR especificado.

400

NotSupported.ClassicNetworkPrefixList

The prefix list is not supported when the network type of security group is classic.

A mensagem de erro retornada porque grupos de segurança na rede clássica não suportam listas de prefixos.

400

InvalidParam.DestCidrIp

The specified parameter DestCidrIp is invalid.

A mensagem de erro retornada porque o parâmetro DestCidrIp especificado é inválido.

400

InvalidParam.SourceCidrIp

The specified param SourceCidrIp is not valid.

A mensagem de erro retornada porque o parâmetro SourceCidrIp especificado é inválido.

400

InvalidParam.Permissions

The specified parameter Permissions cannot coexist with other parameters.

A mensagem de erro retornada porque um parâmetro com o prefixo Permissions não pode ser especificado simultaneamente com o parâmetro correspondente sem o prefixo Permissions.

400

InvalidParam.DuplicatePermissions

There are duplicate permissions in the specified parameter Permissions.

A mensagem de erro retornada porque as regras do grupo de segurança especificadas pelos parâmetros com o prefixo Permissions estão duplicadas.

403

InvalidDestGroupId.Mismatch

NicType is required or NicType expects intranet.

A mensagem de erro retornada porque o parâmetro NicType não foi especificado ou não está definido como intranet.

403

MissingParameter

The input parameter DestGroupId or DestCidrIp cannot be both blank.

A mensagem de erro retornada porque os parâmetros DestGroupId e DestCidrIp não podem estar vazios simultaneamente.

403

AuthorizationLimitExceed

The limit of authorization records in the security group reaches.

A mensagem de erro retornada porque o número máximo de regras no grupo de segurança foi atingido.

403

InvalidParamter.Conflict

The specified SecurityGroupId should be different from the SourceGroupId.

A mensagem de erro retornada porque o grupo de segurança de destino é igual ao grupo de segurança de origem.

403

InvalidNetworkType.Conflict

The specified SecurityGroup network type should be same with SourceGroup network type (vpc or classic).

A mensagem de erro retornada porque o tipo de rede do grupo de segurança especificado é diferente do tipo de rede do grupo de segurança de origem.

403

InvalidSecurityGroup.IsSame

The authorized SecurityGroupId should be different from the DestGroupId.

A mensagem de erro retornada porque o grupo de segurança autorizado não pode ser igual ao grupo de segurança de destino atual.

403

InvalidNetworkType.Conflict

The parameter SecurityGroup network type should be same with SourceGroup network type (vpc or classic).

A mensagem de erro retornada porque o tipo de rede do grupo de segurança especificado é diferente do tipo de rede do grupo de origem.

403

InvalidOperation.ResourceManagedByCloudProduct

%s

A mensagem de erro retornada porque 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.

A mensagem de erro retornada porque a quantidade máxima de recursos que podem ser associados à lista de prefixos foi atingida.

404

InvalidSecurityGroupId.NotFound

The specified SecurityGroupId does not exist.

A mensagem de erro retornada porque o grupo de segurança especificado não existe nesta conta. Verifique se o ID do grupo de segurança está correto.

404

InvalidDestGroupId.NotFound

The DestGroupId provided does not exist in our records.

A mensagem de erro retornada porque o parâmetro DestGroupId especificado não existe.

404

InvalidPrefixListId.NotFound

The specified prefix list was not found.

A mensagem de erro retornada porque a lista de prefixos especificada não existe.

404

InvalidSecurityGroupId.NotFound

%s

A mensagem de erro retornada porque o ID do grupo de segurança especificado não existe.

500

InternalError

The request processing has failed due to some unknown error.

A mensagem de erro retornada porque ocorreu um erro interno. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.