ModifyNetworkInterfaceAttribute - 修改彈性網卡屬性 - Elastic Compute Service

修改一個彈性網卡（ENI）的網卡隊列數、所屬安全性群組、隊列深度、通訊模式以及釋放執行個體時是否保留網卡等屬性。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ecs:ModifyNetworkInterfaceAttribute

update

*NetworkInterface

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

*SecurityGroup

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

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	彈性網卡所在地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。	cn-hangzhou
RegionId	string	是	彈性網卡所在地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。	cn-hangzhou
NetworkInterfaceName	string	否	彈性網卡的名稱。長度為 2~128 個字元，必須以大小寫字母或中文開頭，不能以`http://`和`https://`開頭。支援 Unicode 中 letter 分類下的字元（其中包括英文、中文和數字等）。可以包含半形冒號（:）、底線（_）、半形句號（.）或者短劃線（-）。預設值：空。	eniTestName
NetworkInterfaceId	string	是	彈性網卡 ID。	eni-bp67acfmxazb4p****
QueueNumber	integer	否	網卡隊列數。取值範圍：1~2048。允許修改處於可用狀態（`Available`）的網卡隊列數，或者已附加（`InUse`）至執行個體但執行個體為已停止（`Stopped`）狀態的網卡隊列數。網卡隊列數不能超過執行個體規格允許的單塊網卡最大隊列數，同時執行個體的所有網卡累加隊列數不能超過執行個體規格允許的隊列數總配額。執行個體規格的單塊網卡最大隊列數和總配額可以通過 DescribeInstanceTypes 介面查詢`MaximumQueueNumberPerEni`、`TotalEniQueueQuantity`欄位。	8
Description	string	否	彈性網卡的描述資訊。長度為 2~255 個英文或中文字元，不能以 http://和 https://開頭。預設值：空。	testDescription
SecurityGroupId	array	否	SecurityGroupId 列表，輔助彈性網卡最終加入的安全性群組，並會移出已有的安全性群組。 N 的取值範圍與每張彈性網卡能夠加入的安全性群組數量配額有關，更多資訊，請參見使用限制。修改安全性群組後很快會生效，但可能有較小的延遲。
	string	否	SecurityGroupId 列表。 N 的取值範圍與每張彈性網卡能夠加入的安全性群組數量配額有關，更多資訊，請參見使用限制。只允許修改輔助網卡的安全性群組。設定安全性群組後，輔助彈性網卡會加入該安全性群組，並且移出已有安全性群組。修改安全性群組後很快會生效，但可能有較小的延遲。	sg-bp67acfmxazb4p****
DeleteOnRelease	boolean	否	釋放執行個體時是否保留網卡。取值範圍： true：不保留。 false：保留。	true
RxQueueSize	integer	否	彈性網卡入方向隊列深度。說明該參數正在邀測中，暫未開放使用，如有需求請工單聯絡加白。您需要注意：僅適用於 7 代及以後 ECS 規格。目前僅適用於 Linux 鏡像。較大的入方向隊列深度可以提升入方向的輸送量，降低丟包機率，但會佔用更多的記憶體。	8192
TxQueueSize	integer	否	彈性網卡出方向隊列深度。說明該參數正在邀測中，暫未開放使用，如有需求請工單聯絡加白。您需要注意：僅適用於 7 代及以後 ECS 規格。目前僅適用於 Linux 鏡像。較大的出方向隊列深度可以提升出方向的輸送量，降低丟包機率，但會佔用更多的記憶體。	8192
NetworkInterfaceTrafficConfig	object	否	彈性網卡通訊參數
NetworkInterfaceTrafficMode	string	否	網卡的通訊模式。參數取值範圍： Standard：使用 TCP 通訊模式。 HighPerformance：開啟 ERI（Elastic RDMA Interface）介面，使用 RDMA 通訊模式。當彈性網卡處於掛載態時，您需要注意：執行個體的所有 RDMA 網卡數不能超過執行個體規格允許的 RDMA 網卡數配額。執行個體規格允許的 RDMA 網卡數配額可以通過 DescribeInstanceTypes 介面查詢 EriQuantity 欄位。說明該參數正在邀測中，暫未開放使用。	HighPerformance
QueueNumber	integer	否	彈性網卡隊列數。當彈性網卡處於掛載態時，您需要注意：不能超過執行個體規格允許的單塊網卡最大隊列數。執行個體的所有網卡累加隊列數不能超過執行個體規格允許的隊列數總配額。執行個體規格的單塊網卡最大隊列數和總配額可以通過 DescribeInstanceTypes 介面查詢 MaximumQueueNumberPerEni、TotalEniQueueQuantity 欄位。說明該參數正在邀測中，暫未開放使用。	8
QueuePairNumber	integer	否	RDMA 網卡隊列數。當彈性網卡處於掛載態時，您需要注意：不能超過執行個體規格允許的單塊 RDMA 網卡最大隊列數。執行個體規格允許的單塊 RDMA 網卡最大隊列數可以通過 DescribeInstanceTypes 介面查詢 QueuePairNumber 欄位。說明該參數正在邀測中，暫未開放使用。	8
RxQueueSize	integer	否	彈性網卡入方向隊列深度。說明該參數正在邀測中，暫未開放使用，如有需求請工單聯絡加白。您需要注意：僅適用於 7 代及以後 ECS 規格。目前僅適用於 Linux 鏡像。較大的入方向隊列深度可以提升入方向的輸送量，降低丟包機率，但會佔用更多的記憶體。	8192
TxQueueSize	integer	否	彈性網卡出方向隊列深度。說明該參數正在邀測中，暫未開放使用，如有需求請工單聯絡加白。您需要注意：僅適用於 7 代及以後 ECS 規格。目前僅適用於 Linux 鏡像。較大的出方向隊列深度可以提升出方向的輸送量，降低丟包機率，但會佔用更多的記憶體。	8192
ConnectionTrackingConfiguration	object	否	網路連接跟蹤配置資訊集合。使用該參數前，請認真閱讀連線逾時管理。
TcpEstablishedTimeout	integer	否	已建狀態的 TCP 連線逾時時間，單位：s（秒）。取值範圍：[30, 60, 80, 100, 200, 300, 500, 700, 910]。預設值：910。	910
TcpClosedAndTimeWaitTimeout	integer	否	TCP 等待與關閉逾時時間，單位：s（秒）。取值範圍：3~15 內的整數。預設值：3。說明如果您的 ECS 執行個體配合 NLB/CLB 使用，`TIME_WAIT`狀態的連線逾時時間預設值為 15 秒。	3
UdpTimeout	integer	否	UDP 流逾時時間。單位：s（秒）。取值範圍：[10, 20, 30, 60, 80, 100]。預設值：30。說明如果您的 ECS 執行個體配合 NLB/CLB 使用，預設值為 100 秒。	30
EnhancedNetwork	object	否	該參數暫未開放使用。
EnableSriov	boolean	否	該參數暫未開放使用。	true
EnableRss	boolean	否	說明該參數暫未開放使用。	false
VirtualFunctionTotalQueueNumber	integer	否
VirtualFunctionQuantity	integer	否
SourceDestCheck	boolean	否	是否開啟源/目的檢查功能。建議您開啟該功能，以提高網路安全。可能值： true：是。 false：否。預設值：false。說明僅部分地區支援該功能。使用前，請認真閱讀源/目的檢查。	false

返回參數

名稱	類型	描述	樣本值
	object	請求 ID。
RequestId	string	請求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

樣本

