Todos os produtos
Search
Central de documentação

Elastic Compute Service:ModifyNetworkInterfaceAttribute

Última atualização: Jun 26, 2026

Modifica atributos de uma interface de rede elástica (ENI), incluindo o número de filas, grupos de segurança associados, profundidade de fila, modo de comunicação e se a interface é retida na liberação da instância.

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:ModifyNetworkInterfaceAttribute

update

*NetworkInterface

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

*SecurityGroup

acs:ecs:{#regionId}:{#accountId}:securitygroup/{#securitygroupId}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região onde a interface de rede elástica (ENI) está localizada. Você pode chamar a operação DescribeRegions para consultar a lista mais recente de regiões do Alibaba Cloud.

cn-hangzhou

NetworkInterfaceName

string

Não

O ID da região onde a interface de rede elástica está localizada. Você pode chamar a operação DescribeRegions para consultar a lista mais recente de regiões do Alibaba Cloud.

eniTestName

NetworkInterfaceId

string

Sim

O nome da ENI. O nome deve ter de 2 a 128 caracteres. Deve começar com uma letra ou um caractere chinês, e não pode começar com http:// ou https://. Pode conter letras, dígitos, caracteres chineses, dois-pontos (:), underscores (_), pontos (.) e hífens (-).

Valor padrão: vazio.

eni-bp67acfmxazb4p****

QueueNumber

integer

Não

O ID da interface de rede elástica.

8

Description

string

Não

O número de filas para a ENI. Valores válidos: 1 a 2048.

  • Você pode modificar a contagem de filas para uma ENI que está no estado Available ou está anexada (InUse) a uma instância que está no estado Stopped.

  • O número de filas para a ENI não pode exceder o limite do tipo de instância para filas por ENI. O número total de filas para todas as ENIs anexadas à instância não pode exceder a cota total de filas do tipo de instância. Você pode chamar a operação DescribeInstanceTypes e verificar os valores dos parâmetros MaximumQueueNumberPerEni e TotalEniQueueQuantity para obter os limites do tipo de instância.

testDescription

SecurityGroupId

array

Não

A descrição da ENI. A descrição deve ter de 2 a 255 caracteres e não pode começar com http:// ou https://.

Valor padrão: vazio.

string

Não

The ID of a security group.

  • The number of security groups that you can specify is limited by the maximum number of security groups to which an elastic network interface can be attached. For more information, see Usage limits.

  • You can only change the security groups of secondary elastic network interfaces.

  • The secondary elastic network interface is then associated with the specified security groups and detached from its original security groups.

  • The changes take effect after a short delay.

sg-bp67acfmxazb4p****

DeleteOnRelease

boolean

Não

Os IDs de um ou mais grupos de segurança. Os grupos de segurança especificados substituem os atuais associados à interface de rede secundária.

  • O número de grupos de segurança que você pode especificar está sujeito a uma cota. Para mais informações, consulte Limites.

  • A alteração entra em vigor quase imediatamente, mas você pode experimentar um breve atraso.

true

RxQueueSize

integer

Não

Especifica se a ENI deve ser liberada quando a instância à qual está anexada for liberada. Valores válidos:

  • true: A ENI é liberada.

  • false: A ENI é retida.

8192

TxQueueSize

integer

Não

A profundidade da fila de recebimento (Rx) da ENI.

Nota

Este parâmetro está em preview privado. Para solicitar acesso, envie um ticket.

  • Este parâmetro se aplica apenas a tipos de instância ECS de 7ª geração e posteriores.

  • Este parâmetro se aplica apenas a imagens Linux.

  • Uma maior profundidade de fila Rx pode melhorar a taxa de transferência de entrada e reduzir a perda de pacotes, mas consome mais memória.

8192

NetworkInterfaceTrafficConfig

object

Não

A profundidade da fila de transmissão (Tx) da ENI.

Nota

Este parâmetro está em preview privado. Para solicitar acesso, envie um ticket.

  • Este parâmetro se aplica apenas a tipos de instância ECS de 7ª geração e posteriores.

  • Este parâmetro se aplica apenas a imagens Linux.

  • Uma maior profundidade de fila Tx pode melhorar a taxa de transferência de saída e reduzir a perda de pacotes, mas consome mais memória.

NetworkInterfaceTrafficMode

string

Não

The traffic mode of the elastic network interface. Valid values:

  • Standard: The standard TCP traffic mode.

  • HighPerformance: The RDMA traffic mode with the Elastic RDMA Interface (ERI) feature enabled.

If the elastic network interface is attached to an instance, note the following:

Nota

This parameter is available by invitation only.

HighPerformance

QueueNumber

integer

Não

The number of queues for the elastic network interface. If the elastic network interface is attached to an instance, note the following:

Nota

This parameter is available by invitation only. To use this feature, submit a ticket.

8

QueuePairNumber

integer

Não

The number of queue pairs for the ERI. If the elastic network interface is attached to an instance, note the following:

Nota

This parameter is available by invitation only. To use this feature, submit a ticket.

8

RxQueueSize

integer

Não

The queue depth for inbound traffic on the elastic network interface.

Nota

This parameter is available by invitation only. To use this feature, submit a ticket.

Note the following:

  • This parameter is available only for instance types of the 7th generation and later.

  • This parameter is available only for instances that use Linux images.

  • A larger queue depth for inbound traffic increases throughput and reduces the packet loss rate, but consumes more memory.

8192

TxQueueSize

integer

Não

The queue depth for outbound traffic on the elastic network interface.

Nota

This parameter is available by invitation only. To use this feature, submit a ticket.

Note the following:

  • This parameter is available only for instance types of the 7th generation and later.

  • This parameter is available only for instances that use Linux images.

  • A larger queue depth for outbound traffic increases throughput and reduces the packet loss rate, but consumes more memory.

8192

ConnectionTrackingConfiguration

object

Não

Os parâmetros de comunicação da ENI.

TcpEstablishedTimeout

integer

Não

The timeout period for TCP connections in the ESTABLISHED state, in seconds. Valid values: 30, 60, 80, 100, 200, 300, 500, 700, and 910.

Default value: 910.

910

TcpClosedAndTimeWaitTimeout

integer

Não

The timeout period, in seconds, for TCP connections in the TIME_WAIT or CLOSE_WAIT state. The value must be an integer from 3 to 15.

Default value: 3.

Nota

If your ECS instance is used with Network Load Balancer (NLB) or Classic Load Balancer (CLB), the default timeout period for connections in the TIME_WAIT state is 15 seconds.

3

UdpTimeout

integer

Não

The timeout period for UDP flows, in seconds. Valid values: 10, 20, 30, 60, 80, and 100.

Default value: 30.

Nota

If your ECS instance is used with Network Load Balancer (NLB) or Classic Load Balancer (CLB), the default value is 100 seconds.

30

NetworkInterfaceTrafficMode

Não

O modo de comunicação da ENI. Valores válidos:

  • Standard: usa o modo de comunicação TCP.

  • HighPerformance: ativa o recurso Elastic RDMA Interface (ERI) e usa o modo de comunicação RDMA.

Quando a ENI está no estado InUse:

  • O número total de ENIs com ERI habilitado em uma instância não pode exceder a cota de ERI do tipo de instância. Você pode chamar a operação DescribeInstanceTypes e verificar o valor do parâmetro EriQuantity para obter a cota.

Nota

Este parâmetro está em preview privado.

QueueNumber

Não

O número de filas para a ENI. Quando a ENI está no estado InUse, observe o seguinte:

  • O número de filas não pode exceder o número máximo de filas por ENI suportado pelo tipo de instância.

  • O número total de filas para todas as ENIs anexadas à instância não pode exceder a cota total de filas do tipo de instância. Você pode chamar a operação DescribeInstanceTypes e verificar os valores dos parâmetros MaximumQueueNumberPerEni e TotalEniQueueQuantity para obter os limites do tipo de instância.

Nota

Este parâmetro está em preview privado.

QueuePairNumber

Não

O número de filas para a ENI habilitada para RDMA. Quando a ENI está no estado InUse, observe o seguinte:

  • O número de filas não pode exceder o número máximo de filas para uma única ENI habilitada para RDMA suportado pelo tipo de instância. Você pode chamar a operação DescribeInstanceTypes e verificar o valor do parâmetro QueuePairNumber para obter o limite.

Nota

Este parâmetro está em preview privado.

TxQueueSize

Não

A profundidade da fila de transmissão (Tx) da ENI.

Nota

Este parâmetro está em preview privado. Para solicitar acesso, envie um ticket.

  • Este parâmetro se aplica apenas a tipos de instância ECS de 7ª geração e posteriores.

  • Este parâmetro se aplica apenas a imagens Linux.

  • Uma maior profundidade de fila Tx pode melhorar a taxa de transferência de saída e reduzir a perda de pacotes, mas consome mais memória.

RxQueueSize

Não

A profundidade da fila de recebimento (Rx) da ENI.

Nota

Este parâmetro está em preview privado. Para solicitar acesso, envie um ticket.

  • Este parâmetro se aplica apenas a tipos de instância ECS de 7ª geração e posteriores.

  • Este parâmetro se aplica apenas a imagens Linux.

  • Uma maior profundidade de fila Rx pode melhorar a taxa de transferência de entrada e reduzir a perda de pacotes, mas consome mais memória.

EnhancedNetwork

object

Não

A configuração de rastreamento de conexão.

Para mais informações, consulte Gerenciamento de timeout de conexão.

EnableSriov

boolean

Não

This parameter is not publicly available.

true

EnableRss

boolean

Não

Nota

This parameter is not publicly available.

false

VirtualFunctionTotalQueueNumber

integer

Não

VirtualFunctionQuantity

integer

Não

TcpClosedAndTimeWaitTimeout

Não

O período de timeout, em segundos, para conexões TCP nos estados FIN-WAIT-2 e TIME-WAIT. O valor deve ser um inteiro de 3 a 15.

Valor padrão: 3.

Nota

Quando a instância ECS está atrás de uma instância Network Load Balancer (NLB) ou Classic Load Balancer (CLB), o timeout padrão para conexões no estado TIME_WAIT é de 15 segundos.

UdpTimeout

Não

O período de timeout para fluxos UDP, em segundos. Valores válidos: 10, 20, 30, 60, 80 e 100.

Valor padrão: 30.

Nota

Quando a instância ECS está atrás de uma instância NLB ou CLB, o valor padrão é 100 segundos.

TcpEstablishedTimeout

Não

O período de timeout para conexões TCP no estado ESTABLISHED, em segundos. Valores válidos: 30, 60, 80, 100, 200, 300, 500, 700 e 910.

Valor padrão: 910.

SourceDestCheck

boolean

Não

Este parâmetro não está disponível publicamente.

false

Não

Especifica se a verificação de origem/destino deve ser ativada. Ativar este recurso melhora a segurança da rede. Valores válidos:

  • true: Ativa a verificação de origem/destino.

  • false: Desativa a verificação de origem/destino.

Valor padrão: false.

Nota

Este recurso está disponível apenas em regiões específicas. Para mais informações, consulte Verificação de origem/destino.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os dados retornados para a solicitação.

RequestId

string

Um identificador exclusivo para a 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 InvalidOperation.NotSupportModifyQueueNumber %s
400 MissingParameter %s
400 UnsupportedParameter %s
400 InvalidParameter %s
400 InvalidInstanceID.Malformed %s
400 InvalidOperation.InvalidEcsState %s
400 InvalidOperation.InvalidEniState %s
400 InvalidOperation.DetachPrimaryEniNotAllowed %s
400 InvalidParams.EniId %s
400 Forbidden.RegionId %s
400 JoinedGroupLimitExceed %s
400 InvalidEniQueueSize.RegionOrUserNotSupported The specified parameter RxQueueSize or TxQueueSize is not supported in this region, or this account is not in the whitelist of using eni QueueSize.
400 InvalidParameter.EniQueueSize The specified parameter TxQueueSize and RxQueueSize are not equal or exceed limit.
400 InvalidParameter.Conflict %s
400 InvalidConnectionTrackingConfiguration.RegionOrUserNotSupported The specified parameter ConnectionTrackingConfiguration is not supported in this region, or this account is not in the whitelist of using network interface ConnectionTrackingConfiguration.
400 InvalidParameter.InvalidQueuePairNumber The specified parameter QueuePairNumber exceeds limit.
400 InvalidParameter.EniConnectionTrackingConfiguration The specify network interface connection tracking configuration exceeds limit.
400 InvalidOperation.MaxEniQueuePairNumberExceed The QueuePairNumber on the RDMA ENI exceeds the upper limit allowed for a single ENI.
400 InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded The number of RDMA ENIs attached to the ECS instance exceeds the upper limit.
400 InvalidOperation.InstanceTypeNotSupportHighPerformance The ECS instance type where the ENI is located does not support the RDMA mode.
400 InvalidTrafficMode.ModifyToStandardNotSupported The specified parameter NetworkInterfaceTrafficMode is not supported to modify to Standard.
400 InvalidOperation.EniTrafficModeNotSupportIPv6 The ENI using High Performance traffic mode does not support IPv6.
400 InvalidOperation.EniQueuePairNumberOverflow The RDMA QueuePairNumber of the ECS instance associated with the specified ENI exceeds the limit.
400 InvalidParameter.QueuePairNumberMustEmpty When the traffic mode is set to Standard, the QueuePairNumber must be empty.
400 InvalidParameter.EniTrafficMode The ENI traffic mode is set incorrectly, it must be either Standard or HighPerformance.
400 InvalidOperation.InstanceTypeNotSupportRss The ECS instance type does not support Rss.
400 InvalidParameter.EniEnhancedNetwork The input parameter "EnhancedNetwork" is illegal, when EnableSriov is true, VirtualFunctionTotalQueueNumber must not be empty, and VirtualFunctionQuantity must be 1 to 256. When EnableSriov is empty or false, VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity must be empty.
400 InvalidOperation.NotSupportModifyVFQueueNumberAndVFQuantity The ENI not support modify VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity when EnableSriov is true.
400 InvalidOperation.TrunkAttachmentMustEmpty The Attachment of the current Trunk type Network Interface must be empty when modify EnableSriov to true.
400 Throttling Request was denied due to request throttling, try again later.
400 InvalidOperation.SourceDestCheckUnsupported Modifying sourceDestCheck attribute for network interface is not allowed in the %s region.
500 InternalError The request processing has failed due to some unknown error, exception or failure.
403 InvalidUserType.NotSupported %s
403 Abs.InvalidAccount.NotFound %s
403 Forbidden.NotSupportRAM %s
403 Forbidden.SubUser %s
403 MaxEniCountExceeded %s
403 EniPerInstanceLimitExceeded %s
403 InvalidOperation.AvailabilityZoneMismatch %s
403 InvalidOperation.VpcMismatch %s
403 SecurityGroupInstanceLimitExceed %s
403 InvalidSecurityGroupId.NotVpc %s
403 InvalidOperation.InvalidEniType %s
403 InvalidOperation.EniServiceManaged %s
403 InvalidOperation.MultiGroupType The specified instance can't join different types of security group.
403 InvalidOperation.EniCountExceeded The maximum number of eni in a enterprise level security group is exceeded.
403 InvalidParams.NetworkInterfaceName %s
403 InvalidOperation.ModifyPrimaryEniQueueNumber Primary NetworkInterface is not allowed to modify queue number.
403 InvalidOperation.InvalidEniState Available status or ECS instance attached is Stopped is allowed to modify network interface queue number.
403 InvalidOperation.ResourceManagedByCloudProduct %s
403 InvalidParameter.InvalidEniQueueNumber %s
403 InvalidOperation.MaxEniQueueNumberExceeded %s
403 InvalidOperation.ExceedInstanceTypeQueueNumber %s
403 AclLimitExceed %s
403 InvalidOperation.EniTypeUnsupported The specified eni type does not supported.
404 InvalidEcsId.NotFound %s
404 InvalidEniId.NotFound %s
404 InvalidVSwitchId.NotFound %s
404 InvalidSecurityGroupId.NotFound %s
404 InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc Primary NetworkInterface is only allowed to modify name and description.
404 InvalidParameter.SecurityGroupIdRepeated The specified security group ids has repeated.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.