調(diào)用ModifyNetworkInterfaceAttribute接口，并可以指定NetworkInterfaceId、SecurityGroupId等參數(shù)，修改一個(gè)彈性網(wǎng)卡（ENI）的名稱、描述以及所屬安全組等屬性。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別：是指每個(gè)操作的訪問級(jí)別，取值為寫入（Write）、讀?。≧ead）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對(duì)于必選的資源類型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| ecs:ModifyNetworkInterfaceAttribute | update | *NetworkInterface acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}*SecurityGroup acs:ecs:{#regionId}:{#accountId}:securitygroup/{#securitygroupId} |
| 無 |
請(qǐng)求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 彈性網(wǎng)卡所在地域 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
| NetworkInterfaceName | string | 否 | 彈性網(wǎng)卡的名稱。長(zhǎng)度為 2~128 個(gè)字符，必須以大小寫字母或中文開頭，不能以 默認(rèn)值：空。 | eniTestName |
| NetworkInterfaceId | string | 是 | 彈性網(wǎng)卡 ID。 | eni-bp67acfmxazb4p**** |
| QueueNumber | integer | 否 | 網(wǎng)卡隊(duì)列數(shù)。取值范圍：1~2048。
| 8 |
| Description | string | 否 | 彈性網(wǎng)卡的描述信息。長(zhǎng)度為 2~255 個(gè)英文或中文字符，不能以 http://和 https://開頭。 默認(rèn)值：空。 | testDescription |
| SecurityGroupId | array | 否 | SecurityGroupId 列表，輔助彈性網(wǎng)卡最終加入的安全組，并會(huì)移出已有的安全組。
| |
| string | 否 | SecurityGroupId 列表。
| sg-bp67acfmxazb4p**** | |
| DeleteOnRelease | boolean | 否 | 釋放實(shí)例時(shí)是否保留網(wǎng)卡。取值范圍：
| true |
| RxQueueSize | integer | 否 | 彈性網(wǎng)卡入方向隊(duì)列深度。 您需要注意：
| 8192 |
| TxQueueSize | integer | 否 | 彈性網(wǎng)卡出方向隊(duì)列深度。 您需要注意：
| 8192 |
| NetworkInterfaceTrafficConfig | object | 否 | 彈性網(wǎng)卡通訊參數(shù) | |
| NetworkInterfaceTrafficMode | string | 否 | 網(wǎng)卡的通訊模式。參數(shù)取值范圍：
當(dāng)彈性網(wǎng)卡處于掛載態(tài)時(shí)，您需要注意：
說明
該參數(shù)正在邀測(cè)中，暫未開放使用。
| HighPerformance |
| QueueNumber | integer | 否 | 彈性網(wǎng)卡隊(duì)列數(shù)。 當(dāng)彈性網(wǎng)卡處于掛載態(tài)時(shí)，您需要注意：
說明
該參數(shù)正在邀測(cè)中，暫未開放使用。
| 8 |
| QueuePairNumber | integer | 否 | RDMA 網(wǎng)卡隊(duì)列數(shù)。 當(dāng)彈性網(wǎng)卡處于掛載態(tài)時(shí)，您需要注意：
說明
該參數(shù)正在邀測(cè)中，暫未開放使用。
| 8 |
| RxQueueSize | integer | 否 | 彈性網(wǎng)卡入方向隊(duì)列深度。 您需要注意：
說明
該參數(shù)正在邀測(cè)中，暫未開放使用。
| 8192 |
| TxQueueSize | integer | 否 | 彈性網(wǎng)卡出方向隊(duì)列深度。 您需要注意：
說明
該參數(shù)正在邀測(cè)中，暫未開放使用。
| 8192 |
| ConnectionTrackingConfiguration | object | 否 | 說明
該參數(shù)正在邀測(cè)中，暫未開放使用。
| |
| TcpEstablishedTimeout | integer | 否 | 說明
該參數(shù)正在邀測(cè)中，暫未開放使用。
| 910 |
| TcpClosedAndTimeWaitTimeout | integer | 否 | 說明
該參數(shù)正在邀測(cè)中，暫未開放使用。
| 3 |
| UdpTimeout | integer | 否 | 說明
該參數(shù)正在邀測(cè)中，暫未開放使用。
| 30 |
| EnhancedNetwork | object | 否 | 該參數(shù)暫未開放使用。 | |
| EnableSriov | boolean | 否 | 該參數(shù)暫未開放使用。 | true |
| SourceDestCheck | boolean | 否 | 說明
該參數(shù)正在邀測(cè)中，暫未開放使用。
| false |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}錯(cuò)誤碼
| HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidOperation.NotSupportModifyQueueNumber | %s | - |
| 400 | MissingParameter | %s | 缺失參數(shù)，請(qǐng)檢查參數(shù)是否完整。 |
| 400 | UnsupportedParameter | %s | 不支持參數(shù)。 |
| 400 | InvalidParameter | %s | 無效的參數(shù)。 |
| 400 | InvalidInstanceID.Malformed | %s | 參數(shù) InstanceId 格式錯(cuò)誤。 |
| 400 | InvalidOperation.InvalidEcsState | %s | 實(shí)例當(dāng)前的狀態(tài)不支持此操作。 |
| 400 | InvalidOperation.InvalidEniState | %s | 彈性網(wǎng)卡當(dāng)前的狀態(tài)不支持此操作。 |
| 400 | InvalidOperation.DetachPrimaryEniNotAllowed | %s | 不允許分離實(shí)例的主網(wǎng)卡。 |
| 400 | InvalidParams.EniId | %s | 指定的參數(shù) EniId 無效。 |
| 400 | Forbidden.RegionId | %s | 當(dāng)前地域暫時(shí)沒有提供該服務(wù)。 |
| 400 | JoinedGroupLimitExceed | %s | 指定資源所能加入的安全組數(shù)量達(dá)到上限。具體信息請(qǐng)參見錯(cuò)誤信息%s占位符的實(shí)際返回結(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)卡隊(duì)列深度 |
| 400 | InvalidParameter.EniQueueSize | The specified parameter TxQueueSize and RxQueueSize are not equal or exceed limit. | 出方向和入方向網(wǎng)卡隊(duì)列深度不相等或超出允許的范圍 |
| 400 | InvalidParameter.Conflict | %s | 您輸入的參數(shù)無效，請(qǐng)檢查參數(shù)之間是否沖突。%s為變量，將根據(jù)調(diào)用API的實(shí)際情況動(dòng)態(tài)返回錯(cuò)誤信息。 |
| 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)卡隊(duì)列數(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 隊(duì)列數(shù)超過單張彈性網(wǎng)卡允許的上限 |
| 400 | InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded | The number of RDMA ENIs attached to the ECS instance exceeds the upper limit. | 彈性網(wǎng)卡所在的ECS實(shí)例掛載的 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實(shí)例規(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實(shí)例 RDMA 網(wǎng)卡隊(duì)列數(shù)超出限制。 |
| 400 | InvalidParameter.QueuePairNumberMustEmpty | When the traffic mode is set to Standard, the QueuePairNumber must be empty. | 創(chuàng)建TCP通訊模式的彈性網(wǎng)卡時(shí)，彈性網(wǎng)卡的RDMA模式隊(duì)列數(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)前的賬號(hào)不支持此操作。 |
| 403 | Abs.InvalidAccount.NotFound | %s | 您的阿里云賬號(hào)不存在，或者您的 AccessKey 已經(jīng)過期。 |
| 403 | Forbidden.NotSupportRAM | %s | 暫不支持RAM用戶執(zhí)行該操作。 |
| 403 | Forbidden.SubUser | %s | 您的賬號(hào)沒有操作此資源的權(quán)限，請(qǐng)向主賬號(hào)申請(qǐng)相關(guān)的權(quán)限。 |
| 403 | MaxEniCountExceeded | %s | 已超過可以操作的最大彈性網(wǎng)卡數(shù)。 |
| 403 | EniPerInstanceLimitExceeded | %s | 實(shí)例附加的彈性網(wǎng)卡數(shù)量已經(jīng)達(dá)到了最大限度，不能再為實(shí)例附加彈性網(wǎng)卡。 |
| 403 | InvalidOperation.AvailabilityZoneMismatch | %s | 該操作無效。 |
| 403 | InvalidOperation.VpcMismatch | %s | 您的操作無效，請(qǐng)確認(rèn)該操作中的 VPC 與其它參數(shù)是否匹配。 |
| 403 | SecurityGroupInstanceLimitExceed | %s | 該安全組內(nèi)已有的實(shí)例數(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. | 指定的實(shí)例無法加入不同類型的安全組 |
| 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. | 當(dāng)前 ENI 的狀態(tài)不允許修改該網(wǎng)卡屬性 |
| 403 | InvalidOperation.ResourceManagedByCloudProduct | %s | 云產(chǎn)品托管的安全組不支持修改操作。 |
| 403 | InvalidParameter.InvalidEniQueueNumber | %s | 彈性網(wǎng)卡隊(duì)列數(shù)有誤，具體信息請(qǐng)參見錯(cuò)誤信息%s占位符的實(shí)際返回結(jié)果。 |
| 403 | InvalidOperation.MaxEniQueueNumberExceeded | %s | 彈性網(wǎng)卡隊(duì)列數(shù)超過上限，具體信息請(qǐng)參見錯(cuò)誤信息%s占位符的實(shí)際返回結(jié)果。 |
| 403 | InvalidOperation.ExceedInstanceTypeQueueNumber | %s | 彈性網(wǎng)卡隊(duì)列總數(shù)超過上限，具體信息請(qǐng)參見錯(cuò)誤信息%s占位符的實(shí)際返回結(jié)果。 |
| 403 | AclLimitExceed | %s | 網(wǎng)卡或?qū)嵗陌踩M規(guī)則數(shù)量超過限額值。 |
| 404 | InvalidEcsId.NotFound | %s | 指定的實(shí)例 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. | 指定的安全組在該用戶賬號(hào)下不存在，請(qǐng)您檢查安全組 id 是否正確。 |
| 404 | InvalidParameter.SecurityGroupIdRepeated | The specified security group ids has repeated. | 指定的安全組已重復(fù)添加。請(qǐng)檢查 SecurityGroupIds 參數(shù)值是否正確。 |
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-09-23 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-09-14 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2024-07-03 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
| 2024-07-03 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2024-05-17 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2024-05-07 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2024-01-24 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2023-10-09 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
| 2023-06-14 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |