調用ModifyNetworkInterfaceAttribute接口,并可以指定NetworkInterfaceId、SecurityGroupId等參數,修改一個彈性網卡(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 |
NetworkInterfaceName | string | 否 | 彈性網卡的名稱。長度為 2~128 個字符,必須以大小寫字母或中文開頭,不能以 默認值:空。 | eniTestName |
NetworkInterfaceId | string | 是 | 彈性網卡 ID。 | eni-bp67acfmxazb4p**** |
QueueNumber | integer | 否 | 網卡隊列數。取值范圍:1~2048。
| 8 |
Description | string | 否 | 彈性網卡的描述信息。長度為 2~255 個英文或中文字符,不能以 http://和 https://開頭。 默認值:空。 | testDescription |
SecurityGroupId | array | 否 | SecurityGroupId 列表,輔助彈性網卡最終加入的安全組,并會移出已有的安全組。
| |
string | 否 | SecurityGroupId 列表。
| sg-bp67acfmxazb4p**** | |
DeleteOnRelease | boolean | 否 | 釋放實例時是否保留網卡。取值范圍:
| true |
RxQueueSize | integer | 否 | 彈性網卡入方向隊列深度。 您需要注意:
| 8192 |
TxQueueSize | integer | 否 | 彈性網卡出方向隊列深度。 您需要注意:
| 8192 |
NetworkInterfaceTrafficConfig | object | 否 | 彈性網卡通訊參數 | |
NetworkInterfaceTrafficMode | string | 否 | 網卡的通訊模式。參數取值范圍:
當彈性網卡處于掛載態時,您需要注意:
說明
該參數正在邀測中,暫未開放使用。
| HighPerformance |
QueueNumber | integer | 否 | 彈性網卡隊列數。 當彈性網卡處于掛載態時,您需要注意:
說明
該參數正在邀測中,暫未開放使用。
| 8 |
QueuePairNumber | integer | 否 | RDMA 網卡隊列數。 當彈性網卡處于掛載態時,您需要注意:
說明
該參數正在邀測中,暫未開放使用。
| 8 |
RxQueueSize | integer | 否 | 彈性網卡入方向隊列深度。 您需要注意:
說明
該參數正在邀測中,暫未開放使用。
| 8192 |
TxQueueSize | integer | 否 | 彈性網卡出方向隊列深度。 您需要注意:
說明
該參數正在邀測中,暫未開放使用。
| 8192 |
ConnectionTrackingConfiguration | object | 否 | 說明
該參數正在邀測中,暫未開放使用。
| |
TcpEstablishedTimeout | integer | 否 | 說明
該參數正在邀測中,暫未開放使用。
| 910 |
TcpClosedAndTimeWaitTimeout | integer | 否 | 說明
該參數正在邀測中,暫未開放使用。
| 3 |
UdpTimeout | integer | 否 | 說明
該參數正在邀測中,暫未開放使用。
| 30 |
EnhancedNetwork | object | 否 | 該參數暫未開放使用。 | |
EnableSriov | boolean | 否 | 該參數暫未開放使用。 | true |
SourceDestCheck | boolean | 否 | 說明
該參數正在邀測中,暫未開放使用。
| false |
返回參數
示例
正常返回示例
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。 |
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 | 網卡或實例的安全組規則數量超過限額值。 |
404 | InvalidEcsId.NotFound | %s | 指定的實例 ID 不存在。 |
404 | InvalidEniId.NotFound | %s | 指定的彈性網卡 ID 不存在。 |
404 | InvalidVSwitchId.NotFound | %s | 指定的交換機不存在。 |
404 | InvalidSecurityGroupId.NotFound | %s | 指定的安全組 ID 不存在。 |
404 | InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc | Primary NetworkInterface is only allowed to modify name and description. | 主網卡僅支持修改網卡名稱和描述。 |
404 | InvalidSecurityGroupId.NotFound | Specified security group not exist. | 指定的安全組在該用戶賬號下不存在,請您檢查安全組 id 是否正確。 |
404 | InvalidParameter.SecurityGroupIdRepeated | The specified security group ids has repeated. | 指定的安全組已重復添加。請檢查 SecurityGroupIds 參數值是否正確。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-09-23 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-09-14 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2024-07-03 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-07-03 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2024-05-17 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2024-05-07 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2024-01-24 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2023-10-09 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
2023-06-14 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |