調(diào)用ModifyNetworkInterfaceAttribute接口,并可以指定NetworkInterfaceId、SecurityGroupId等參數(shù),修改一個彈性網(wǎng)卡(ENI)的名稱、描述以及所屬安全組等屬性。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 彈性網(wǎng)卡所在地域 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
NetworkInterfaceName | string | 否 | 彈性網(wǎng)卡的名稱。長度為 2~128 個字符,必須以大小寫字母或中文開頭,不能以 默認(rèn)值:空。 | eniTestName |
NetworkInterfaceId | string | 是 | 彈性網(wǎng)卡 ID。 | eni-bp67acfmxazb4p**** |
QueueNumber | integer | 否 | 網(wǎng)卡隊列數(shù)。取值范圍:1~2048。
| 8 |
Description | string | 否 | 彈性網(wǎng)卡的描述信息。長度為 2~255 個英文或中文字符,不能以 http://和 https://開頭。 默認(rèn)值:空。 | testDescription |
SecurityGroupId | array | 否 | SecurityGroupId 列表,輔助彈性網(wǎng)卡最終加入的安全組,并會移出已有的安全組。
| |
string | 否 | SecurityGroupId 列表。
| sg-bp67acfmxazb4p**** | |
DeleteOnRelease | boolean | 否 | 釋放實例時是否保留網(wǎng)卡。取值范圍:
| true |
RxQueueSize | integer | 否 | 彈性網(wǎng)卡入方向隊列深度。 您需要注意:
| 8192 |
TxQueueSize | integer | 否 | 彈性網(wǎng)卡出方向隊列深度。 您需要注意:
| 8192 |
NetworkInterfaceTrafficConfig | object | 否 | 彈性網(wǎng)卡通訊參數(shù) | |
NetworkInterfaceTrafficMode | string | 否 | 網(wǎng)卡的通訊模式。參數(shù)取值范圍:
當(dāng)彈性網(wǎng)卡處于掛載態(tài)時,您需要注意:
說明
該參數(shù)正在邀測中,暫未開放使用。
| HighPerformance |
QueueNumber | integer | 否 | 彈性網(wǎng)卡隊列數(shù)。 當(dāng)彈性網(wǎng)卡處于掛載態(tài)時,您需要注意:
說明
該參數(shù)正在邀測中,暫未開放使用。
| 8 |
QueuePairNumber | integer | 否 | RDMA 網(wǎng)卡隊列數(shù)。 當(dāng)彈性網(wǎng)卡處于掛載態(tài)時,您需要注意:
說明
該參數(shù)正在邀測中,暫未開放使用。
| 8 |
RxQueueSize | integer | 否 | 彈性網(wǎng)卡入方向隊列深度。 您需要注意:
說明
該參數(shù)正在邀測中,暫未開放使用。
| 8192 |
TxQueueSize | integer | 否 | 彈性網(wǎng)卡出方向隊列深度。 您需要注意:
說明
該參數(shù)正在邀測中,暫未開放使用。
| 8192 |
ConnectionTrackingConfiguration | object | 否 | 說明
該參數(shù)正在邀測中,暫未開放使用。
| |
TcpEstablishedTimeout | integer | 否 | 說明
該參數(shù)正在邀測中,暫未開放使用。
| 910 |
TcpClosedAndTimeWaitTimeout | integer | 否 | 說明
該參數(shù)正在邀測中,暫未開放使用。
| 3 |
UdpTimeout | integer | 否 | 說明
該參數(shù)正在邀測中,暫未開放使用。
| 30 |
EnhancedNetwork | object | 否 | 該參數(shù)暫未開放使用。 | |
EnableSriov | boolean | 否 | 該參數(shù)暫未開放使用。 | true |
SourceDestCheck | boolean | 否 | 說明
該參數(shù)正在邀測中,暫未開放使用。
| false |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | InvalidOperation.NotSupportModifyQueueNumber | %s | - |
400 | MissingParameter | %s | 缺失參數(shù),請檢查參數(shù)是否完整。 |
400 | UnsupportedParameter | %s | 不支持參數(shù)。 |
400 | InvalidParameter | %s | 無效的參數(shù)。 |
400 | InvalidInstanceID.Malformed | %s | 參數(shù) InstanceId 格式錯誤。 |
400 | InvalidOperation.InvalidEcsState | %s | 實例當(dāng)前的狀態(tài)不支持此操作。 |
400 | InvalidOperation.InvalidEniState | %s | 彈性網(wǎng)卡當(dāng)前的狀態(tài)不支持此操作。 |
400 | InvalidOperation.DetachPrimaryEniNotAllowed | %s | 不允許分離實例的主網(wǎng)卡。 |
400 | InvalidParams.EniId | %s | 指定的參數(shù) EniId 無效。 |
400 | Forbidden.RegionId | %s | 當(dāng)前地域暫時沒有提供該服務(wù)。 |
400 | JoinedGroupLimitExceed | %s | 指定資源所能加入的安全組數(shù)量達(dá)到上限。具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。 |
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. | 地域或用戶不支持設(shè)置網(wǎng)卡隊列深度 |
400 | InvalidParameter.EniQueueSize | The specified parameter TxQueueSize and RxQueueSize are not equal or exceed limit. | 出方向和入方向網(wǎng)卡隊列深度不相等或超出允許的范圍 |
400 | InvalidParameter.Conflict | %s | 您輸入的參數(shù)無效,請檢查參數(shù)之間是否沖突。%s為變量,將根據(jù)調(diào)用API的實際情況動態(tài)返回錯誤信息。 |
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. | 地域或用戶不支持設(shè)置網(wǎng)卡連接配置 |
400 | InvalidParameter.InvalidQueuePairNumber | The specified parameter QueuePairNumber exceeds limit. | 指定的RDMA網(wǎng)卡隊列數(shù)超過限制。 |
400 | InvalidParameter.EniConnectionTrackingConfiguration | The specify network interface connection tracking configuration exceeds limit. | 網(wǎng)卡指定的網(wǎng)絡(luò)連接配置超出允許的范圍 |
400 | InvalidOperation.MaxEniQueuePairNumberExceed | The QueuePairNumber on the RDMA ENI exceeds the upper limit allowed for a single ENI. | 該彈性網(wǎng)卡 RDMA 隊列數(shù)超過單張彈性網(wǎng)卡允許的上限 |
400 | InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded | The number of RDMA ENIs attached to the ECS instance exceeds the upper limit. | 彈性網(wǎng)卡所在的ECS實例掛載的 RDMA 網(wǎng)卡數(shù)超上限 |
400 | InvalidOperation.InstanceTypeNotSupportHighPerformance | The ECS instance type where the ENI is located does not support the RDMA mode. | 彈性網(wǎng)卡所在的ECS實例規(guī)格不支持 RDMA 通訊模式 |
400 | InvalidTrafficMode.ModifyToStandardNotSupported | The specified parameter NetworkInterfaceTrafficMode is not supported to modify to Standard. | 不支持將彈性網(wǎng)卡的通訊模式改為 Standard 。 |
400 | InvalidOperation.EniTrafficModeNotSupportIPv6 | The ENI using High Performance traffic mode does not support IPv6. | 使用 RDMA 高性能通訊模式的彈性網(wǎng)卡,不支持使用 IPv6。 |
400 | InvalidOperation.EniQueuePairNumberOverflow | The RDMA QueuePairNumber of the ECS instance associated with the specified ENI exceeds the limit. | 指定的彈性網(wǎng)卡所在的ECS實例 RDMA 網(wǎng)卡隊列數(shù)超出限制。 |
400 | InvalidParameter.QueuePairNumberMustEmpty | When the traffic mode is set to Standard, the QueuePairNumber must be empty. | 創(chuàng)建TCP通訊模式的彈性網(wǎng)卡時,彈性網(wǎng)卡的RDMA模式隊列數(shù)必須為空。 |
400 | InvalidParameter.EniTrafficMode | The ENI traffic mode is set incorrectly, it must be either Standard or HighPerformance. | 彈性網(wǎng)卡的通訊模式不合法,取值范圍為Standard或HighPerformance。 |
403 | InvalidUserType.NotSupported | %s | 您當(dāng)前的賬號不支持此操作。 |
403 | Abs.InvalidAccount.NotFound | %s | 您的阿里云賬號不存在,或者您的 AccessKey 已經(jīng)過期。 |
403 | Forbidden.NotSupportRAM | %s | 暫不支持RAM用戶執(zhí)行該操作。 |
403 | Forbidden.SubUser | %s | 您的賬號沒有操作此資源的權(quán)限,請向主賬號申請相關(guān)的權(quán)限。 |
403 | MaxEniCountExceeded | %s | 已超過可以操作的最大彈性網(wǎng)卡數(shù)。 |
403 | EniPerInstanceLimitExceeded | %s | 實例附加的彈性網(wǎng)卡數(shù)量已經(jīng)達(dá)到了最大限度,不能再為實例附加彈性網(wǎng)卡。 |
403 | InvalidOperation.AvailabilityZoneMismatch | %s | 該操作無效。 |
403 | InvalidOperation.VpcMismatch | %s | 您的操作無效,請確認(rèn)該操作中的 VPC 與其它參數(shù)是否匹配。 |
403 | SecurityGroupInstanceLimitExceed | %s | 該安全組內(nèi)已有的實例數(shù)量已達(dá)到最大限制。 |
403 | InvalidSecurityGroupId.NotVpc | %s | 參數(shù) SecurityGroupId 無效,該安全組的網(wǎng)絡(luò)類型不是專有網(wǎng)絡(luò)。 |
403 | InvalidOperation.InvalidEniType | %s | 當(dāng)前彈性網(wǎng)卡的類型不支持此操作。 |
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 | 云產(chǎn)品托管的安全組不支持修改操作。 |
403 | InvalidParameter.InvalidEniQueueNumber | %s | 彈性網(wǎng)卡隊列數(shù)有誤,具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。 |
403 | InvalidOperation.MaxEniQueueNumberExceeded | %s | 彈性網(wǎng)卡隊列數(shù)超過上限,具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。 |
403 | InvalidOperation.ExceedInstanceTypeQueueNumber | %s | 彈性網(wǎng)卡隊列總數(shù)超過上限,具體信息請參見錯誤信息%s占位符的實際返回結(jié)果。 |
403 | AclLimitExceed | %s | 網(wǎng)卡或?qū)嵗陌踩M規(guī)則數(shù)量超過限額值。 |
404 | InvalidEcsId.NotFound | %s | 指定的實例 ID 不存在。 |
404 | InvalidEniId.NotFound | %s | 指定的彈性網(wǎng)卡 ID 不存在。 |
404 | InvalidVSwitchId.NotFound | %s | 指定的交換機(jī)不存在。 |
404 | InvalidSecurityGroupId.NotFound | %s | 指定的安全組 ID 不存在。 |
404 | InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc | Primary NetworkInterface is only allowed to modify name and description. | 主網(wǎng)卡僅支持修改網(wǎng)卡名稱和描述。 |
404 | InvalidSecurityGroupId.NotFound | Specified security group not exist. | 指定的安全組在該用戶賬號下不存在,請您檢查安全組 id 是否正確。 |
404 | InvalidParameter.SecurityGroupIdRepeated | The specified security group ids has repeated. | 指定的安全組已重復(fù)添加。請檢查 SecurityGroupIds 參數(shù)值是否正確。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-09-23 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2024-09-14 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2024-07-03 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |
2024-07-03 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2024-05-17 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2024-05-07 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2024-01-24 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2023-10-09 | OpenAPI 錯誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2023-06-14 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |