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

Modifica os atributos de uma Elastic Network Interface (ENI), como o número de filas, os grupos de segurança associados, a profundidade da fila, o modo de tráfego e se a ENI deve ser retida quando a instância for liberada.

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 controlador de interface de rede (NIC). Você pode invocar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
NetworkInterfaceName	string	Não	O nome da Elastic Network Interface (ENI). O nome deve ter de 2 a 128 caracteres e deve começar com uma letra ou um caractere chinês. Não pode começar com `http://` ou `https://`. Suporta caracteres da categoria Letter do Unicode, como letras do alfabeto inglês, caracteres chineses e dígitos. Pode conter dois-pontos (:), sublinhados (_), pontos (.) e hifens (-). Valor padrão: vazio.	eniTestName
NetworkInterfaceId	string	Sim	O ID do controlador de interface de rede (NIC).	eni-bp67acfmxazb4p****
QueueNumber	integer	Não	O número de filas para a ENI. Valores válidos: 1 a 2048. Você pode modificar o número de filas de uma ENI que esteja no estado `Available` ou de uma ENI que esteja anexada (`InUse`) a uma instância que esteja no estado `Stopped`. O número de filas da ENI não pode exceder o número máximo de filas por ENI permitido pelo tipo de instância. O número total de filas de todas as ENIs anexadas à instância não pode exceder a cota total de filas permitida pelo tipo de instância. Você pode chamar a operação DescribeInstanceTypes e consultar os parâmetros `MaximumQueueNumberPerEni` e `TotalEniQueueQuantity` para obter o número máximo de filas por ENI e a cota total de filas para o tipo de instância.	8
Description	string	Não	A descrição do controlador de interface de rede (NIC). A descrição deve ter de 2 a 255 caracteres e não pode começar com `http://` ou `https://`. Valor padrão: vazio.	testDescription
SecurityGroupId	array	Não	A lista de IDs de grupos de segurança. O controlador de interface de rede (NIC) secundário é adicionado aos grupos de segurança especificados e removido de seus grupos de segurança atuais. Os valores válidos de N dependem da cota de grupos de segurança aos quais cada controlador de interface de rede (NIC) pode ingressar. Para obter mais informações, consulte Limites. A modificação entra em vigor em pouco tempo, mas pode haver um pequeno atraso.
	string	Não	A lista de IDs de grupos de segurança. Os valores válidos de N dependem da cota de grupos de segurança aos quais cada controlador de interface de rede (NIC) pode ingressar. Para obter mais informações, consulte Limites. Você só pode modificar os grupos de segurança de ENIs secundárias. Após a aplicação das configurações do grupo de segurança, o controlador de interface de rede (NIC) secundário é adicionado aos grupos de segurança especificados e removido de seus grupos de segurança atuais. A modificação entra em vigor em pouco tempo, mas pode haver um pequeno atraso.	sg-bp67acfmxazb4p****
