Menyambungkan elastic network interface (ENI) ke instance Elastic Compute Service (ECS) yang berada dalam virtual private cloud (VPC).
Description
Saat memanggil operasi ini, perhatikan hal-hal berikut:
- ENI harus berada dalam status Available (
Available). Setiap ENI hanya dapat disambungkan ke satu instance yang berada dalam zona dan VPC yang sama dengan ENI tersebut. - Instance harus berada dalam status Running (Running) atau Stopped (Stopped). Saat menyambungkan ENI ke instance dengan tipe instans tertentu, pastikan instance berada dalam status Stopped (Stopped). Untuk informasi selengkapnya, lihat bagian "Tipe instans ECS yang harus berada dalam status Stopped (Stopped)" di Bind an ENI.Catatan Jika waktu mulai terakhir instance (termasuk waktu mulai instance saat pembelian baru, waktu restart terakhir instance, dan waktu reaktivasi terakhir instance) sebelum 1 April 2018 dan instance tetap dalam status Running, Anda harus memanggil operasi RebootInstance untuk me-restart instance tersebut. Jika tidak, ENI tidak dapat disambungkan ke instance tersebut.
- Anda dapat menyambungkan beberapa ENI ke satu instance. Untuk informasi selengkapnya, lihat ENI overview.
- vSwitch tempat ENI terhubung harus berada dalam zona dan VPC yang sama dengan vSwitch tempat instance terhubung.
- Operasi ini merupakan operasi asinkron. Setelah operasi ini dipanggil untuk menyambungkan ENI, Anda dapat memeriksa status atau event ENI untuk menentukan apakah ENI telah berhasil disambungkan. Gambar berikut menunjukkan transisi antar status ENI.
- Jika ENI memasuki status Attaching, operasi berhasil dipanggil dan ENI sedang dalam proses disambungkan ke instance.
- Jika ENI memasuki status InUse, ENI telah berhasil disambungkan ke instance.
- Jika ENI kembali ke status Available, proses penyambungan ENI ke instance gagal.
Untuk informasi contoh cara memanggil operasi ini, lihat Attach an ENI to an ECS instance.
Debugging
Request parameters
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | AttachNetworkInterface | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke AttachNetworkInterface. |
| RegionId | String | Yes | cn-hangzhou | ID wilayah instance. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru. |
| NetworkInterfaceId | String | Yes | eni-bp17pdijfczax1huji**** | ID ENI. |
| InstanceId | String | Yes | i-bp16qstyvxj9gpqw**** | ID instance. |
| TrunkNetworkInstanceId | String | No | eni-f8zapqwj1v1j4ia3**** | ID trunk ENI. Catatan Parameter ini tidak tersedia untuk digunakan. |
| WaitForNetworkConfigurationReady | Boolean | No | null | Catatan Parameter ini tidak lagi digunakan. |
| NetworkCardIndex | Integer | No | 0 | Indeks network interface controller (NIC). Catatan Nilai NetworkCardIndex bervariasi tergantung pada tipe instans. Jika tipe instans tidak mendukung NIC, Anda tidak dapat menentukan parameter ini. Jika tipe instans mendukung NIC, Anda dapat menentukan parameter ini. Untuk informasi mengenai nilai NetworkCardIndex, lihat Instance families. |
Response parameters
| Parameter | Type | Example | Description |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E | ID permintaan. |
Examples
Contoh permintaan
http(s)://ecs.aliyuncs.com/?Action=AttachNetworkInterface
&RegionId=cn-hangzhou
&NetworkInterfaceId=eni-bp17pdijfczax1huji****
&InstanceId=i-bp16qstyvxj9gpqw****
&WaitForNetworkConfigurationReady=false
&Common request parametersContoh respons sukses
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<AttachNetworkInterfaceResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</AttachNetworkInterfaceResponse>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 dilepas dari instance. |
| 400 | Forbidden.RegionId | %s | Pesan kesalahan yang dikembalikan karena layanan ini saat ini tidak tersedia di wilayah yang ditentukan. |
| 400 | InvalidOperation.InvalidGeneration | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak valid. |
| 400 | InvalidParams.EniId | %s | Pesan kesalahan yang dikembalikan karena parameter NetworkInterfaceId yang ditentukan tidak valid. |
| 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 disambungkan 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 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 | InvalidInstanceId.NotFound | %s | Pesan kesalahan yang dikembalikan karena parameter InstanceId yang ditentukan tidak ada. |
| 403 | InvalidEni.NotSameVpc | %s | Pesan kesalahan yang dikembalikan karena resource yang ditentukan dan ENI yang ditentukan tidak berada dalam VPC yang sama. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan. |
| 403 | InvalidOperation.Ipv4CountExceeded | %s | Pesan kesalahan yang dikembalikan karena jumlah maksimum alamat IPv4 telah tercapai. |
| 403 | InvalidOperation.EniServiceManaged | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak valid. |
| 403 | InvalidOperation.Ipv6NotSupport | %s | Pesan kesalahan yang dikembalikan karena alamat IPv6 tidak mendukung operasi ini. |
| 403 | InvalidOperation.HotPlugNotSupport | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat resource yang ditentukan sedang berjalan. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan. |
| 403 | InvalidOperation.InvalidTrunkEniStatus | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung saat ENI dalam mode trunk berada dalam status saat ini. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan. |
| 403 | InvalidOperation.InstanceTypeNotSupportEniTrunking | %s | Pesan kesalahan yang dikembalikan karena operasi ini tidak didukung. Untuk informasi selengkapnya, 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 selengkapnya, 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 selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan. |
| 403 | InvalidParameter.EniNotBelongEcs | %s | Pesan kesalahan yang dikembalikan karena ENI yang ditentukan tidak disambungkan ke instance ECS yang ditentukan. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan. Anda dapat memanggil operasi DescribeInstances untuk mengambil ID ENI yang disambungkan ke instance ECS yang ditentukan. |
| 403 | InvalidParameter.InvalidEniQueueNumber | %s | Pesan kesalahan yang dikembalikan karena jumlah antrian per ENI yang ditentukan tidak valid. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan. |
| 403 | InvalidOperation.MaxEniQueueNumberExceeded | %s | Pesan kesalahan yang dikembalikan karena jumlah maksimum antrian per ENI telah tercapai. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan. |
| 403 | InvalidOperation.ExceedInstanceTypeQueueNumber | %s | Pesan kesalahan yang dikembalikan karena jumlah maksimum antrian untuk semua ENI pada sebuah instance telah tercapai. Untuk informasi selengkapnya, lihat nilai kembali placeholder %s dalam pesan kesalahan. |
| 404 | InvalidEcsId.NotFound | %s | Pesan kesalahan yang dikembalikan karena parameter InstanceId yang ditentukan tidak ada. |
| 404 | InvalidEniId.NotFound | %s | Pesan kesalahan yang dikembalikan karena parameter NetworkInterfaceId 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, kunjungi API Error Center.