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

Exclui uma ou mais regras de saída de um grupo de segurança especificado.

Descrição da operação

Importante O Alibaba Cloud ajustou as regras de validação para esta operação de API em 8 de julho de 2024. Quando você exclui uma regra de grupo de segurança que não existe, a operação de API retorna o código de falha "InvalidSecurityGroupRule.RuleNotExist" em vez de uma resposta de sucesso. Certifique-se de que seu código seja compatível com este código de falha para evitar impactos em seus serviços online.

Você pode usar um dos seguintes métodos para passar parâmetros e excluir regras de grupo de segurança:

Especifique o ID da regra do grupo de segurança para excluir regras. Este método é recomendado.
- Se o ID da regra do grupo de segurança especificado não existir, uma exceção será relatada.
Especifique o parâmetro Permissions para excluir regras.
- Se não existir nenhuma regra de grupo de segurança correspondente, a invocação será bem-sucedida, mas nenhuma regra será excluída.
- Parâmetros obrigatórios para excluir uma regra de grupo de segurança:
  - 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

Você não pode especificar o ID da regra do grupo de segurança e o parâmetro Permissions ao mesmo tempo.

Exemplos de solicitação

Exclua regras pelo ID da regra do grupo de segurança.

"SecurityGroupId":"sg-bp67acfmxazb4p****", // Especifique o ID do grupo de segurança.
"SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Especifique os IDs das regras do grupo de segurança.

Exclua regras pelo intervalo de endereços IP.

"SecurityGroupId":"sg-bp67acfmxazb4ph***",
"Permissions":[
  {
    "IpProtocol":"TCP", // Especifique o tipo de protocolo.
    "DestCidrIp":"10.0.0.0/8", // Especifique o intervalo de endereços IP de destino.
    "PortRange":"22/22", // Especifique o intervalo de portas de destino.
    "Policy":"accept" // Especifique a política de autorização.
  }
]

Exclua regras pelo grupo de segurança de destino.

"SecurityGroupId":"sg-bp67acfmxazb4ph***",
"Permissions":[
  {
    "DestGroupId":"sg-bp67acfmxa123b****", // Especifique o ID do grupo de segurança de destino.
    "IpProtocol":"TCP",
    "PortRange":"22/22",
    "Policy":"accept"
  }
]

Exclua regras pela lista de prefixos especificada.

"SecurityGroupId":"sg-bp67acfmxazb4ph***",
"Permissions":[
  {
    "IpProtocol":"TCP",
    "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", // Especifique o ID da lista de prefixos de destino.
    "PortRange":"22/22",
    "Policy":"accept",
  }
]

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
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 várias 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.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
SecurityGroupId	string	Sim	O ID do grupo de segurança.	sg-bp67acfmxazb4p****
SecurityGroupRuleId	array	Não	A matriz de IDs de regras de grupo de segurança. Comprimento da matriz: 0 a 100.
	string	Não	O ID da regra do grupo de segurança. Nota Este parâmetro é obrigatório quando você exclui regras pelo ID da regra do grupo de segurança.	sgr-bp67acfmxa123b***
Permissions	array<object>	Não	A matriz de regras de grupo de segurança. Comprimento da matriz: 0 a 100.
	object	Não	A regra do grupo de segurança.
Policy	string	Não	As permissões de acesso. Valores válidos: accept: permite o acesso. drop: nega o acesso sem retornar uma mensagem de rejeição. Isso se manifesta como um tempo limite de solicitação ou falha de conexão no lado do iniciador. 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 tipo de protocolo. O valor não diferencia maiúsculas de minúsculas. Valores válidos: TCP UDP ICMP ICMPv6 GRE ALL: todos os protocolos.	TCP
DestCidrIp	string	Não	O Classless Inter-Domain Routing IPv4 de destino para o qual você deseja revogar as permissões de acesso. Suporta o formato Classless Inter-Domain Routing e intervalos de endereços IP no formato IPv4.	10.0.0.0/8
Ipv6DestCidrIp	string	Não	O Classless Inter-Domain Routing IPv6 de destino para o qual você deseja revogar as permissões de acesso. Suporta o formato Classless Inter-Domain Routing 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 definir as configurações para este parâmetro e para o parâmetro DestCidrIp ao mesmo tempo.	2001:db8:1233:1a00::***
DestGroupId	string	Não	O ID do grupo de segurança de destino para o qual você deseja revogar as permissões de acesso. Você deve definir as configurações para pelo menos um dos seguintes parâmetros: DestGroupId, DestCidrIp, Ipv6DestCidrIp e DestPrefixListId. Se você especificar DestGroupId, mas não especificar DestCidrIp, deverá definir NicType como intranet. Se você especificar tanto DestGroupId quanto DestCidrIp, DestCidrIp terá precedência por padrão. Observe os seguintes itens: Grupos de segurança avançados não suportam autorização entre grupos de segurança. Um grupo de segurança básico pode ser autorizado a acessar até 20 outros grupos de segurança.	sg-bp67acfmxa123b****
DestPrefixListId	string	Não	A lista de prefixos de destino para a qual você deseja revogar as permissões de acesso. Você pode invocar a operação DescribePrefixLists para consultar os IDs das listas de prefixos disponíveis. Precauções: Se você especificar um dos parâmetros DestCidrIp, Ipv6DestCidrIp e DestGroupId, este parâmetro será ignorado. Para mais informações, consulte Limites do grupo de segurança.	pl-x1j1k5ykzqlixdcy****
PortRange	string	Não	O intervalo de portas de destino para os protocolos abertos no grupo de segurança. Valores válidos: TCP ou UDP: 1 a 65535. Use uma barra (/) para separar a porta inicial e a porta final. Exemplo: 1/200. ICMP: -1/-1. GRE: -1/-1. ALL: -1/-1.	22/22
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 ao mesmo tempo.	2001:db8:1234:1a00::***
SourcePortRange	string	Não	O intervalo de portas de origem para os protocolos abertos no grupo de segurança. Valores válidos: TCP ou UDP: 1 a 65535. Use uma barra (/) para separar a porta inicial e a porta final. 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.	22/22
DestGroupOwnerAccount	string	Não	A conta do Alibaba Cloud à qual o grupo de segurança de destino pertence quando você revoga uma regra de grupo de segurança de autorização entre contas. Se as configurações para DestGroupOwnerAccount nem DestGroupOwnerId estiverem definidas, será considerado como a revogação das permissões de acesso de seus outros grupos de segurança. Se as configurações para o parâmetro DestCidrIp estiverem definidas, o parâmetro DestGroupOwnerAccount será inválido.	Test@aliyun.com
DestGroupOwnerId	string	Não	O ID da conta do Alibaba Cloud à qual o grupo de segurança de destino pertence quando você revoga uma regra de grupo de segurança de autorização entre contas. Se as configurações para DestGroupOwnerId nem DestGroupOwnerAccount estiverem definidas, será considerado como a revogação das permissões de acesso de seus outros grupos de segurança. Se você tiver definido as configurações para o parâmetro DestCidrIp, o parâmetro DestGroupOwnerId será inválido.	12345678910
NicType	string	Não	O tipo de controlador de interface de rede (NIC) da regra do grupo de segurança. Você não precisa definir as configurações para o tipo de NIC para regras de grupo de segurança em uma VPC. O valor padrão é intranet e apenas intranet é suportado. Nota O recurso de rede clássica está offline. Para obter detalhes, consulte Anúncio de desativação. O tipo de NIC para regras de grupo de segurança do tipo de rede clássica. Valores válidos: internet: NIC pública. intranet: NIC de rede interna.	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 portas. Você pode chamar a operação DescribePortRangeLists para consultar os IDs das listas de portas disponíveis. Se você especificar o parâmetro Permissions.N.PortRange, este parâmetro será ignorado. Para mais informações, consulte Limites do grupo de segurança.	prl-2ze9743****
Policy `deprecated`	string	Não	[Deprecated] Use Permissions.N.Policy para definir as configurações de permissões 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.	TCP
DestCidrIp `deprecated`	string	Não	[Deprecated] Use Permissions.N.DestCidrIp para especificar o 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 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-bp67acfmxa123b****
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.	22/22
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.	22/22
DestGroupOwnerAccount `deprecated`	string	Não	[Deprecated] Use Permissions.N.DestGroupOwnerAccount para especificar a conta do 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 do 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	InvalidIpProtocol.ValueNotSupported	The parameter IpProtocol 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	InvalidIpPortRange.Malformed	The specified parameter PortRange is not valid.	O formato do intervalo de números de porta para o protocolo IP é inválido.
400	InvalidDestCidrIp.sMalformed	The specified parameter DestCidrIp is not valid.	O parâmetro DestCidrIp especificado é inválido.
400	MissingParameter	The input parameter DestGroupId or DestCidrIp cannot be both blank.
400	InvalidPolicy.Malformed	The specified parameter %s is not valid.	O parâmetro especificado é inválido. Verifique se o parâmetro está correto.
400	InvalidNicType.ValueNotSupported	The specified parameter %s is not valid.	O tipo de rede especificado não existe. Verifique se o tipo de rede está correto.
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	InvalidDestCidrIp.Malformed	The specified parameter DestCidrIp is not valid.	O DestCidrIp especificado é inválido. Verifique se o parâmetro está correto.
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	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	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	InvalidSecurityGroupId.Malformed	The specified parameter SecurityGroupId is not valid.	O SecurityGroupId especificado é inválido.
400	InvalidPortRange.Malformed	The specified parameter PortRange must set.	O parâmetro PortRange deve ser especificado.
400	InvalidSourcePortRange.Malformed	The specified parameter SourcePortRange is not valid.	O parâmetro SourcePortRange especificado é inválido.
400	InvalidSecurityGroupDiscription.Malformed	The specified security group rule description is not valid.	A descrição do grupo de segurança especificada é inválida.
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	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	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	InvalidParam.SecurityGroupRuleId	The specified parameter SecurityGroupRuleId is not valid.	O parâmetro SecurityGroupRuleId especificado é inválido.
400	InvalidParam.SecurityGroupRuleIdRepeated	The specified parameter SecurityGroupRuleId is repeated.	Valores duplicados de SecurityGroupRuleId foram especificados.
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	InvalidSecurityGroupRule.RuleNotExist	The specified rule does not exist.	A regra de grupo de segurança especificada não existe.
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.
403	InvalidNicType.Mismatch	Specified nic type conflicts with the authorization record.
403	InvalidGroupAuthItem.NotFound	Specified group authorized item does not exist in our records.
403	InvalidSecurityGroup.IsSame	The authorized SecurityGroupId should be different from the DestGroupId.	O SecurityGroupId autorizado não pode ser igual ao DestGroupId.
403	InvalidParamter.Conflict	The specified SecurityGroupId should be different from the SourceGroupId.	Os grupos de segurança autorizador e autorizado devem ser diferentes.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Os grupos de segurança gerenciados por serviços de nuvem não podem ser modificados.
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	InvalidSecurityGroupRuleId.NotFound	The specified SecurityGroupRuleId is not exists.	O SecurityGroupRuleId 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.