Mengganti nama VM

Linux Windows

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

Untuk merepresentasikan beban kerja yang berjalan di VM dengan lebih baik.
Untuk merujuk pada sistem operasi yang berjalan pada VM.
Untuk mematuhi konvensi penamaan apa pun 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 stok (SKU) dan bukan namanya, Anda tidak akan melihat nama VM 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.
Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:
Konsol

Saat menggunakan Konsol Google Cloud untuk mengakses API dan layanan Google Cloud, Anda tidak perlu menyiapkan autentikasi.
gcloud
1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut:
  gcloud init
  Catatan: Jika Anda telah menginstal gcloud CLI sebelumnya, pastikan Anda memiliki versi baru dengan menjalankan gcloud components update.
2. Menetapkan region dan zona default.
REST

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna 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.

Peran yang telah ditentukan 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 yang ada dalam status TERMINATED.

Konsol

Untuk mengganti nama VM, lakukan langkah berikut:

Di konsol Google Cloud, buka halaman Instance VM.

Buka halaman VM instances
Di kolom Nama, klik nama VM.
Jika Anda belum melakukannya, hentikan VM dengan melakukan langkah berikut:
1. Klik Hentikan.
2. Untuk mengonfirmasi, klik Hentikan.
  
  Penghentian VM dapat memerlukan waktu hingga 90 detik untuk diselesaikan.
Klik Edit.
Di kolom VM instance name, masukkan nama baru untuk VM.
Klik Save.

Penggantian nama VM dapat memerlukan waktu hingga satu menit. Jika, setelah mengganti nama VM, Anda mengalami error bahwa Google Cloud tidak dapat menemukan VM tersebut, refresh browser Anda.
Jika perlu, mulai ulang VM dengan mengklik Start / Resume.

gcloud

Untuk mengganti nama VM, lakukan langkah berikut:

Hentikan VM jika Anda belum melakukannya.
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.
Penggantian nama VM dapat memerlukan waktu hingga satu menit.
Jika perlu, mulai ulang VM.

REST

Untuk mengganti nama VM, lakukan langkah berikut:

Hentikan VM jika Anda belum melakukannya.
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.
Penggantian nama VM dapat memerlukan waktu hingga satu menit. Untuk memantau status penggantian nama, lakukan polling ID operasi yang ditampilkan oleh rename API. Untuk mengetahui informasi selengkapnya, lihat Menangani respons API.
Jika perlu, mulai ulang VM.

Langkah selanjutnya

Pelajari cara melihat detail VM.
Pelajari cara menghentikan atau memulai ulang VM.
Pelajari cara menangguhkan atau melanjutkan VM.
Pelajari siklus proses VM lebih lanjut.