Mengganti nama VM

Saat membuat instance virtual machine (VM), Anda harus menentukan nama. Setelah membuat VM, Anda dapat mengganti namanya secara opsional. Mengubah nama VM mungkin berguna dalam skenario berikut:

  • Untuk merepresentasikan workload yang berjalan di VM dengan lebih baik.
  • Untuk merujuk pada sistem operasi yang berjalan di VM.
  • Untuk mematuhi konvensi penamaan yang diwajibkan oleh organisasi Anda.

Uniform Resource Identifier (URI) VM

Mengubah nama VM dapat memengaruhi project Anda. Daripada merujuk resource VM berdasarkan namanya, Anda dapat merujuk resource tersebut berdasarkan URI-nya, yang bersifat permanen. URI memiliki format berikut:

projects/PROJECT_ID/zones/ZONE/instances/VM_ID

URI menyertakan nilai-nilai berikut:

  • PROJECT_ID: ID project tempat VM berada.

  • ZONE: zona tempat VM berada.

  • VM_ID: ID VM yang ada. Untuk melihat ID VM yang ada, lihat detail VM, kemudian lihat nilai kolom id.

Harga

Mengganti nama VM tidak mengubah jumlah penagihan Anda. Selain itu, karena tagihan Anda menampilkan VM sesuai dengan unit penyimpanan persediaan (SKU) dan bukan namanya, Anda tidak akan melihat nama VM Anda di tagihan.

Batasan

Batasan terkait hal berikut berlaku saat mengganti nama VM:

  • Resource yang diberi nama secara otomatis:

    • Saat Anda mengganti nama VM, nama resource apa pun yang didasarkan pada nama VM asli tidak akan diperbarui. Misalnya, saat Anda membuat VM, nama boot disk sama dengan nama VM. Jika Anda mengganti nama VM, nama boot disk tidak akan berubah.

  • Server DHCP:

    • Setelah mengganti nama VM, server DHCP akan merespons permintaan DHCP dengan nama host yang diperbarui dengan format HOSTNAME.c.PROJECT_ID.internal untuk DNS global dan HOSTNAME.ZONE.c.PROJECT_ID.internal untuk DNS zona. Untuk mengetahui informasi selengkapnya, lihat Jenis nama DNS internal.

  • Konsol Google Cloud:

    • Anda harus merefresh browser untuk Konsol Google Cloud guna memperbarui nama VM.

  • Nama host:

    • Nama host diubah saat Anda mengubah nama instance. Di Windows, pembaruan nama host mungkin perlu reboot.

    • VM yang memiliki nama host kustom tidak akan diperbarui.

    • Mengubah nama host secara langsung di host tidak akan memengaruhi nama resource VM.

  • Grup instance terkelola:

    • Anda tidak dapat mengganti nama instance yang ada dalam grup instance terkelola (MIG) karena instance ini secara otomatis dan tanpa dapat dipulihkan mewarisi namanya dari properti base instance name pada MIG stateless-nya.

  • Konvensi penamaan:

    • Anda tidak dapat mengganti nama VM dengan nama yang sudah digunakan oleh VM lain dalam project.

    • Nama VM harus mematuhi konvensi penamaan resource.

  • Status VM:

    • Hentikan instance sebelum mengganti namanya karena Anda hanya dapat mengganti nama VM yang memiliki status TERMINATED. Anda tidak dapat, misalnya, mengganti nama VM yang memiliki status SUSPENDED.

Sebelum memulai

  • Tinjau, dan jika perlu, perbarui hal berikut:
    • Grup, chart, dan pemberitahuan Cloud Monitoring: Monitoring mencocokkan string, dan saat Anda mengganti nama VM, string ini tidak akan diperbarui. Jika Anda mengganti nama VM, perbarui aturan Monitoring Anda agar menyertakan VM yang sudah diganti namanya tersebut dalam laporan Anda.
    • URL Konsol: Mengganti nama VM akan mengubah URL konsolnya. Jika mengganti nama VM, Anda harus memperbarui link, seperti bookmark browser yang merujuk ke URL konsol VM.
    • Binding peran bersyarat Identity and Access Management (IAM): Binding peran bersyarat mendukung pemberian izin atas nama resource. Misalnya, IAM mungkin memberikan peran kepada pengguna jika nama VM diawali dengan string tertentu. Binding ini tidak diperbarui saat Anda mengubah nama VM, sehingga akses pengguna ke resource VM mungkin terpengaruh karena Anda mengubah kumpulan VM yang menggunakan nama awalan tersebut. Jika Anda mengganti nama VM, perbarui binding ini.
    • Cache layanan DNS internal: Layanan DNS internal menetapkan nama DNS internal ke VM, dengan nama host berformat HOSTNAME.c.PROJECT_ID.internal untuk DNS global dan HOSTNAME.ZONE.c.PROJECT_ID.internal untuk DNS zona. Setelah mengganti nama VM, nama host ini akan berubah. Kemudian, layanan DNS internal mulai me-resolve ke nama host baru, dan permintaan ke nama DNS sebelumnya gagal. Jika mengganti nama VM, Anda mungkin perlu memperbarui cache DNS agar dapat memperbarui nama host. Untuk mengetahui informasi selengkapnya tentang nama host DNS global dan DNS zona, lihat Jenis nama DNS internal.
    • Kueri metadata: Setelah mengganti nama VM, server metadata akan melaporkan nama baru tersebut. Jika Anda mengganti nama VM, perbarui skrip atau program apa pun yang membuat kueri server metadata agar mengkueri nama baru VM.
    • Kebijakan organisasi yang membatasi alamat IP eksternal: Batasan terhadap VM yang memiliki alamat IP eksternal merujuk pada nama VM. Saat Anda mengganti nama VM, batasan ini tidak akan diperbarui. Jika Anda mengganti nama VM, perbarui kebijakan organisasi IP eksternal dengan nama baru VM.
    • Nama host SQL Server: Jika mengganti nama VM yang menghosting SQL Server, Anda harus memperbarui nama VM server SQL. Untuk mengetahui informasi selengkapnya, lihat Mengganti nama komputer yang menghosting instance SQL Server mandiri.
  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses verifikasi identitas Anda untuk mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Untuk informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengganti nama VM, minta administrator untuk memberi Anda peran IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin compute.instances.setName, yang diperlukan untuk mengganti nama VM.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Mengganti nama VM

Anda hanya dapat mengganti nama VM yang dihentikan dan memiliki status TERMINATED.

Konsol

Untuk mengganti nama VM, lakukan langkah berikut:

  1. Di konsol Google Cloud, buka halaman Instance VM.

    Buka halaman VM instances

  2. Di kolom Nama, klik nama VM.

  3. Jika Anda belum melakukannya, hentikan VM dengan melakukan hal berikut:

    1. Klik Hentikan.

    2. Untuk mengonfirmasi, klik Berhenti.

      Penghentian VM dapat memerlukan waktu hingga 90 detik untuk diselesaikan.

  4. Klik Edit.

  5. Di kolom VM instance name, masukkan nama baru untuk VM.

  6. Klik Simpan.

    Proses penggantian nama VM dapat memerlukan waktu hingga satu menit. Jika setelah mengganti nama VM, Anda mendapatkan error bahwa Google Cloud tidak dapat menemukan VM, refresh browser Anda.

  7. Jika perlu, mulai ulang VM dengan mengklik Start / Resume.

gcloud

Untuk mengganti nama VM, lakukan langkah berikut:

  1. Jika Anda belum melakukannya, hentikan VM.

  2. Untuk mengganti nama VM, gunakan perintah gcloud compute instances set-name.

    gcloud compute instances set-name VM_NAME \
    --new-name=NEW_VM_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

    Ganti kode berikut:

    • VM_NAME: nama VM yang ada.

    • NEW_VM_NAME: nama baru untuk VM yang ditentukan.

    • PROJECT_ID: ID project tempat VM berada.

    • ZONE: zona tempat VM berada.

    Proses penggantian nama VM dapat memerlukan waktu hingga satu menit.

  3. Jika perlu, mulai ulang VM.

REST

Untuk mengganti nama VM, lakukan langkah berikut:

  1. Jika Anda belum melakukannya, hentikan VM.

  2. Untuk mengganti nama VM, buat permintaan POST ke metode instances.setName.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setName

{
  "currentName": "VM_NAME",
  "name": "NEW_VM_NAME"
}

    Ganti kode berikut:

    • PROJECT_ID: ID project tempat VM berada.

    • ZONE: zona tempat VM berada.

    • VM_NAME: nama VM yang ada.

    • NEW_VM_NAME: nama baru untuk VM yang ditentukan.

    Proses penggantian nama VM dapat memerlukan waktu hingga satu menit. Untuk memantau status penggantian nama, lakukan polling ID operasi yang ditampilkan oleh API penggantian nama. Untuk mengetahui informasi selengkapnya, lihat Menangani respons API.

  3. Jika perlu, mulai ulang VM.

Langkah selanjutnya