Mengelola instance Google Cloud Managed Lustre

Setelah membuat instance, Google Cloud Managed Lustre memungkinkan Anda mencantumkan, mendapatkan, memperbarui, dan menghapus instance.

Saat memperbarui instance Managed Lustre, hanya deskripsi dan label yang dapat diubah.

Mencantumkan instance

Untuk mencantumkan semua instance dalam project:

Google Cloud Konsol

  1. Buka halaman Managed Lustre di Google Cloud Konsol.

    Buka Managed Lustre

    Instance project Anda akan dicantumkan.

gcloud CLI

Gunakan perintah gcloud lustre instances list:

gcloud lustre instances list --location=LOCATION

Ganti LOCATION dengan zona tertentu untuk mencantumkan semua instance di lokasi tersebut. Untuk melihat project di semua lokasi, masukkan - sebagai nilai. Misalnya:

gcloud lustre instances list --location=-

REST

Untuk mencantumkan instance menggunakan REST API, kirim permintaan ke endpoint berikut:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dengan nilai berikut harus ditentukan:

  • PROJECT_ID adalah Google Cloud project ID Anda.

  • ZONE adalah zona yang akan digunakan untuk mencantumkan semua instance. Untuk mencantumkan instance dari semua zona, gunakan - sebagai nilai.

Lihat referensi API instances.list untuk mengetahui detail selengkapnya.

Mendapatkan instance

Untuk mendapatkan detail instance:

Google Cloud Konsol

  1. Buka halaman Managed Lustre di Google Cloud Konsol.

    Buka Managed Lustre

  2. Klik nama instance untuk melihat detail tentang instance tertentu.

gcloud CLI

Gunakan perintah gcloud lustre instances describe:

gcloud lustre instances describe INSTANCE_NAME --location=LOCATION

REST

Untuk mendapatkan detail tentang instance tertentu menggunakan REST API, kirim permintaan ke endpoint berikut:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dengan nilai berikut harus ditentukan:

  • PROJECT_ID adalah Google Cloud project ID Anda.

  • ZONE harus berupa zona yang valid dan didukung oleh Managed Lustre. Google Cloud Lihat Lokasi yang didukung untuk mengetahui daftar lengkapnya.

  • INSTANCE_NAME adalah nama instance Managed Lustre yang akan ditampilkan.

Lihat referensi API instances.get untuk mengetahui detail selengkapnya.

Status instance

Instance Managed Lustre dapat berada dalam salah satu status berikut:

Status Deskripsi
CREATING Instance sedang dibuat dan belum siap digunakan.
ACTIVE Instance tersedia untuk digunakan.
UPGRADING Instance sedang diupgrade.
REPAIRING Instance sedang diperbaiki.
MAINTENANCE Instance sedang menjalani pemeliharaan host yang direncanakan. Instance berkapasitas besar (lebih besar dari nilai minimum ukuran langkah) mungkin mengalami waktu nonaktif hingga 4 jam selama status ini.
SUSPENDED Instance ditangguhkan, biasanya karena masalah dengan kunci enkripsi yang dikelola pelanggan (CMEK).
DELETING Instance sedang dihapus.

Untuk mengetahui informasi selengkapnya tentang pemeliharaan, lihat Pemecahan masalah dan masalah umum.

Memperbarui instance

Anda dapat memperbarui properti instance yang ada berikut:

  • deskripsi
  • labels
  • kapasitas penyimpanan

Untuk mengetahui informasi tentang cara meningkatkan kapasitas penyimpanan instance, lihat Meningkatkan kapasitas instance.

Untuk memperbarui instance:

Google Cloud Konsol

  1. Buka halaman Managed Lustre di Google Cloud Konsol.

    Buka Managed Lustre

  2. Klik Nama instance instance yang akan diperbarui. Halaman ringkasan instance akan ditampilkan.

  3. Klik Edit.

  4. Masukkan nilai baru.

  5. Klik Kirim.

