ModifyNetworkInterfaceAttribute_云服务器 ECS_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

流控信息

请求速率为500/60(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
ecs:ModifyNetworkInterfaceAttribute
Update
NetworkInterface
acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}
SecurityGroup
acs:ecs:{#regionId}:{#accountId}:securitygroup/{#securitygroupId}

请求参数

字段名称字段详情
RegionIdstring

弹性网卡所在地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
NetworkInterfaceNamestring

弹性网卡的名称。长度为 2~128 个字符,必须以大小写字母或中文开头,不能以http://https://开头。支持 Unicode 中 letter 分类下的字符(其中包括英文、中文和数字等)。可以包含半角冒号(:)、下划线(_)、半角句号(.)或者短划线(-)。展开详情

示例值:eniTestName参考取值来源:
    CreateNetworkInterface
    DescribeNetworkInterfaces
NetworkInterfaceIdstring

弹性网卡 ID。

示例值:eni-bp67acfmxazb4p****参考取值来源:
    CreateNetworkInterface
    DescribeNetworkInterfaces
QueueNumberinteger<int32>

网卡队列数。取值范围:1~2048。展开详情

示例值:8取值 >= -1
Descriptionstring

弹性网卡的描述信息。长度为 2~255 个英文或中文字符,不能以 http://和 https://开头。展开详情

示例值:testDescription
SecurityGroupIdarray<string>

SecurityGroupId 列表,辅助弹性网卡最终加入的安全组,并会移出已有的安全组。展开详情

子级条数 <= 51
DeleteOnReleaseboolean

释放实例时是否保留网卡。取值范围:展开详情

示例值:true
RxQueueSizeinteger<int32>

弹性网卡入方向队列深度。展开详情

示例值:8192
TxQueueSizeinteger<int32>

弹性网卡出方向队列深度。展开详情

示例值:8192
NetworkInterfaceTrafficConfigobject

弹性网卡通讯参数

ConnectionTrackingConfigurationobject

网络连接跟踪配置信息集合。展开详情

EnhancedNetworkobject

该参数暂未开放使用。

SourceDestCheckboolean
说明 该参数正在邀测中,暂未开放使用。
示例值:false枚举值:

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
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.诊断
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诊断
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.诊断

变更历史

变更时间变更内容概要操作
2025-01-09
变更错误码400
变更请求参数EnhancedNetwork
2024-09-23
变更错误码404
2024-09-14
新增请求参数SourceDestCheck
2024-07-03
变更请求参数SecurityGroupId
2024-07-03
新增请求参数EnhancedNetwork
  • 1
  • 2
  • 10 条/页

相关示例