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.Nfoi 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 prefixoPermissions.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
Parâmetros da solicitação
| Parâmetro | Tipo | Obrigatório | Exemplo | Descrição |
| Action | String | Sim | AuthorizeSecurityGroupEgress | A operação a ser executada. Defina o valor como AuthorizeSecurityGroupEgress. |
| RegionId | String | Sim | cn-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. |
| ClientToken | String | Não | 123e4567-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. |
| SecurityGroupId | String | Sim | sg-bp67acfmxazb4p**** | O ID do grupo de segurança. |
| Permissions.N.Policy | String | Não | accept | A ação da regra N do grupo de segurança que determina se o acesso de saída é permitido. Valores válidos:
Valor padrão: accept. Valores válidos de N: 1 a 100. |
| Permissions.N.Priority | String | Não | 1 | 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.IpProtocol | String | Não | ALL | 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:
Valores válidos de N: 1 a 100. |
| Permissions.N.DestCidrIp | String | Não | 10.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.Ipv6DestCidrIp | String | Não | 2001: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.DestGroupId | String | Não | sg-bp67acfmxazb4p**** | O ID do grupo de segurança de destino a ser referenciado na regra N do grupo de segurança.
Valores válidos de N: 1 a 100. Observe os seguintes itens:
|
| Permissions.N.DestPrefixListId | String | Não | pl-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:
Valores válidos de N: 1 a 100. |
| Permissions.N.PortRange | String | Não | 80/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:
Valores válidos de N: 1 a 100. |
| Permissions.N.SourceCidrIp | String | Não | 10.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.Ipv6SourceCidrIp | String | Não | 2001: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.SourcePortRange | String | Não | 80/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:
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.DestGroupOwnerAccount | String | Não | Test@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.
Valores válidos de N: 1 a 100. |
| Permissions.N.DestGroupOwnerId | Long | Não | 12345678910 | 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.
Valores válidos de N: 1 a 100. |
| Permissions.N.NicType | String | Não | intranet | 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:
Valor padrão: internet. Valores válidos de N: 1 a 100. |
| Permissions.N.Description | String | Não | This 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. |
| Policy | String | Não | accept | Este parâmetro foi descontinuado. Use |
| Priority | String | Não | 1 | Este parâmetro foi descontinuado. Use |
| IpProtocol | String | Não | ALL | Este parâmetro foi descontinuado. Use |
| DestCidrIp | String | Não | 10.0.0.0/8 | Este parâmetro foi descontinuado. Use |
| Ipv6DestCidrIp | String | Não | 2001:db8:1233:1a00::*** | Este parâmetro foi descontinuado. Use |
| DestGroupId | String | Não | sg-bp67acfmxazb4p**** | Este parâmetro foi descontinuado. Use |
| DestPrefixListId | String | Não | pl-x1j1k5ykzqlixdcy**** | Este parâmetro foi descontinuado. Use |
| PortRange | String | Não | 80/80 | Este parâmetro foi descontinuado. Use |
| SourceCidrIp | String | Não | 10.0.0.0/8 | Este parâmetro foi descontinuado. Use |
| Ipv6SourceCidrIp | String | Não | 2001:db8:1234:1a00::*** | Este parâmetro foi descontinuado. Use |
| SourcePortRange | String | Não | 80/80 | Este parâmetro foi descontinuado. Use |
| DestGroupOwnerAccount | String | Não | Test@aliyun.com | Este parâmetro foi descontinuado. Use |
| DestGroupOwnerId | Long | Não | 12345678910 | Este parâmetro foi descontinuado. Use |
| NicType | String | Não | intranet | Este parâmetro foi descontinuado. Use |
| Description | String | Não | This is description. | Este parâmetro foi descontinuado. Use |
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.