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, grupos de segurança associados, profundidade da fila, modo de comunicação e se a ENI deve ser retida quando a instância associada 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

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

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 DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
NetworkInterfaceName	string	Não	O nome do controlador de interface de rede (NIC). 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://`. O nome pode conter caracteres classificados como letras no Unicode, incluindo letras em inglês, caracteres chineses e dígitos. O nome também pode conter dois-pontos (:), sublinhados (_), pontos (.) ou 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 da 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 no estado InUse, mas anexada a uma instância no estado Stopped. O número de filas 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 em todas as ENIs de uma instância não pode exceder a cota total de filas permitida pelo tipo de instância. Você pode chamar DescribeInstanceTypes para consultar os campos MaximumQueueNumberPerEni e TotalEniQueueQuantity do 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 ingressa nos grupos de segurança especificados e é removido dos grupos de segurança existentes. Os valores válidos de N dependem do número máximo de grupos de segurança aos quais um controlador de interface de rede (NIC) pode pertencer. Para mais informações, consulte Limites. A modificação entra em vigor rapidamente, mas pode ocorrer um pequeno atraso.
	string	Não	A lista de IDs de grupos de segurança. Os valores válidos de N dependem do número máximo de grupos de segurança aos quais um controlador de interface de rede (NIC) pode pertencer. Para mais informações, consulte Limites. Você pode modificar grupos de segurança apenas para ENIs secundárias. Após a configuração dos grupos de segurança, a ENI secundária ingressa nos grupos de segurança especificados e é removida dos grupos de segurança existentes. A modificação entra em vigor rapidamente, mas pode ocorrer um pequeno atraso.	sg-bp67acfmxazb4p****
