Todos os produtos
Search
Central de documentação

Elastic Compute Service:UnassignIpv6Addresses

Última atualização: Sep 04, 2026

Revoga um ou mais endereços IPv6 de uma interface de rede (NIC).

Descrição da operação

Descrição da operação

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

  • A interface de rede (NIC) deve estar no estado ativo (Available) ou InUse.

  • Se você estiver operando em uma interface de rede (NIC) primária, a instância ECS à qual a NIC está anexada deve estar no estado Running ou Stopped.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:UnassignIpv6Addresses

delete

*NetworkInterface.

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região da interface de rede (NIC). Você pode invocar DescribeRegions para consultar a lista de regiões mais recente.

cn-hangzhou

NetworkInterfaceId

string

Sim

O ID da interface de rede (NIC).

eni-bp14v2sdd3v8ht****

Ipv6Address

array

Não

Um ou mais endereços IPv6 a serem excluídos. Valores válidos de N: 1 a 10.

2001:db8:1234:1a00::***

string

Não

Um ou mais endereços IPv6 a serem excluídos. Valores válidos de N: 1 a 10.

Nota
  • Ao chamar esta operação, você deve especificar o parâmetro Ipv6Address ou o parâmetro Ipv6Prefix. Caso contrário, um erro será retornado.

2001:db8:1234:1a00::***

Ipv6Prefix

array

Não

Um ou mais prefixos IPv6 a serem revogados. Valores válidos de N: 1 a 10.

string

Não

Um ou mais prefixos IPv6 a serem revogados. Valores válidos de N: 1 a 10.

Nota
  • Ao chamar esta operação, você deve especificar o parâmetro Ipv6Address ou o parâmetro Ipv6Prefix. Caso contrário, um erro será retornado.

2001:db8:1234:1a00:****::/80

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 UnsupportedParameter %s O parâmetro especificado não é suportado. Verifique se o parâmetro está correto.
400 InvalidParameter %s Os parâmetros da solicitação atual são inválidos. Tente novamente.
400 InvalidInstanceID.Malformed %s
400 MissingParameter %s Um parâmetro obrigatório está ausente.
400 InvalidOperation.InvalidEcsState %s Esta operação não é permitida no status atual do serviço de nuvem.
400 InvalidOperation.InvalidEniState %s O estado atual da ENI não permite esta operação.
400 InvalidEniId.Malformed The specified parameter "EniId" is not valid.
400 InvalidParameter.Conflict %s Os parâmetros estão em conflito.
500 InvalidOperation.RegionNotSupportIpPrefix The current region does not support ip prefix. A região não oferece suporte à atribuição de prefixo de IP.
403 InvalidUserType.NotSupported %s O tipo de usuário é inválido.
403 Abs.InvalidAccount.NotFound %s A conta não foi encontrada ou a AccessKey expirou.
403 MissingParameter %s
403 Forbedden.NotSupportRAM %s Esta operação não é suportada no modo RAM.
403 Forbbiden.SubUser %s O usuário RAM não está autorizado a realizar esta operação.
403 InvalidOperation.InvalidEniType %s Esta operação não é permitida para o tipo de interface de rede atual.
403 InvalidIp.IpUnassigned %s O endereço IP especificado não está atribuído.
403 InvalidIp.IpRepeated %s O endereço IP especificado está duplicado.
403 InvalidIp.Address %s O endereço IP especificado é inválido.
403 Forbidden.RegionId %s
403 InvalidOperation.EniServiceManaged %s A operação é inválida.
403 InvalidIp.IpPrefixIllegal The ip prefixes %s is/are illegal. O prefixo de IP é inválido. Não está no formato CIDR.
403 InvalidIp.IpPrefixMaskInvalid The ip prefixes mask %s is illegal which must be between %s and %s. A máscara de prefixo de IP é inválida e não está dentro do intervalo válido.
403 InvalidIp.IpPrefixMaskNotSame The ip prefixes %s are illegal which mask must be same. As máscaras de prefixo de IP não são iguais.
403 InvalidIp.IpPrefixNotStrict The ip prefix must be strict cidr format. O prefixo de IP é inválido porque não é um bloco CIDR estrito.
404 InvalidEniId.NotFound %s

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.