調用DetachNetworkInterface從一臺ECS實例上分離一個彈性網卡（ENI）。
接口說明
調用該接口時，您需要注意：
-
不允許分離實例主網卡。
-
彈性網卡必須處于分離中（Detaching）或者已附加（InUse）狀態。
-
實例必須處于運行中（Running）或者已停止（Stopped）狀態。
-
本接口為異步接口，調用成功后，您可以通過查詢彈性網卡狀態或監聽網卡操作事件來感知操作結果， 彈性網卡狀態機如下圖所示：
-
Detaching 狀態說明分離彈性網卡請求發送成功，彈性網卡正在從 ECS 實例分離。
-
Available 狀態說明彈性網卡從 ECS 實例分離成功。
-
若彈性網卡長時間為 Detaching 狀態，可能是因為實例內部的操作系統不響應網卡的分離請求等原因導致了分離失敗。此時，您可以對該彈性網卡重新發起分離請求，若長時間不成功的話，可以嘗試重啟實例后重試。
-
調用示例詳情參見分離彈性網卡。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| ecs:DetachNetworkInterface | update | *NetworkInterface acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}*Instance acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId} |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 資源所屬地域。您可以調用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
| NetworkInterfaceId | string | 是 | 彈性網卡 ID。 | eni-bp67acfmxazb4p**** |
| InstanceId | string | 是 | 實例 ID。 | i-bp67acfmxazb4p**** |
| TrunkNetworkInstanceId | string | 否 | 中繼網卡 ID。 說明
該參數暫未上線，不支持使用。
| eni-f8zapqwj1v1j4ia3**** |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | MissingParameter | %s | 缺失參數，請檢查參數是否完整。 |
| 400 | UnsupportedParameter | %s | 不支持參數。 |
| 400 | InvalidParameter | %s | 無效的參數。 |
| 400 | InvalidInstanceID.Malformed | %s | 參數 InstanceId 格式錯誤。 |
| 400 | InvalidOperation.InvalidRegion | %s | 指定的參數 RegionId 無效。 |
| 400 | InvalidOperation.InvalidEcsState | %s | 實例當前的狀態不支持此操作。 |
| 400 | InvalidOperation.InvalidEniState | %s | 彈性網卡當前的狀態不支持此操作。 |
| 400 | InvalidOperation.DetachPrimaryEniNotAllowed | %s | 不允許分離實例的主網卡。 |
| 400 | Forbidden.RegionId | %s | 當前地域暫時沒有提供該服務。 |
| 400 | InvalidParams.EniId | %s | 指定的參數 EniId 無效。 |
| 400 | InvalidParameter.EniNotBelongEcs | %s | 指定的ENI不屬于指定的ECS實例，具體信息請參見錯誤信息%s占位符的實際返回結果。您可以調用DescribeInstances查看指定ECS實例已附加的ENI ID。 |
| 400 | InvalidOperation.EniHotPlugNotSupported | The ENI with high-performance traffic mode cannot be hot-plugged. Please stop the ECS instance to which the ENI is attached, and try again. | 開啟了高性能通訊模式的彈性網卡不支持熱拔出，請將該彈性網卡所掛載的ECS實例停機后重試。 |
| 400 | InvalidOperation.InvalidEcsState | %s. | 實例當前的狀態不支持此操作。 |
| 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.EniLinked | %s | 實例的當前彈性網卡關聯了其他彈性網卡，導致操作無效。需要解除關聯后才能從實例分離。 |
| 403 | InvalidInstanceId.NotFound | %s | 指定的實例不存在，請確認參數 InstanceId 是否正確。 |
| 403 | InvalidOperation.HotPlugNotSupport | %s | 指定的資源處于運行狀態，不支持本次操作，具體信息請參見錯誤信息%s占位符的實際返回結果。 |
| 403 | InvalidOperation.InvalidTrunkEniStatus | %s | 指定的中繼模式的ENI狀態不允許執行本次操作，具體信息請參見錯誤信息%s占位符的實際返回結果。 |
| 403 | InvalidOperation.TrunkingIsNotAllowed | %s | - |
| 403 | InvalidOperation.InstanceTypeNotSupportEniTrunking | %s | 不支持本次操作。具體信息請參見錯誤信息%s占位符的實際返回值。 |
| 403 | InvalidParameter.EniNotBelongTrunk | %s | 指定的ENI不屬于中繼模式的ENI，具體信息請參見錯誤信息%s占位符的實際返回結果。 |
| 403 | InvalidOperation.EniTypeNotSupportTrunking | %s | ENI的類型不支持中繼模式的相關操作，具體信息請參見錯誤信息%s占位符的實際返回結果。 |
| 403 | InvalidOperation.HasMemberEniAttached | %s | 指定的中繼模式的ENI附加了其它ENI，具體信息請參見錯誤信息%s占位符的實際返回結果。 |
| 404 | InvalidEcsId.NotFound | %s | 指定的實例 ID 不存在。 |
| 404 | InvalidEniId.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. | 內部錯誤，請重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-09-24 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-11-15 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |