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
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
ecs:ModifyNetworkInterfaceAttribute |
update |
*NetworkInterface
*SecurityGroup
|
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 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.
|
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.
|
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.
|
true |
| RxQueueSize |
integer |
Não |
Especifica se a ENI deve ser liberada quando a instância à qual está anexada for liberada. Valores válidos:
|
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.
|
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.
|
|
| NetworkInterfaceTrafficMode |
string |
Não |
The traffic mode of the elastic network interface. Valid values:
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:
|
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:
|
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 Default value: 910. |
910 |
| TcpClosedAndTimeWaitTimeout |
integer |
Não |
The timeout period, in seconds, for TCP connections in the 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 |
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:
Quando a ENI está no estado InUse:
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:
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:
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.
|
||
| 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.
|
||
| 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 |
||
| 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:
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.