正常返回樣本

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidOperation.NotSupportModifyQueueNumber	%s
400	MissingParameter	%s	缺失參數，請檢查參數是否完整。
400	UnsupportedParameter	%s	不支援參數。
400	InvalidParameter	%s	無效的參數。
400	InvalidInstanceID.Malformed	%s	參數 InstanceId 格式錯誤。
400	InvalidOperation.InvalidEcsState	%s	執行個體當前的狀態不支援此操作。
400	InvalidOperation.InvalidEniState	%s	彈性網卡當前的狀態不支援此操作。
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s	不允許分離執行個體的主網卡。
400	InvalidParams.EniId	%s	指定的參數 EniId 無效。
400	Forbidden.RegionId	%s	當前地區暫時沒有提供該服務。
400	JoinedGroupLimitExceed	%s	指定資源所能加入的安全性群組數量達到上限。具體資訊請參見錯誤資訊%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	您輸入的參數無效，請檢查參數之間是否衝突。%s為變數，將根據調用API的實際情況動態返回錯誤資訊。
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.	指定的RDMA網卡隊列數超過限制。
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.	該彈性網卡 RDMA 隊列數超過單張彈性網卡允許的上限
400	InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded	The number of RDMA ENIs attached to the ECS instance exceeds the upper limit.	彈性網卡所在的ECS執行個體掛載的 RDMA 網卡數超上限
400	InvalidOperation.InstanceTypeNotSupportHighPerformance	The ECS instance type where the ENI is located does not support the RDMA mode.	彈性網卡所在的ECS執行個體規格不支援 RDMA 通訊模式
400	InvalidTrafficMode.ModifyToStandardNotSupported	The specified parameter NetworkInterfaceTrafficMode is not supported to modify to Standard.	不支援將彈性網卡的通訊模式改為 Standard 。
400	InvalidOperation.EniTrafficModeNotSupportIPv6	The ENI using High Performance traffic mode does not support IPv6.	使用 RDMA 高效能通訊模式的彈性網卡，不支援使用 IPv6。
400	InvalidOperation.EniQueuePairNumberOverflow	The RDMA QueuePairNumber of the ECS instance associated with the specified ENI exceeds the limit.	指定的彈性網卡所在的ECS執行個體 RDMA 網卡隊列數超出限制。
400	InvalidParameter.QueuePairNumberMustEmpty	When the traffic mode is set to Standard, the QueuePairNumber must be empty.	建立TCP通訊模式的彈性網卡時，彈性網卡的RDMA模式隊列數必須為空白。
400	InvalidParameter.EniTrafficMode	The ENI traffic mode is set incorrectly, it must be either Standard or HighPerformance.	彈性網卡的通訊模式不合法，取值範圍為Standard或HighPerformance。
400	InvalidOperation.InstanceTypeNotSupportRss	The ECS instance type does not support Rss.	指定執行個體的規格不支援開啟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.	指定的網路增強功能參數不合法，當EnableSriov設定為true時，VirtualFunctionTotalQueueNumber必須不為空白，且VirtualFunctionQuantity取值範圍1-256；當EnableSriov為空白或設定為false時，VirtualFunctionTotalQueueNumber和VirtualFunctionQuantity必須為空白
400	InvalidOperation.NotSupportModifyVFQueueNumberAndVFQuantity	The ENI not support modify VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity when EnableSriov is true.	當EnableSriov為true時，不支援修改VirtualFunctionTotalQueueNumber和VirtualFunctionQuantity
400	InvalidOperation.TrunkAttachmentMustEmpty	The Attachment of the current Trunk type Network Interface must be empty when modify EnableSriov to true.	當修改EnableSriov為true時，Trunk網卡掛載的裝置必須為空白
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.	當前地區不支援修改彈性網卡SourceDestCheck屬性。
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	內部錯誤，請重試。
403	InvalidUserType.NotSupported	%s	您當前的帳號不支援此操作。
403	Abs.InvalidAccount.NotFound	%s	您的阿里雲帳號不存在，或者您的 AccessKey 已經到期。
403	Forbidden.NotSupportRAM	%s	暫不支援RAM使用者執行該操作。
403	Forbidden.SubUser	%s	您的帳號沒有操作此資源的許可權，請向主帳號申請相關的許可權。
403	MaxEniCountExceeded	%s	已超過可以操作的最大彈性網卡數。
403	EniPerInstanceLimitExceeded	%s	執行個體附加的彈性網卡數量已經達到了最大限度，不能再為執行個體附加彈性網卡。
403	InvalidOperation.AvailabilityZoneMismatch	%s	該操作無效。
403	InvalidOperation.VpcMismatch	%s	您的操作無效，請確認該操作中的 VPC 與其它參數是否匹配。
403	SecurityGroupInstanceLimitExceed	%s	該安全性群組內已有的執行個體數量已達到最大限制。
403	InvalidSecurityGroupId.NotVpc	%s	參數 SecurityGroupId 無效，該安全性群組的網路類型不是專用網路。
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.	當前 ENI 的狀態不允許修改該網卡屬性
403	InvalidOperation.ResourceManagedByCloudProduct	%s	雲產品託管的安全性群組不支援修改操作。
403	InvalidParameter.InvalidEniQueueNumber	%s	彈性網卡隊列數有誤，具體資訊請參見錯誤資訊%s預留位置的實際返回結果。
403	InvalidOperation.MaxEniQueueNumberExceeded	%s	彈性網卡隊列數超過上限，具體資訊請參見錯誤資訊%s預留位置的實際返回結果。
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s	彈性網卡隊列總數超過上限，具體資訊請參見錯誤資訊%s預留位置的實際返回結果。
403	AclLimitExceed	%s	網卡或執行個體的安全性群組規則數量超過限額值。
403	InvalidOperation.EniTypeUnsupported	The specified eni type does not supported.	指定的業務類型不支援。
404	InvalidEcsId.NotFound	%s	指定的執行個體 ID 不存在。
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s	指定的交換器不存在。
404	InvalidSecurityGroupId.NotFound	%s	指定的安全性群組 ID 不存在。
404	InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc	Primary NetworkInterface is only allowed to modify name and description.	主網卡僅支援修改網卡名稱和描述。
404	InvalidParameter.SecurityGroupIdRepeated	The specified security group ids has repeated.	指定的安全性群組已重複添加。請檢查 SecurityGroupIds 參數值是否正確。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。