調(diào)用DeleteNetworkInterface接口，并指定參數(shù)RegionId、NetworkInterfaceId異步刪除一個彈性網(wǎng)卡（ENI）。
接口說明
調(diào)用該接口時，您需要注意：
-
彈性網(wǎng)卡必須處于可用（Available）狀態(tài)。
-
如果彈性網(wǎng)卡已經(jīng)附加到 ECS 實例，必須先從實例分離（ DetachNetworkInterface ），才能刪除彈性網(wǎng)卡。
-
刪除彈性網(wǎng)卡之后：
-
彈性網(wǎng)卡的所有私有地址（包括主私網(wǎng)地址和輔助私網(wǎng)地址）會自動釋放。
-
被刪除的彈性網(wǎng)卡退出所屬的所有安全組。
-
-
本接口為異步接口，調(diào)用成功后，您可以通過查詢彈性網(wǎng)卡狀態(tài)或監(jiān)聽網(wǎng)卡操作事件來感知操作結果， 彈性網(wǎng)卡狀態(tài)機如下圖所示：
- Deleting 說明刪除彈性網(wǎng)卡請求發(fā)送成功，彈性網(wǎng)卡正在刪除中。
- 若無法查詢到彈性網(wǎng)卡，說明彈性網(wǎng)卡刪除成功。
- 若彈性網(wǎng)卡狀態(tài)長時間為 Deleting 說明刪除失敗，此時您可以重新發(fā)起刪除請求彈性網(wǎng)卡操作。
調(diào)用示例詳情參見刪除彈性網(wǎng)卡。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產(chǎn)品自身定義的條件關鍵字。
- 關聯(lián)操作：是指成功執(zhí)行操作所需要的其他權限。操作者必須同時具備關聯(lián)操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯(lián)操作 |
|---|---|---|---|---|
| ecs:DeleteNetworkInterface | delete | *NetworkInterface acs:ecs:{#regionId}:{#accountId}:eni/{#eniId} |
| 無 |
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 所在地域 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
| NetworkInterfaceId | string | 是 | 彈性網(wǎng)卡的 ID。 | eni-bp14v2sdd3v8htln**** |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidOperation.HasSlaveEniBonded | %s | - |
| 400 | MissingParameter | %s | 缺失參數(shù)，請檢查參數(shù)是否完整。 |
| 400 | UnsupportedParameter | %s | 不支持參數(shù)。 |
| 400 | InvalidParameter | %s | 無效的參數(shù)。 |
| 400 | InvalidInstanceID.Malformed | %s | 參數(shù) InstanceId 格式錯誤。 |
| 400 | InvalidOperation.InvalidEcsState | %s | 實例當前的狀態(tài)不支持此操作。 |
| 400 | InvalidOperation.InvalidEniState | %s | 彈性網(wǎng)卡當前的狀態(tài)不支持此操作。 |
| 400 | InvalidOperation.DetachPrimaryEniNotAllowed | %s | 不允許分離實例的主網(wǎng)卡。 |
| 400 | Forbidden.RegionId | %s | 當前地域暫時沒有提供該服務。 |
| 400 | InvalidParams.EniId | %s | 指定的參數(shù) EniId 無效。 |
| 403 | InvalidUserType.NotSupported | %s | 您當前的賬號不支持此操作。 |
| 403 | Abs.InvalidAccount.NotFound | %s | 您的阿里云賬號不存在，或者您的 AccessKey 已經(jīng)過期。 |
| 403 | Forbidden.NotSupportRAM | %s | 暫不支持RAM用戶執(zhí)行該操作。 |
| 403 | Forbidden.SubUser | %s | 您的賬號沒有操作此資源的權限，請向主賬號申請相關的權限。 |
| 403 | MaxEniCountExceeded | %s | 已超過可以操作的最大彈性網(wǎng)卡數(shù)。 |
| 403 | EniPerInstanceLimitExceeded | %s | 實例附加的彈性網(wǎng)卡數(shù)量已經(jīng)達到了最大限度，不能再為實例附加彈性網(wǎng)卡。 |
| 403 | InvalidOperation.AvailabilityZoneMismatch | %s | 該操作無效。 |
| 403 | InvalidOperation.VpcMismatch | %s | 您的操作無效，請確認該操作中的 VPC 與其它參數(shù)是否匹配。 |
| 403 | SecurityGroupInstanceLimitExceed | %s | 該安全組內(nèi)已有的實例數(shù)量已達到最大限制。 |
| 403 | InvalidSecurityGroupId.NotVpc | %s | 參數(shù) SecurityGroupId 無效，該安全組的網(wǎng)絡類型不是專有網(wǎng)絡。 |
| 403 | InvalidOperation.InvalidEniType | %s | 當前彈性網(wǎng)卡的類型不支持此操作。 |
| 403 | InvalidEniId.NotFound | %s | 指定的彈性網(wǎng)卡 ID 不存在。 |
| 403 | InvalidOperation.EniServiceManaged | %s | 操作無效。 |
| 404 | InvalidEcsId.NotFound | %s | 指定的實例 ID 不存在。 |
| 404 | InvalidVSwitchId.NotFound | %s | 指定的交換機不存在。 |
| 404 | InvalidSecurityGroupId.NotFound | %s | 指定的安全組 ID 不存在。 |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | 內(nèi)部錯誤，請重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|---|---|
| 2024-09-12 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |