Todos os produtos
Search
Central de documentação

Elastic Compute Service:LeaveSecurityGroup

Última atualização: Oct 16, 2026

Remove uma instância ECS ou uma Elastic Network Interface (ENI) de um grupo de segurança especificado.

Descrição da operação

Nota

Esta operação de API foi descontinuada. Chame ModifyInstanceAttribute para adicionar ou remover uma instância ECS de um grupo de segurança, ou chame ModifyNetworkInterfaceAttribute para adicionar ou remover uma Elastic Network Interface (ENI) de um grupo de segurança.

Importante O Alibaba Cloud ajustou as regras de validação para esta operação de API em 8 de julho de 2024. Ao remover uma instância ou controlador de interface de rede (NIC) que não está no grupo de segurança, a operação de API retorna o código de erro "InvalidSecurityGroupAssociation.NotFound" em vez de uma resposta de sucesso. Certifique-se de que sua aplicação seja compatível com este código de erro para evitar interrupções de serviço.
  • Você não pode remover uma instância e uma Elastic Network Interface (ENI) de um grupo de segurança ao mesmo tempo. Especificamente, você não pode especificar os parâmetros InstanceId e NetworkInterfaceId simultaneamente.

  • Antes de remover uma instância de um grupo de segurança, a instância deve estar no estado Stopped ou Running.

  • Uma instância ou Elastic Network Interface (ENI) deve ser adicionada a pelo menos um grupo de segurança. Se a instância ou Elastic Network Interface (ENI) estiver adicionada a apenas um grupo de segurança, a solicitação de remoção falhará e retornará um erro.

  • Se você remover uma instância ou controlador de interface de rede (NIC) que não está no grupo de segurança, a solicitação de remoção falhará e retornará um erro.

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

SecurityGroupId

string

Sim

O ID do grupo de segurança.

sg-bp67acfmxazb4p****

InstanceId

string

Não

O ID da instância.

Nota

Se você especificar este parâmetro, deverá deixar NetworkInterfaceId vazio.

i-bp67acfmxazb4p****

NetworkInterfaceId

string

Não

O ID do controlador de interface de rede (NIC).

Nota

Se você especificar este parâmetro, deverá deixar InstanceId vazio.

eni-bp13kd656hxambfe****

RegionId

string

Não

O ID da região. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.

  • Você não precisa especificar o ID da região ao remover uma instância de um grupo de segurança.

  • Você deve especificar o ID da região do controlador de interface de rede (NIC) ao remover um controlador de interface de rede (NIC) de um grupo de segurança.

cn-hangzhou

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidInstanceId.Malformed The specified parameter "InstanceId" is not valid.
400 MissingParameter.RegionId The specified RegionId should not be null. O parâmetro RegionId não deve estar vazio.
400 InvalidOperation.InvalidEniState %s O status atual da ENI não oferece suporte a esta operação.
400 InvalidSecurityGroupAssociation.NotFound %s. A instância ou ENI atual não está no grupo de segurança.
403 InstanceLastSecurityGroup The specified security group is the last security group for the instance. O grupo de segurança é o único grupo de segurança associado à instância.
403 IncorrectInstanceStatus The current status of the resource does not support this operation.
403 InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons. A instância à qual o disco está anexado está bloqueada por motivos de segurança.
403 InstanceNotInSecurityGroup The instance not in the group.
403 InvalidOperation.ResourceManagedByCloudProduct %s Os grupos de segurança gerenciados por serviços de nuvem não podem ser modificados.
403 InvalidOperation.AtLeastInOneGroup %s O recurso especificado deve ser adicionado a pelo menos um grupo de segurança. Se o recurso especificado estiver adicionado a apenas um grupo de segurança, a chamada falha e este código de erro é retornado.
403 InvalidOperation.EniServiceManaged %s A operação é inválida.
403 InvalidOperation.InvalidEniType %s Esta operação não é permitida para o tipo de interface de rede atual.
403 InvalidParam.Malformed %s O parâmetro especificado é inválido.
403 InvalidParam.EniIdAndInstanceId.Conflict %s Os parâmetros InstanceId e NetworkInterfaceId entram em conflito entre si. Você não pode especificar ambos os parâmetros ao mesmo tempo.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. A instância especificada não existe. Verifique se o ID da instância está correto.
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 InvalidEniId.NotFound %s
404 InvalidVSwitchId.NotFound The specified virtual switch %s does not exist. O ID do vSwitch especificado não existe.
504 RequestTimeout The request encounters an upstream server timeout.
409 InvalidOperation.Conflict Request was denied due to conflict with a previous request, please try again later. Esta operação não é permitida devido a um conflito de tarefas.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.