DeleteOnRelease	boolean	Não	Especifica se a ENI deve ser retida quando a instância for liberada. Valores válidos: true: A ENI não é retida. false: A ENI é retida.	true
RxQueueSize	integer	Não	A profundidade da fila de entrada do controlador de interface de rede (NIC). Nota Este parâmetro está em pré-visualização por convite e não está disponível para uso público. Se você precisar usá-lo, envie um ticket para solicitar acesso à lista de permissões. Observe os seguintes itens: Este parâmetro se aplica apenas a tipos de instância ECS de sétima geração e posteriores. Atualmente, este parâmetro se aplica apenas a imagens Linux. Uma maior profundidade de fila de entrada pode aumentar a taxa de transferência de entrada e reduzir a taxa de perda de pacotes, mas consome mais memória.	8192
TxQueueSize	integer	Não	A profundidade da fila de saída do controlador de interface de rede (NIC). Nota Este parâmetro está em pré-visualização por convite e não está disponível para uso público. Se você precisar usá-lo, envie um ticket para solicitar acesso à lista de permissões. Observe os seguintes itens: Este parâmetro se aplica apenas a tipos de instância ECS de sétima geração e posteriores. Atualmente, este parâmetro se aplica apenas a imagens Linux. Uma maior profundidade de fila de saída pode aumentar a taxa de transferência de saída e reduzir a taxa de perda de pacotes, mas consome mais memória.	8192
NetworkInterfaceTrafficConfig	object	Não	Os parâmetros de tráfego do controlador de interface de rede (NIC).
NetworkInterfaceTrafficMode	string	Não	O padrão de tráfego do controlador de interface de rede (NIC). Valores válidos do parâmetro: Standard: usa o padrão de tráfego TCP. HighPerformance: ativa a Elastic RDMA Interface (ERI) e usa o padrão de tráfego RDMA. Quando a Elastic Network Interface (ENI) está anexada a uma instância, observe os seguintes itens: O número total de controladores de interface de rede (NICs) RDMA para a instância não pode exceder a cota de controladores de interface de rede (NIC) RDMA permitida pelo tipo de instância. Você pode invocar a operação DescribeInstanceTypes e consultar o parâmetro EriQuantity para obter a cota de controladores de interface de rede (NIC) RDMA para o tipo de instância. Nota Este parâmetro está em pré-visualização por convite e não está disponível para uso público.	HighPerformance
QueueNumber	integer	Não	O número de filas para o controlador de interface de rede (NIC). Quando a Elastic Network Interface (ENI) está anexada a uma instância, observe os seguintes itens: O número de filas não pode exceder o número máximo de filas por controlador de interface de rede (NIC) permitido pelo tipo de instância. O número total de filas de todos os controladores de interface de rede (NICs) anexados à instância não pode exceder a cota total de filas permitida pelo tipo de instância. Você pode invocar a operação DescribeInstanceTypes e consultar os parâmetros MaximumQueueNumberPerEni e TotalEniQueueQuantity para obter o número máximo de filas por controlador de interface de rede (NIC) e a cota total de filas para o tipo de instância. Nota Este parâmetro está em pré-visualização por convite e não está disponível para uso público.	8
QueuePairNumber	integer	Não	O número de filas para o controlador de interface de rede (NIC) RDMA. Quando a Elastic Network Interface (ENI) está anexada a uma instância, observe os seguintes itens: O número de filas não pode exceder o número máximo de filas por controlador de interface de rede (NIC) RDMA permitido pelo tipo de instância. Você pode invocar a operação DescribeInstanceTypes e consultar o parâmetro QueuePairNumber para obter o número máximo de filas por controlador de interface de rede (NIC) RDMA para o tipo de instância. Nota Este parâmetro está em pré-visualização por convite e não está disponível para uso público.	8
RxQueueSize	integer	Não	A profundidade da fila de entrada do controlador de interface de rede (NIC). Nota Este parâmetro está em pré-visualização por convite e não está disponível para uso público. Se você precisar usá-lo, envie um ticket para solicitar acesso à lista de permissões. Observe os seguintes itens: Este parâmetro se aplica apenas a tipos de instância ECS de sétima geração e posteriores. Atualmente, este parâmetro se aplica apenas a imagens Linux. Uma maior profundidade de fila de entrada pode aumentar a taxa de transferência de entrada e reduzir a taxa de perda de pacotes, mas consome mais memória.	8192
TxQueueSize	integer	Não	A profundidade da fila de saída do controlador de interface de rede (NIC). Nota Este parâmetro está em pré-visualização por convite e não está disponível para uso público. Se você precisar usá-lo, envie um ticket para solicitar acesso à lista de permissões. Observe os seguintes itens: Este parâmetro se aplica apenas a tipos de instância ECS de sétima geração e posteriores. Atualmente, este parâmetro se aplica apenas a imagens Linux. Uma maior profundidade de fila de saída pode aumentar a taxa de transferência de saída e reduzir a taxa de perda de pacotes, mas consome mais memória.	8192
ConnectionTrackingConfiguration	object	Não	A coleção de informações de configuração de rastreamento de conectividade de rede. Antes de usar este parâmetro, leia atentamente o Gerenciamento de tempo limite de conexão.
TcpEstablishedTimeout	integer	Não	O período de tempo limite para conexões TCP estabelecidas. Unidade: segundos. Valores válidos: 30, 60, 80, 100, 200, 300, 500, 700 e 910. Valor padrão: 910.	910
TcpClosedAndTimeWaitTimeout	integer	Não	O período de tempo limite para conexões TCP fechadas e em estado TIME_WAIT. Unidade: segundos. Valores válidos: números inteiros de 3 a 15. Valor padrão: 3. Nota Se a sua instância ECS for usada junto com uma instância NLB ou CLB, o período de tempo limite padrão para conexões no estado `TIME_WAIT` é de 15 segundos.	3
UdpTimeout	integer	Não	O período de tempo limite para fluxos UDP. Unidade: segundos. Valores válidos: 10, 20, 30, 60, 80 e 100. Valor padrão: 30. Nota Se a sua instância ECS for usada junto com uma instância NLB ou CLB, o valor padrão é de 100 segundos.	30
EnhancedNetwork	object	Não	Este parâmetro não está disponível para uso público.
EnableSriov	boolean	Não	Este parâmetro não está disponível para uso público.	true
EnableRss	boolean	Não	Nota Este parâmetro não está disponível para uso público.	false
VirtualFunctionTotalQueueNumber	integer	Não	O número total de filas para funções virtuais quando o SR-IOV está ativado.	4
VirtualFunctionQuantity	integer	Não	O número de funções virtuais quando o SR-IOV está ativado. Valores válidos: 1 a 256.	1
EnableExpress	boolean	Não	Nota Este parâmetro não está disponível para uso público.
SourceDestCheck	boolean	Não	Especifica se a verificação de origem/destino deve ser ativada. Recomendamos que você ative esse recurso para melhorar a segurança da rede. Valores válidos: true: ativado. false: desativado. Valor padrão: false. Nota Este recurso é suportado apenas em regiões específicas. Antes de usá-lo, leia atentamente a Verificação de origem/destino.	false
EnablePrimaryIPv6	boolean	Não	Especifica se o endereço IPv6 primário do controlador de interface de rede (NIC) deve ser ativado.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O ID da solicitação.
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	InvalidOperation.NotSupportModifyQueueNumber	%s
400	MissingParameter	%s	Um parâmetro obrigatório está ausente.
400	UnsupportedParameter	%s	O parâmetro não é suportado. Verifique se o parâmetro está correto.
400	InvalidParameter	%s	Os parâmetros da solicitação são inválidos. Tente novamente.
400	InvalidInstanceID.Malformed	%s
400	InvalidOperation.InvalidEcsState	%s	Esta operação não é permitida devido ao status atual do serviço de nuvem.
400	InvalidOperation.InvalidEniState	%s	O estado atual da ENI não permite esta operação.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Você não pode desvincular a ENI primária da instância.
400	InvalidParams.EniId	%s	O parâmetro EniId especificado é inválido.
400	Forbidden.RegionId	%s	O serviço não está disponível na região atual.
400	JoinedGroupLimitExceed	%s	O número de grupos de segurança aos quais o recurso especificado pode ingressar atingiu o limite superior. Para mais informações, consulte o valor real do placeholder %s na mensagem de erro.
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.	A definição da profundidade da fila da ENI não é suportada para a região ou usuário.
400	InvalidParameter.EniQueueSize	The specified parameter TxQueueSize and RxQueueSize are not equal or exceed limit.	As profundidades das filas de entrada e saída da interface de rede não são iguais ou excedem o intervalo permitido.
400	InvalidParameter.Conflict	%s	Os parâmetros especificados estão em conflito entre si.
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.	A definição de configurações de conexão ENI não é suportada na região atual ou para o usuário atual.
400	InvalidParameter.InvalidQueuePairNumber	The specified parameter QueuePairNumber exceeds limit.	O número especificado de filas de NIC RDMA excede o limite.
400	InvalidParameter.EniConnectionTrackingConfiguration	The specify network interface connection tracking configuration exceeds limit.	A configuração de conectividade de rede especificada para a controladora de interface de rede (NIC) está fora do intervalo permitido.
400	InvalidOperation.MaxEniQueuePairNumberExceed	The QueuePairNumber on the RDMA ENI exceeds the upper limit allowed for a single ENI.	O número de filas RDMA para o controlador de interface de rede elástica (NIC) excede o máximo permitido por controlador de interface de rede elástica (NIC).
400	InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded	The number of RDMA ENIs attached to the ECS instance exceeds the upper limit.	O número de controladores de interface de rede (NIC) RDMA anexados à instância ECS à qual o controlador de interface de rede elástica (NIC) está anexado excede o limite superior.
400	InvalidOperation.InstanceTypeNotSupportHighPerformance	The ECS instance type where the ENI is located does not support the RDMA mode.	O tipo de instância ECS ao qual o controlador de interface de rede elástica (NIC) está anexado não suporta o modo de comunicação RDMA.
400	InvalidTrafficMode.ModifyToStandardNotSupported	The specified parameter NetworkInterfaceTrafficMode is not supported to modify to Standard.	A alteração do modo de comunicação de um controlador de interface de rede elástica (NIC) para Standard não é suportada.
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.	O número de filas do controlador de interface de rede (NIC) RDMA na instância ECS à qual o controlador de interface de rede elástica (NIC) especificado está anexado excede o limite.
400	InvalidParameter.QueuePairNumberMustEmpty	When the traffic mode is set to Standard, the QueuePairNumber must be empty.	Ao criar uma Elastic Network Interface (ENI) no modo de comunicação TCP, o número de filas do modo RDMA para a ENI deve estar vazio.
400	InvalidParameter.EniTrafficMode	The ENI traffic mode is set incorrectly, it must be either Standard or HighPerformance.	O modo de comunicação da Elastic Network Interface (ENI) é inválido. Valores válidos: Standard e HighPerformance.
400	InvalidOperation.InstanceTypeNotSupportRss	The ECS instance type does not support Rss.	O tipo de instância da instância especificada não oferece suporte à ativação do 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.	Os parâmetros de aprimoramento de rede especificados são inválidos. Quando EnableSriov é definido como true, VirtualFunctionTotalQueueNumber não deve estar vazio e VirtualFunctionQuantity deve variar de 1 a 256. Quando EnableSriov está vazio ou definido como false, VirtualFunctionTotalQueueNumber e VirtualFunctionQuantity devem estar vazios.
400	InvalidOperation.NotSupportModifyVFQueueNumberAndVFQuantity	The ENI not support modify VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity when EnableSriov is true.	Quando EnableSriov é definido como true, VirtualFunctionTotalQueueNumber e VirtualFunctionQuantity não podem ser modificados.
400	InvalidOperation.TrunkAttachmentMustEmpty	The Attachment of the current Trunk type Network Interface must be empty when modify EnableSriov to true.	Quando EnableSriov é definido como true, o dispositivo anexado à ENI tronco deve estar vazio.
400	Throttling	Request was denied due to request throttling, try again later.	A solicitação foi limitada.
400	InvalidOperation.SourceDestCheckUnsupported	Modifying sourceDestCheck attribute for network interface is not allowed in the %s region.	A região atual não suporta a modificação da propriedade SourceDestCheck de uma Elastic Network Interface (ENI).
400	InvalidOperation.EnablePrimaryIPv6	The specified ENI can not enable primary IPv6 or already has primary IPv6.	A ENI especificada não pode receber um endereço IPv6 primário ou já possui um.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente mais tarde.
403	InvalidUserType.NotSupported	%s	O tipo de usuário é inválido.
403	Abs.InvalidAccount.NotFound	%s	A conta não foi encontrada ou o AccessKey expirou.
403	Forbidden.NotSupportRAM	%s	Os usuários do Resource Access Management (RAM) não podem executar esta operação.
403	Forbidden.SubUser	%s	Seu usuário RAM atual não tem permissões para realizar operações neste recurso.
403	MaxEniCountExceeded	%s	O número máximo de ENIs foi excedido.
403	EniPerInstanceLimitExceeded	%s	O número de interfaces de rede elásticas para o tipo de instância excedeu o limite superior.
403	InvalidOperation.AvailabilityZoneMismatch	%s	Esta operação não é permitida devido a uma incompatibilidade de zona.
403	InvalidOperation.VpcMismatch	%s	Esta operação não é permitida.
403	SecurityGroupInstanceLimitExceed	%s	O número máximo de instâncias no grupo de segurança foi atingido.
403	InvalidSecurityGroupId.NotVpc	%s	O grupo de segurança é inválido.
403	InvalidOperation.InvalidEniType	%s	Esta operação não é permitida para o tipo de interface de rede atual.
403	InvalidOperation.EniServiceManaged	%s	A operação é inválida.
403	InvalidOperation.MultiGroupType	The specified instance can't join different types of security group.	A instância especificada não pode ser adicionada a grupos de segurança de tipos diferentes.
403	InvalidOperation.EniCountExceeded	The maximum number of eni in a enterprise level security group is exceeded.	O número de ENIs no grupo de segurança avançado atingiu o limite superior.
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.	O estado atual da ENI não permite esta operação.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Os grupos de segurança gerenciados por serviços de nuvem não suportam modificações.
403	InvalidParameter.InvalidEniQueueNumber	%s	O número de filas do controlador de interface de rede (NIC) é inválido. Para mais informações, consulte o valor real do placeholder %s na mensagem de erro.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	O número de filas do controlador de interface de rede (NIC) excede o limite superior. Para mais informações, consulte o valor real do placeholder %s na mensagem de erro.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	O número total de filas do controlador de interface de rede (NIC) excede o limite superior. Para mais informações, consulte o valor real do placeholder %s na mensagem de erro.
403	AclLimitExceed	%s	O número de regras de grupo de segurança para a ENI ou instância excede a cota.
403	InvalidOperation.EniTypeUnsupported	The specified eni type does not supported.	O tipo de negócio especificado não é suportado.
403	InvalidVSwitch.Ipv6NotEnabled	The VSwitch of ENI does not support IPv6 feature.
404	InvalidEcsId.NotFound	%s	A instância é inválida.
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s	O ID do vSwitch especificado não existe.
404	InvalidSecurityGroupId.NotFound	%s	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	InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc	Primary NetworkInterface is only allowed to modify name and description.	Apenas o nome e a descrição da ENI primária podem ser modificados.
404	InvalidParameter.SecurityGroupIdRepeated	The specified security group ids has repeated.	O grupo de segurança especificado já foi adicionado. Verifique se o valor do parâmetro SecurityGroupIds está correto.
409	OperationConflict	Request was denied due to conflict with a previous request,please try again later.	Ocorreu um conflito de solicitação. Aguarde um momento e tente novamente ou abra um ticket.
409	TokenProcessing	The previous token request is still processing. Please try again later.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.