Google Cloud CLI

Gunakan perintah gcloud lustre instances update:

gcloud lustre instances update INSTANCE_NAME \
  --location=LOCATION \
  --capacity-gib=NEW_CAPACITY \
  --description=NEW_DESCRIPTION

Dengan:

  • INSTANCE_NAME adalah instance yang akan diperbarui.
  • LOCATION adalah zona tempat instance berada.
  • NEW_CAPACITY adalah kapasitas penyimpanan baru untuk instance ini dalam gibibyte (GiB). Nilai tidak boleh melebihi kapasitas maksimum yang diizinkan dan harus merupakan kelipatan ukuran langkah. Lihat Meningkatkan kapasitas instance untuk mengetahui detail selengkapnya.
  • NEW_DESCRIPTION adalah nilai baru untuk kolom deskripsi, yang akan mengganti deskripsi yang ada.

Untuk memperbarui label, lihat perintah yang tersedia dalam dokumentasi gcloud lustre instances update.

REST

Untuk memperbarui instance menggunakan REST API, kirim permintaan PATCH ke endpoint tertentu:

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME?updateMask=UPDATE_MASK
Authorization: Bearer [YOUR_ACCESS_TOKEN]

{
  "capacityGib": 72000,
  "description": "updated description",
  "labels": {
    "key1": "value1"
  }
}

Dengan nilai berikut harus ditentukan:

  • PROJECT_ID adalah Google Cloud project ID Anda.
  • ZONE adalah Google Cloud zona instance.
  • INSTANCE_NAME adalah nama instance Managed Lustre yang akan diperbarui.
  • UPDATE_MASK adalah daftar kolom yang dipisahkan koma yang akan diperbarui. Kolom hanya akan ditimpa jika berada dalam mask.

Isi permintaan harus berisi satu atau beberapa kolom berikut:

  • capacityGiB adalah kapasitas penyimpanan baru untuk instance ini dalam gibibyte (GiB). Nilai tidak boleh melebihi kapasitas maksimum yang diizinkan dan harus merupakan kelipatan ukuran langkah. Lihat Meningkatkan kapasitas instance untuk mengetahui detail selengkapnya.
  • description adalah deskripsi baru untuk instance ini.
  • labels adalah kumpulan label baru untuk instance ini. Nilai labels adalah objek JSON yang berisi satu atau beberapa pasangan kunci:nilai.

Lihat referensi API instances.patch untuk mengetahui detail selengkapnya.

Menghapus instance

Untuk menghapus instance:

Google Cloud Konsol

  1. Buka halaman Managed Lustre di Google Cloud Konsol.

    Buka Managed Lustre

  2. Pilih menu tiga titik di samping instance yang akan dihapus.

  3. Pilih Hapus instance. Konfirmasi penghapusan dengan mengklik Hapus lagi.

gcloud CLI

Gunakan perintah gcloud lustre instances delete:

gcloud lustre instances delete INSTANCE_NAME --location=LOCATION

Anda akan diminta untuk mengonfirmasi penghapusan. Ketik Y atau tekan Enter untuk melanjutkan.

REST

Untuk menghapus instance menggunakan REST API, kirim permintaan ke endpoint berikut:

DELETE https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE_NAME
Authorization: Bearer [YOUR_ACCESS_TOKEN]

Dengan nilai berikut harus ditentukan:

  • PROJECT_ID adalah Google Cloud project ID Anda.

  • ZONE adalah Google Cloud zona tempat instance berada.

  • INSTANCE_NAME adalah nama instance Managed Lustre yang akan dihapus.

Lihat referensi API instances.delete untuk mengetahui detail selengkapnya.

Permintaan penghapusan adalah permintaan yang berjalan lama, dan menampilkan ID operasi yang dapat dikueri untuk status operasi. Lihat referensi operations.get untuk mengetahui detailnya.