DeleteOnRelease	boolean	Não	Especifica se a ENI deve ser retida quando a instância associada 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évia por convite e não está disponível publicamente. Para usar este parâmetro, envie um ticket para solicitar acesso. Observe os seguintes itens: Este parâmetro se aplica apenas a instâncias da sétima geração ou posterior. Atualmente, este parâmetro se aplica apenas a imagens Linux. Uma maior profundidade da fila de entrada pode melhorar a taxa de transferência de entrada e reduzir a 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évia por convite e não está disponível publicamente. Para usar este parâmetro, envie um ticket para solicitar acesso. Observe os seguintes itens: Este parâmetro se aplica apenas a instâncias da sétima geração ou posterior. Atualmente, este parâmetro se aplica apenas a imagens Linux. Uma maior profundidade da fila de saída pode melhorar a taxa de transferência de saída e reduzir a perda de pacotes, mas consome mais memória.	8192
NetworkInterfaceTrafficConfig	object	Não	O parâmetro de comunicação do controlador de interface de rede (NIC).
NetworkInterfaceTrafficMode	string	Não	O padrão de comunicação do controlador de interface de rede (NIC). Valores válidos: Standard: usa o padrão de comunicação TCP. HighPerformance: ativa a Elastic RDMA Interface (ERI) e usa o padrão de comunicação RDMA. Quando o controlador de interface de rede (NIC) estiver no estado anexado, observe os seguintes itens: O número total de controladores de interface de rede (NICs) RDMA de uma instância não pode exceder a cota de controladores de interface de rede (NICs) RDMA permitida pelo tipo de instância. Você pode chamar DescribeInstanceTypes para consultar o campo EriQuantity referente à cota de controladores de interface de rede (NICs) RDMA. Nota Este parâmetro está em prévia por convite e não está disponível publicamente.	HighPerformance
QueueNumber	integer	Não	O número de filas do controlador de interface de rede (NIC). Quando o controlador de interface de rede (NIC) estiver no estado anexado, observe os seguintes itens: O valor 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 em todos os controladores de interface de rede (NICs) de uma instância não pode exceder a cota total de filas permitida pelo tipo de instância. Você pode chamar DescribeInstanceTypes para consultar os campos MaximumQueueNumberPerEni e TotalEniQueueQuantity. Nota Este parâmetro está em prévia por convite e não está disponível publicamente.	8
QueuePairNumber	integer	Não	O número de filas RDMA do controlador de interface de rede (NIC). Quando o controlador de interface de rede (NIC) estiver no estado anexado, observe os seguintes itens: O valor 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 chamar DescribeInstanceTypes para consultar o campo QueuePairNumber referente ao número máximo de filas por controlador de interface de rede (NIC) RDMA. Nota Este parâmetro está em prévia por convite e não está disponível publicamente.	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évia por convite e não está disponível publicamente. Para usar este parâmetro, envie um ticket para solicitar acesso. Observe os seguintes itens: Este parâmetro se aplica apenas a instâncias da sétima geração ou posterior. Atualmente, este parâmetro se aplica apenas a imagens Linux. Uma maior profundidade da fila de entrada pode melhorar a taxa de transferência de entrada e reduzir a 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évia por convite e não está disponível publicamente. Para usar este parâmetro, envie um ticket para solicitar acesso. Observe os seguintes itens: Este parâmetro se aplica apenas a instâncias da sétima geração ou posterior. Atualmente, este parâmetro se aplica apenas a imagens Linux. Uma maior profundidade da fila de saída pode melhorar a taxa de transferência de saída e reduzir a perda de pacotes, mas consome mais memória.	8192
ConnectionTrackingConfiguration	object	Não	A configuração de rastreamento de conectividade de rede. Antes de usar este parâmetro, leia 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, 910]. Valor padrão: 910.	910
TcpClosedAndTimeWaitTimeout	integer	Não	O período de tempo limite para conexões TCP nos estados TIME_WAIT e CLOSED. Unidade: segundos. Valores válidos: inteiros de 3 a 15. Valor padrão: 3. Nota Se sua instância ECS for usada com 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, 100]. Valor padrão: 30. Nota Se sua instância ECS for usada com NLB ou CLB, o valor padrão é de 100 segundos.	30
EnhancedNetwork	object	Não	Este parâmetro não está disponível publicamente.
EnableSriov	boolean	Não	Este parâmetro não está disponível publicamente.	true
EnableRss	boolean	Não	Nota Este parâmetro não está disponível publicamente.	false
VirtualFunctionTotalQueueNumber	integer	Não
VirtualFunctionQuantity	integer	Não
EnableExpress	boolean	Não
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 Apenas regiões específicas suportam este recurso. Antes de usar este recurso, leia Verificação de origem/destino.	false
EnablePrimaryIPv6	boolean	Não

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	Pelo menos um dos parâmetros especificados deve ser fornecido. Eles não podem estar todos vazios.
400	UnsupportedParameter	%s	O parâmetro especificado não é suportado.
400	InvalidParameter	%s	A combinação de parâmetros especificada é inválida.
400	InvalidInstanceID.Malformed	%s
400	InvalidOperation.InvalidEcsState	%s	O status atual da instância não suporta esta operação.
400	InvalidOperation.InvalidEniState	%s	O status atual da ENI não permite a modificação dos atributos da ENI.
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	Não é permitido desanexar a ENI primária de uma instância.
400	InvalidParams.EniId	%s	O parâmetro EniId especificado é inválido.
400	Forbidden.RegionId	%s	Este serviço está temporariamente indisponível na região atual.
400	JoinedGroupLimitExceed	%s	O número máximo de grupos de segurança aos quais o recurso especificado pode ingressar foi atingido. Para mais informações, consulte o resultado real retornado no placeholder %s da 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 região ou o usuário não oferece suporte à configuração da profundidade da fila da interface de rede.
400	InvalidParameter.EniQueueSize	The specified parameter TxQueueSize and RxQueueSize are not equal or exceed limit.	As profundidades de fila de saída e de entrada da ENI não são iguais ou não estão dentro do intervalo de valores permitido.
400	InvalidParameter.Conflict	%s	A operação atual não permite que diskId e imageId sejam especificados simultaneamente. Certifique-se de que diskId ou imageId não esteja vazio.
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 região ou o usuário não oferece suporte à configuração das definições de conexão da interface de rede.
400	InvalidParameter.InvalidQueuePairNumber	The specified parameter QueuePairNumber exceeds limit.	O número especificado de filas de interface de rede 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 o controlador de interface de rede (NIC) excede o intervalo permitido.
400	InvalidOperation.MaxEniQueuePairNumberExceed	The QueuePairNumber on the RDMA ENI exceeds the upper limit allowed for a single ENI.	O número total de filas RDMA para a instância ECS associada à Elastic Network Interface (ENI) excede o limite do tipo de instância.
400	InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded	The number of RDMA ENIs attached to the ECS instance exceeds the upper limit.	O número de interfaces de rede com RDMA ativado anexadas à instância ECS atual excede o limite do tipo de instância de destino.
400	InvalidOperation.InstanceTypeNotSupportHighPerformance	The ECS instance type where the ENI is located does not support the RDMA mode.	O tipo de instância ECS da instância ECS à qual a Elastic Network Interface (ENI) está anexada não suporta o modo de comunicação RDMA.
400	InvalidTrafficMode.ModifyToStandardNotSupported	The specified parameter NetworkInterfaceTrafficMode is not supported to modify to Standard.	O modo de comunicação da interface de rede não pode ser alterado de RDMA para TCP.
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 total de pares de filas da Elastic Network Interface (ENI) anexada à instância excede o máximo permitido pelo tipo de instância especificado.
400	InvalidParameter.QueuePairNumberMustEmpty	When the traffic mode is set to Standard, the QueuePairNumber must be empty.	Quando o Modo de Tráfego está definido como Standard, o parâmetro QueuePairNumber especificado 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 do controlador de interface de rede (NIC) é 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 suporta a ativação de 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.	O parâmetro de aprimoramento de rede especificado é inválido. Quando EnableSriov estiver definido como true, VirtualFunctionTotalQueueNumber não deve estar vazio e VirtualFunctionQuantity deve estar no intervalo de 1 a 256. Quando EnableSriov estiver 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 está definido como true, a modificação de VirtualFunctionTotalQueueNumber e VirtualFunctionQuantity não é suportada.
400	InvalidOperation.TrunkAttachmentMustEmpty	The Attachment of the current Trunk type Network Interface must be empty when modify EnableSriov to true.	Quando você define EnableSriov como true, o dispositivo anexado à ENI trunk deve estar vazio.
400	Throttling	Request was denied due to request throttling, try again later.	A solicitação foi limitada. Use o método de paginação baseado em NextToken em vez do método de paginação baseado em PageNumber para consultas.
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 um controlador de interface de rede (NIC).
400	InvalidOperation.EnablePrimaryIPv6	The specified ENI can not enable primary IPv6 or already has primary IPv6.	A ENI especificada não pode ativar o IPv6 primário ou já possui um endereço IPv6 primário.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro ao enviar a solicitação. Tente novamente mais tarde.
403	InvalidUserType.NotSupported	%s	O parâmetro de tipo de usuário é inválido.
403	Abs.InvalidAccount.NotFound	%s	Sua conta Alibaba Cloud não existe ou sua AccessKey expirou.
403	Forbidden.NotSupportRAM	%s	Usuários do Resource Access Management (RAM) não têm suporte para executar esta operação.
403	Forbidden.SubUser	%s	Sua conta não tem permissão para operar neste recurso. Solicite as permissões necessárias à conta Alibaba Cloud.
403	MaxEniCountExceeded	%s	O número máximo de Elastic Network Interfaces (ENIs) que podem ser operadas foi excedido.
403	EniPerInstanceLimitExceeded	%s	O número de Elastic Network Interfaces (ENIs) anexadas à instância atingiu o limite máximo. Nenhuma outra Elastic Network Interface (ENI) pode ser anexada à instância.
403	InvalidOperation.AvailabilityZoneMismatch	%s	O controlador de interface de rede (NIC) e a instância ECS não estão na mesma zona porque seus vSwitches estão em zonas diferentes.
403	InvalidOperation.VpcMismatch	%s	A VPC do controlador de interface de rede (NIC) não corresponde à VPC do grupo de segurança.
403	SecurityGroupInstanceLimitExceed	%s	O número de instâncias no grupo de segurança atingiu o limite máximo.
403	InvalidSecurityGroupId.NotVpc	%s	O parâmetro SecurityGroupId é inválido. O tipo de rede do grupo de segurança não é VPC.
403	InvalidOperation.InvalidEniType	%s	O tipo atual da Elastic Network Interface (ENI) não suporta esta operação. O tipo do controlador de interface de rede (NIC) é incompatível.
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 ingressar em 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 Interfaces de Rede Elástica (ENIs) anexadas à instância ECS atual excede o limite de Interfaces de Rede Elástica (ENIs) do tipo de instância de destino.
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 status atual da ENI não permite a modificação dos atributos da ENI.
403	InvalidOperation.ResourceManagedByCloudProduct	%s	Esta operação não é suportada porque o recurso é gerenciado por um serviço em nuvem. Entre em contato com o serviço em nuvem correspondente para confirmar o motivo.
403	InvalidParameter.InvalidEniQueueNumber	%s	O número de filas da controladora de interface de rede (NIC) está incorreto. Consulte o resultado de retorno real do espaço reservado %s na mensagem de erro para obter detalhes.
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	O número de filas da Elastic Network Interface (ENI) excede o limite superior. Para mais informações, consulte o resultado de retorno real do placeholder %s na mensagem de erro.
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	O número de filas da Elastic Network Interface (ENI) anexadas à instância ECS atual excede o limite de filas do controlador de interface de rede (NIC) do tipo de instância de destino.
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	O ID da instância especificado não existe.
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s	O vSwitch especificado não existe.
404	InvalidSecurityGroupId.NotFound	%s	O grupo de segurança especificado não existe.
404	InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc	Primary NetworkInterface is only allowed to modify name and description.	A ENI primária oferece suporte apenas à modificação do nome e da descrição da ENI.
404	InvalidParameter.SecurityGroupIdRepeated	The specified security group ids has repeated.	O grupo de segurança está duplicado.
409	OperationConflict	Request was denied due to conflict with a previous request,please try again later.	O recurso solicitado entra em conflito com uma solicitação anterior.
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.