Lepaskan elastic network interface (ENI) dari instance Elastic Compute Service (ECS).
Description
Saat memanggil operasi ini, perhatikan hal-hal berikut:
- ENI primer tidak dapat dilepaskan dari instance ECS.
- ENI harus berada dalam status Detaching atau InUse.
- Instance harus berada dalam status Running atau Stopped.
- Operasi ini merupakan operasi asinkron. Setelah permintaan pelepasan ENI dikirim, Anda dapat memeriksa status atau event ENI untuk mengetahui apakah pelepasan telah berhasil. Gambar berikut menunjukkan transisi status ENI.
- Jika ENI berada dalam status Detaching, permintaan pelepasan telah dikirim dan ENI sedang dalam proses dilepaskan dari instance terkait.
- Jika ENI berada dalam status Available, ENI telah berhasil dilepaskan dari instance terkait.
- Jika ENI terjebak dalam status Detaching, pelepasan mungkin gagal karena alasan tertentu—misalnya, sistem operasi tidak merespons permintaan pelepasan. Dalam hal ini, kirim ulang permintaan pelepasan ENI. Jika masalah tetap berlanjut, restart instance tersebut.
Untuk contoh cara memanggil operasi ini, lihat Detach an ENI.
Debugging
Request parameters
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | DetachNetworkInterface | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DetachNetworkInterface. |
| RegionId | String | Yes | cn-hangzhou | ID wilayah dari ENI. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru. |
| NetworkInterfaceId | String | Yes | eni-bp67acfmxazb4p**** | ID ENI. |
| InstanceId | String | Yes | i-bp67acfmxazb4p**** | ID instance |
| TrunkNetworkInstanceId | String | No | eni-f8zapqwj1v1j4ia3**** | ID trunk ENI. Catatan Parameter ini tidak tersedia untuk digunakan. |
Response parameters
| Parameter | Type | Example | Description |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E | ID permintaan. |
Examples
Contoh permintaan
https://ecs.aliyuncs.com/?Action=DetachNetworkInterface
&InstanceId=i-bp67acfmxazb4p****
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&<Common request parameters>Contoh respons sukses
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<DetachNetworkInterfaceResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</DetachNetworkInterfaceResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}Error codes
| HTTP status code | Error code | Error message | Description |
| 400 | MissingParameter | %s | Pesan kesalahan yang dikembalikan karena parameter yang diperlukan tidak ditentukan. |
| 400 | UnsupportedParameter | %s | Pesan kesalahan yang dikembalikan karena parameter yang ditentukan tidak didukung. |
| 400 | InvalidParameter | %s | Pesan kesalahan yang dikembalikan karena parameter yang ditentukan tidak valid. |
| 400 | InvalidInstanceID.Malformed | %s | Pesan kesalahan yang dikembalikan karena parameter InstanceId yang ditentukan tidak valid. |
| 400 | InvalidOperation.InvalidRegion | %s | Pesan kesalahan yang dikembalikan karena parameter RegionId yang ditentukan tidak valid. |
| 400 | InvalidOperation.InvalidEcsState | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat instance berada dalam status saat ini. |
| 400 | InvalidOperation.InvalidEniState | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat ENI berada dalam status saat ini. |
| 400 | InvalidOperation.DetachPrimaryEniNotAllowed | %s | Pesan kesalahan yang dikembalikan karena ENI primer tidak dapat dilepaskan dari instance. |
| 400 | Forbidden.RegionId | %s | Pesan kesalahan yang dikembalikan karena layanan tidak tersedia di wilayah saat ini. |
| 400 | InvalidParams.EniId | %s | Pesan kesalahan yang dikembalikan karena parameter NetworkInterfaceId yang ditentukan tidak valid. |
| 400 | InvalidParameter.EniNotBelongEcs | %s | Pesan kesalahan yang dikembalikan karena ENI yang ditentukan tidak terhubung ke instance ECS yang ditentukan. Untuk informasi lebih lanjut, lihat nilai kembali placeholder %s dalam pesan kesalahan. Anda dapat memanggil operasi DescribeInstances untuk mengambil ID ENI yang terhubung ke instance ECS yang ditentukan. |
| 403 | InvalidUserType.NotSupported | %s | Pesan kesalahan yang dikembalikan karena akun Anda tidak mendukung operasi ini. |
| 403 | Abs.InvalidAccount.NotFound | %s | Pesan kesalahan yang dikembalikan karena akun Alibaba Cloud Anda tidak ada atau pasangan Kunci Akses Anda telah kedaluwarsa. |
| 403 | Forbidden.NotSupportRAM | %s | Pesan kesalahan yang dikembalikan karena pengguna Resource Access Management (RAM) tidak memiliki otorisasi untuk melakukan operasi ini. |
| 403 | Forbidden.SubUser | %s | Pesan kesalahan yang dikembalikan karena Anda tidak memiliki otorisasi untuk mengelola resource ini. Hubungi pemilik akun Alibaba Cloud untuk mendapatkan otorisasi. |
| 403 | MaxEniCountExceeded | %s | Pesan kesalahan yang dikembalikan karena jumlah maksimum ENI yang dapat dikelola telah tercapai. |
| 403 | EniPerInstanceLimitExceeded | %s | Pesan kesalahan yang dikembalikan karena jumlah maksimum ENI yang dapat terhubung ke instance yang ditentukan telah tercapai. |
| 403 | InvalidOperation.AvailabilityZoneMismatch | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak valid. |
| 403 | InvalidOperation.VpcMismatch | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak valid. Periksa apakah virtual private cloud (VPC) dalam operasi sesuai dengan parameter lainnya. |
| 403 | SecurityGroupInstanceLimitExceed | %s | Pesan kesalahan yang dikembalikan karena jumlah maksimum instance dalam security group telah tercapai. |
| 403 | InvalidSecurityGroupId.NotVpc | %s | Pesan kesalahan yang dikembalikan karena ID security group yang ditentukan tidak valid dan jenis jaringan security group bukan VPC. |
| 403 | InvalidOperation.InvalidEniType | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat ENI berada dalam tipe saat ini. |
| 403 | InvalidOperation.EniServiceManaged | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak valid. |
| 403 | InvalidOperation.EniLinked | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat ENI instance terkait dengan ENI lainnya. Anda harus memutuskan hubungan ENI dari ENI lain sebelum melepaskannya dari instance. |
| 403 | InvalidInstanceId.NotFound | %s | Pesan kesalahan yang dikembalikan karena parameter InstanceId yang ditentukan tidak ada. |
| 403 | InvalidOperation.HotPlugNotSupport | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat resource yang ditentukan sedang berjalan. Untuk informasi lebih lanjut, lihat nilai kembali placeholder %s dalam pesan kesalahan. |
| 403 | InvalidOperation.InvalidTrunkEniStatus | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat ENI yang ditentukan dalam mode trunk berada dalam status saat ini. Untuk informasi lebih lanjut, lihat nilai kembali placeholder %s dalam pesan kesalahan. |
| 403 | InvalidOperation.InstanceTypeNotSupportEniTrunking | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung. Untuk informasi lebih lanjut, lihat nilai kembali placeholder %s dalam pesan kesalahan. |
| 403 | InvalidParameter.EniNotBelongTrunk | %s | Pesan kesalahan yang dikembalikan karena ENI yang ditentukan tidak dalam mode trunk. Untuk informasi lebih lanjut, lihat nilai kembali placeholder %s dalam pesan kesalahan. |
| 403 | InvalidOperation.EniTypeNotSupportTrunking | %s | Pesan kesalahan yang dikembalikan karena operasi terkait mode trunk tidak didukung saat ENI berada dalam tipe saat ini. Untuk informasi lebih lanjut, lihat nilai kembali placeholder %s dalam pesan kesalahan. |
| 403 | InvalidOperation.HasMemberEniAttached | %s | Pesan kesalahan yang dikembalikan karena ENI lain terhubung ke ENI yang beroperasi dalam mode trunk. Untuk informasi lebih lanjut, lihat nilai kembali placeholder %s dalam pesan kesalahan. |
| 404 | InvalidEcsId.NotFound | %s | Pesan kesalahan yang dikembalikan karena ID instance yang ditentukan tidak ada. |
| 404 | InvalidEniId.NotFound | %s | Pesan kesalahan yang dikembalikan karena ID ENI yang ditentukan tidak ada. |
| 404 | InvalidVSwitchId.NotFound | %s | Pesan kesalahan yang dikembalikan karena vSwitch yang ditentukan tidak ada. |
| 404 | InvalidSecurityGroupId.NotFound | %s | Pesan kesalahan yang dikembalikan karena ID security group yang ditentukan tidak ada. |
Untuk daftar kode kesalahan, lihat Service error codes.