All Products
Search

This Product

    Elastic Compute Service:Mengubah VPC untuk instance ECS

    Document Center

    Elastic Compute Service:Mengubah VPC untuk instance ECS

    Last Updated:Sep 05, 2026

    Migrasikan instance ECS ke VPC yang berbeda dalam wilayah dan zona yang sama untuk isolasi jaringan, redesain arsitektur, atau penyelesaian konflik IP.

    Penting

    Mengubah VPC untuk instance ECS menyebabkan gangguan layanan sementara. Lakukan operasi ini selama jam sepi. Sebelum memulai, buat snapshot untuk mencadangkan data Anda.

    Dampak potensial

    • Gangguan layanan: Operasi ini mengharuskan instance berada dalam status Stopped, yang mengganggu layanan.

    • Perubahan alamat IP pribadi:

      • Alamat IP pribadi utama berubah menjadi alamat baru dari blok CIDR vSwitch tujuan. Anda dapat menentukan alamat tersebut atau membiarkan sistem menetapkannya. Aplikasi yang menggunakan IP asli secara hard-coded, seperti string koneksi database, daftar putih firewall, atau konfigurasi layanan lainnya, akan gagal. Perbarui konfigurasi tersebut setelah mengubah VPC.

      • Alamat IP publik tetap tidak berubah.

    • Kehilangan koneksi jaringan: Instance kehilangan konektivitas jaringan pribadi ke semua resource di VPC asal, seperti instance RDS, instance SLB, dan instance ECS lainnya.

    • Konfigurasi jaringan sistem operasi: Jika OS menggunakan alamat IP statis, pengaturan jaringannya (alamat IP, gateway) tidak akan sesuai dengan lingkungan baru setelah perubahan VPC, sehingga mencegah komunikasi jaringan dan koneksi jarak jauh.

    Prosedur

    Langkah 1: Persiapan

    1. Buat cadangan snapshot: Buat snapshot dari disk sistem dan disk data instance untuk pencadangan dan rollback.

    2. Hentikan instance

      Instance harus berada dalam status Stopped. Status di console tidak boleh Locked. Jika instance sedang berjalan, hentikan instance tersebut.

    3. Lakukan pemeriksaan prasyarat:

      • ENI sekunder: Lepaskan semua ENI sekunder dari instance.

      • Beberapa alamat IP: Batalkan penugasan alamat IP pribadi sekunder dan hapus alamat IPv6 dari ENI primer.

      • Server Load Balancer (SLB): Hapus instance dari grup server backend SLB mana pun.

      • Entri rute kustom: Hapus semua rute kustom yang menggunakan instance sebagai lompatan berikutnya.

      • Alamat IP virtual ketersediaan tinggi (HaVip): Putuskan asosiasi instance dari HaVip mana pun.

      • Global Accelerator (GA): Hapus titik akhir yang berisi instance dari instance GA mana pun.

      • (Opsional) Metode perolehan alamat IP: Jika OS instance menggunakan konfigurasi IP statis, alihkan ke DHCP sebelum mengubah VPC agar OS secara otomatis mengambil alamat IP baru, subnet mask, dan gateway.

        Linux

        Lihat Konfigurasikan DHCP untuk image Linux.

        Windows

        Langkah-langkah berikut menggunakan Windows Server 2022 sebagai contoh:

        1. Sambungkan ke instance Windows.

          Untuk petunjuknya, lihat Sambungkan ke instance Windows menggunakan Workbench.

        2. Buka Network and Sharing Center.

        3. Klik change adapter settings.

        4. Klik ganda antarmuka jaringan primer, Ethernet. Di kotak dialog Ethernet Status, klik Type.

          Buka Control Panel > Network and Internet > Network Connections.

        5. Di kotak dialog Ethernet Properties, klik ganda Internet Protocol Version 4 (TCP/IPv4).

        6. Di kotak dialog Internet Protocol Version 4 (TCP/IPv4) Properties, pilih Obtain An IP Address Automatically.

    4. Persiapkan resource jaringan tujuan:

      • VPC dan vSwitch: Pastikan VPC dan vSwitch tersedia di zona yang sama dengan instance.

      • Security group: Siapkan security group di VPC tujuan. Anda dapat mengkloning security group untuk menyalin aturan yang ada.

    Langkah 2: Mengubah VPC

    Console

    1. Buka ECS console. Pilih kelompok sumber daya dan wilayah instance.

    2. Di halaman Instances, klik ID instance untuk membuka halaman detailnya. Pilih All Operations > Change VPC.

    3. Ubah VPC:

      1. Preparation: Tinjau informasi jaringan dan catatan.

      2. VPC: Tetapkan Destination VPC, Destination vSwitch, dan Destination Security Group.

        Anda dapat memilih satu hingga lima security group tujuan. Security group yang dipilih harus memiliki tipe yang sama: semuanya kelompok keamanan dasar atau semuanya kelompok keamanan enterprise.

      3. (Opsional) Configure Primary Private IP: Tentukan alamat IP pribadi utama dalam blok CIDR vSwitch tujuan. Jika dibiarkan kosong, sistem akan menetapkannya secara otomatis.

    4. Verifikasi hasilnya:

      Di halaman Instance Details, periksa VPC dan vSwitch baru di bagian Configuration Information.

      Setelah VPC diubah, instance tidak akan otomatis menyala. Anda harus secara manual menjalankan instance.

    API

    Panggil ModifyInstanceVpcAttribute untuk mengubah VPC.

    Panggil DescribeInstances untuk memverifikasi VPC, vSwitch, dan security group baru.

    Instance tidak akan otomatis menyala setelah perubahan VPC. Panggil StartInstance untuk menjalankannya.

    FAQ

    • Bagaimana cara mengubah VPC untuk beberapa instance ECS sekaligus?

      Lihat Lakukan operasi batch di halaman Instances. Anda dapat mengubah VPC hingga 20 instance sekaligus.

    • Bagaimana cara mengonversi blok CIDR menjadi rentang alamat IP?

      Lihat Contoh konversi blok CIDR menjadi rentang alamat IP. Anda juga dapat menggunakan antarmuka baris perintah ipcalc pada instance di vSwitch tujuan untuk melihat rentang alamat IP dari suatu blok CIDR.

    • Bagaimana cara berlangganan notifikasi event untuk hasil operasi perubahan VPC?

    • Bagaimana cara menyelesaikan error InvalidDependence.GrantAccess?

      Penyebab: Instance terkait dengan layanan cloud lain yang memiliki tautan otorisasi balik.

      Solusi: Lepaskan tautan otorisasi balik tersebut. Hapus otorisasi untuk produk lain dan coba lagi.

      Jika tautan pribadi dibuat melalui Workbench, lepaskan sebagai berikut:

      1. Login ke Workbench console. Di halaman Private Links, periksa apakah ada tautan otorisasi balik. Jika ada, klik Release Link.

      2. Klik OK untuk melepaskan tautan, lalu coba ubah VPC lagi.

    • Bagaimana cara menyelesaikan error InvalidDependence.NextHopOfCustomRouter?

      Penyebab: Instance merupakan lompatan berikutnya dalam entri tabel rute kustom.

      Solusi: Hapus entri rute yang menggunakan instance sebagai lompatan berikutnya:

      1. Login ke Route Table console. Pilih wilayah VPC asal instance.

      2. Di halaman Route Tables, temukan rute yang menggunakan instance sebagai lompatan berikutnya. Klik Delete untuk menghapusnya, lalu coba ubah VPC lagi.

    • Bagaimana cara menyelesaikan error InvalidDependence.SLB?

      Di langkah 4 Verify the results pada bagian Change the VPC, muncul pesan error InvalidDependence.SLB, yang menyatakan bahwa operasi ditolak karena instance terikat ke instance ALB (Application Load Balancer) atau CLB (Classic Load Balancer).

      Penyebab: Instance berada dalam grup server SLB, meskipun tidak aktif melayani trafik.

      Solusi: Hapus instance dari grup server backend SLB, lalu coba lagi. Lihat Buat dan kelola grup server.

    • Bagaimana cara menyelesaikan error EnterpriseGroupLimited.MutliGroupType?

      Penyebab: Security group yang dipilih memiliki tipe yang tidak konsisten. Semua grup yang dipilih harus berupa kelompok keamanan dasar atau semuanya kelompok keamanan enterprise.

      Solusi: Pilih security group dengan tipe yang sama.

    • Bagaimana cara menyelesaikan error Invalidinstance.AttachedEni?

      Penyebab: Instance memiliki ENI sekunder yang terpasang.

      Solusi: Lepaskan semua ENI sekunder dari instance.

    • Bagaimana cara menyelesaikan error PrimaryEniHasSubIp?

      Penyebab: ENI primer memiliki alamat IP pribadi sekunder yang ditetapkan.

      Solusi: Batalkan penugasan alamat IP pribadi sekunder dari instance.

    Referensi