Mengubah pemesanan

Dokumen ini menjelaskan cara mengubah pemesanan yang ada.

Mengubah pemesanan berguna jika, misalnya, kebutuhan kapasitas Anda berubah atau Anda ingin mengizinkan atau melarang project menggunakan pemesanan bersama. Jika ingin mengubah pemesanan bersama, Anda hanya dapat mengubahnya menggunakan project pemilik.

Jika Anda ingin mengubah pemesanan yang terlampir ke komitmen, lihat Mengganti pemesanan yang terlampir ke komitmen.

Sebelum memulai

  • 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 guna mengubah pemesanan, minta administrator untuk memberi Anda peran IAM Compute Admin (roles/compute.admin) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditentukan ini berisi izin yang diperlukan untuk mengubah pemesanan. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengubah pemesanan:

  • Untuk mengubah opsi hapus otomatis di pemesanan atau project konsumen di pemesanan bersama: compute.reservations.update di project
  • Untuk mengubah jumlah VM dalam pemesanan: compute.reservations.resize pada project

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

Mengubah pemesanan

Berdasarkan properti yang ingin Anda ubah dalam reservasi, gunakan salah satu metode berikut:

Jika Anda ingin mengubah properti yang tidak disebutkan dalam daftar ini, lihat Mengubah properti lain di pemesanan dalam dokumen ini.

Mengubah penghapusan otomatis pemesanan

Anda dapat mengubah kapan Compute Engine otomatis menghapus pemesanan yang ada dengan melakukan salah satu tindakan berikut:

  • Aktifkan opsi hapus otomatis atau ubah waktu saat pemesanan dihapus secara otomatis.

  • Menonaktifkan opsi hapus otomatis.

Untuk mengubah penghapusan otomatis pemesanan, pilih salah satu opsi berikut:

Konsol

  1. Di Konsol Google Cloud, buka halaman Pemesanan.

    Buka Pemesanan

  2. Di tab Pemesanan on demand (default), di kolom Nama, klik nama pemesanan yang ingin Anda ubah.

    Halaman detail pemesanan akan terbuka.

  3. Di baris Waktu hapus otomatis, klik Edit waktu hapus otomatis.

  4. Di panel Update reservation, lakukan salah satu hal berikut:

    • Untuk menghapus reservasi pada tanggal dan waktu tertentu, lakukan hal berikut:

      1. Jika opsi hapus otomatis belum diaktifkan, klik tombol Enable auto-delete ke posisi aktif.

      2. Di kolom Auto-delete time, masukkan tanggal dan waktu saat Compute Engine otomatis menghapus pemesanan.

    • Jika tidak, klik tombol Aktifkan hapus otomatis ke posisi nonaktif.

  5. Klik Submit.

    Mungkin perlu waktu beberapa detik untuk mengubah pemesanan Anda.

gcloud

Saat mengaktifkan opsi hapus otomatis dalam pemesanan, Anda dapat menentukan tanggal dan waktu saat pemesanan harus dihapus atau menentukan durasi setelah itu pemesanan harus dihapus.

Untuk mengaktifkan opsi hapus otomatis atau mengubah kapan pemesanan harus dihapus, lakukan salah satu tindakan berikut:

  • Untuk menghapus reservasi pada tanggal dan waktu tertentu, gunakan perintah gcloud beta compute reservations update dengan flag --delete-at-time.

    gcloud beta compute reservations update RESERVATION_NAME \
    --delete-at-time=DELETE_AT_TIME \
    --zone=ZONE

    Ganti kode berikut:

    • RESERVATION_NAME: nama pemesanan yang ada.

    • DELETE_AT_TIME: tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.

    • ZONE: zona tempat pemesanan berada.

  • Untuk menghapus pemesanan setelah durasi tertentu, gunakan perintah gcloud beta compute reservations update dengan flag --delete-after-duration.

    gcloud beta compute reservations update RESERVATION_NAME \
    --delete-after-duration=DELETE_AFTER_DURATION \
    --zone=ZONE

    Ganti kode berikut:

    • RESERVATION_NAME: nama pemesanan yang ada.

    • DELETE_AFTER_DURATION: durasi dalam hari, jam, menit, atau detik sebelum pemesanan dihapus secara otomatis. Misalnya, tentukan 30m selama 30 menit, atau 1d2h3m4s selama 1 hari, 2 jam, 3 menit, dan 4 detik.

    • ZONE: zona tempat pemesanan berada.

Untuk menonaktifkan opsi hapus otomatis, gunakan perintah gcloud beta compute reservations update dengan flag --disable-auto-delete.

gcloud beta compute reservations update RESERVATION_NAME \
    --disable-auto-delete \
    --zone=ZONE

Ganti kode berikut:

  • RESERVATION_NAME: nama pemesanan yang ada.

  • ZONE: zona tempat pemesanan berada.

REST

Saat mengaktifkan opsi hapus otomatis dalam pemesanan, Anda dapat menentukan tanggal dan waktu saat pemesanan harus dihapus atau menentukan durasi setelah itu pemesanan harus dihapus.

Untuk mengaktifkan opsi hapus otomatis atau mengubah kapan pemesanan harus dihapus, lakukan salah satu tindakan berikut:

  • Untuk menghapus pemesanan pada tanggal dan waktu tertentu, buat permintaan PATCH ke metode beta.reservations.update. Di URL permintaan, sertakan parameter kueri paths yang ditetapkan ke deleteAtTime.

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime

{
  "name": "RESERVATION_NAME",
  "deleteAtTime": "DELETE_AT_TIME"
}

    Ganti kode berikut:

    • PROJECT_ID: ID project tempat reservasi berada.

    • ZONE: zona tempat pemesanan berada.

    • RESERVATION_NAME: nama pemesanan yang ada.

    • DELETE_AT_TIME: tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339.

  • Untuk menghapus pemesanan setelah durasi tertentu, buat permintaan PATCH ke metode beta.reservations.update. Di URL permintaan, sertakan parameter kueri paths yang ditetapkan ke deleteAfterDuration.seconds.

    PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAfterDuration.seconds

{
  "name": "RESERVATION_NAME",
  "deleteAfterDuration": {
    "seconds": "DELETE_AFTER_DURATION"
  }
}

    Ganti kode berikut:

    • PROJECT_ID: ID project tempat reservasi berada.

    • ZONE: zona tempat pemesanan berada.

    • RESERVATION_NAME: nama pemesanan yang ada.

    • DELETE_AFTER_DURATION: durasi dalam hitungan detik sebelum pemesanan dihapus secara otomatis. Misalnya, tentukan 86400 selama 86.400 detik (1 hari).

Untuk menonaktifkan opsi hapus otomatis, buat permintaan PATCH ke metode beta.reservations.update. Dalam permintaan, tentukan parameter kueri paths=deleteAtTime&paths=deleteAfterDuration dan hapus isi permintaan.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAtTime&paths=deleteAfterDuration

Ganti kode berikut:

  • PROJECT_ID: ID project tempat reservasi berada.

  • ZONE: zona tempat pemesanan berada.

  • RESERVATION_NAME: nama pemesanan yang ada.

Mengubah project konsumen dalam pemesanan bersama

Anda hanya dapat mengizinkan project menggunakan pemesanan bersama jika project tersebut berada di organisasi yang sama dengan project pemilik. Untuk mempelajari cara memigrasikan project ke organisasi project pemilik, lihat Memigrasikan project antar-resource organisasi dalam dokumentasi Resource Manager.

Setelah Anda mengubah project konsumen mana saja yang dapat menggunakan pemesanan bersama, konsumsi pemesanan mungkin berubah. Misalnya, project konsumen yang dihapus akan berhenti menggunakan resource dari pemesanan. Selain itu, jika pemesanan dikonfigurasi untuk secara otomatis digunakan oleh VM apa pun yang cocok dengan properti pemesanan (perilaku default), setiap project konsumen yang ditambahkan mungkin akan mulai menggunakan resource dari pemesanan. Jika Anda ingin memantau penggunaan pemesanan, lihat cara memverifikasi penggunaan pemesanan.

Untuk mengubah project konsumen yang dapat menggunakan pemesanan bersama, pilih salah satu opsi berikut:

Konsol

  1. Di Konsol Google Cloud, buka halaman Pemesanan.

    Buka Pemesanan

  2. Di tab Pemesanan on demand (default), di kolom Nama, klik nama pemesanan yang ingin Anda deskripsikan.

    Halaman detail pemesanan akan terbuka.

  3. Klik Edit.

  4. Di bagian Selected projects, lakukan salah satu langkah berikut:

    • Untuk berhenti berbagi pemesanan dengan project konsumen tertentu, klik Delete.

    • Untuk mulai berbagi pemesanan dengan satu atau beberapa project tertentu, lakukan tindakan berikut:

      1. Klik Tambahkan project.

      2. Centang kotak untuk setiap project dari organisasi project pemilik yang ingin Anda izinkan menggunakan pemesanan bersama ini.

      3. Klik Pilih.

  5. Untuk mengonfirmasi perubahan, klik Save.

    Mungkin perlu waktu beberapa detik untuk mengubah pemesanan Anda.

gcloud

Saat mengubah project konsumen untuk pemesanan bersama, Anda harus menentukan daftar ID project yang dipisahkan koma yang ingin Anda izinkan, atau berhenti mengizinkan, untuk menggunakan pemesanan bersama. Project ini harus berada dalam organisasi yang sama dengan project pemilik. Jangan menentukan project pemilik dalam daftar. Secara default, project sudah diizinkan untuk menggunakan pemesanan bersama.

Untuk mengubah project konsumen untuk pemesanan bersama, pilih salah satu metode berikut:

  • Untuk mengizinkan satu atau beberapa project menggunakan pemesanan bersama, gunakan perintah gcloud compute reservations update dengan flag --add-share-with.

    gcloud compute reservations update RESERVATION_NAME \
    --add-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Ganti kode berikut:

    • RESERVATION_NAME: nama reservasi bersama yang ada.

    • CONSUMER_PROJECT_IDS: daftar yang dipisahkan koma untuk ID project yang akan diajak berbagi reservasi. Misalnya, tentukan project-1,project-2.

    • ZONE: zona tempat pemesanan bersama berada.

  • Untuk berhenti mengizinkan satu atau beberapa project menggunakan pemesanan bersama, gunakan perintah gcloud compute reservations update dengan flag --remove-share-with.

    gcloud compute reservations update RESERVATION_NAME \
    --remove-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Ganti kode berikut:

    • RESERVATION_NAME: nama reservasi bersama yang ada.

    • CONSUMER_PROJECT_IDS: daftar yang dipisahkan koma untuk ID project yang tidak lagi Anda izinkan menggunakan pemesanan bersama ini. Misalnya, tentukan project-1,project-2.

    • ZONE: zona tempat pemesanan bersama berada.

  • Untuk mengganti daftar project yang dapat menggunakan pemesanan bersama, gunakan perintah gcloud beta compute reservations update dengan flag --share-with.

    gcloud beta compute reservations update RESERVATION_NAME \
    --share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE

    Ganti kode berikut:

    • RESERVATION_NAME: nama reservasi bersama yang ada.

    • ZONE: zona tempat pemesanan bersama berada.

    • CONSUMER_PROJECT_IDS: daftar yang dipisahkan koma untuk ID project yang akan diajak berbagi reservasi. Misalnya, tentukan project-1,project-2.

REST

Saat mengubah project konsumen untuk pemesanan bersama, Anda harus menentukan ID project yang ingin diizinkan, atau berhenti diizinkan, untuk menggunakan pemesanan bersama. Project ini harus berada dalam organisasi yang sama dengan project pemilik. Jangan menetapkan project pemilik. Secara default, project sudah diizinkan untuk menggunakan pemesanan bersama.

Untuk mengubah project konsumen untuk pemesanan bersama, pilih salah satu metode berikut:

  • Untuk mengizinkan satu atau beberapa project menggunakan pemesanan bersama, buat permintaan PATCH ke metode reservations.update. Di URL permintaan, sertakan parameter kueri paths=shareSettings.projectMap.PROJECT_ID untuk setiap project yang ingin Anda gunakan dalam pemesanan bersama.

    Misalnya, untuk mengizinkan dua project menggunakan reservasi bersama, buat permintaan PATCH berikut:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_2

{
  "name": "RESERVATION_NAME",
  "shareSetting": {
    "projectMap": {
      "CONSUMER_PROJECT_ID_1": {
        "projectId": "CONSUMER_PROJECT_ID_1"
      },
      "CONSUMER_PROJECT_ID_2": {
        "projectId": "CONSUMER_PROJECT_ID_2"
      }
    }
  }
}

    Ganti kode berikut:

    • PROJECT_ID: ID project pemilik, yang merupakan project yang digunakan untuk membuat reservasi bersama.

    • ZONE: zona tempat pemesanan bersama berada.

    • RESERVATION_NAME: nama reservasi bersama yang ada.

    • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: ID dua project yang ingin Anda gunakan dalam pemesanan bersama.

  • Untuk berhenti mengizinkan satu atau beberapa project menggunakan pemesanan bersama, buat permintaan PATCH ke metode reservations.update. Di URL permintaan, sertakan parameter kueri paths=shareSettings.projectMap.PROJECT_ID untuk setiap project yang tidak lagi Anda izinkan menggunakan pemesanan bersama. Selain itu, Anda harus menghapus kolom shareSetting dari isi permintaan.

    Misalnya, untuk berhenti mengizinkan dua project menggunakan pemesanan bersama, buat permintaan PATCH berikut:

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_1&paths=shareSettings.projectMap.CONSUMER_PROJECT_ID_2

{
  "name": "RESERVATION_NAME"
}

    Ganti kode berikut:

    • PROJECT_ID: ID project pemilik, yang merupakan project yang digunakan untuk membuat reservasi bersama.

    • ZONE: zona tempat pemesanan bersama berada.

    • RESERVATION_NAME: nama reservasi bersama yang ada.

    • CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: ID dua project yang tidak lagi Anda izinkan menggunakan pemesanan bersama.

Mengubah jumlah VM yang dicadangkan dalam pemesanan

Anda dapat mengubah pemesanan yang ada untuk menambah atau mengurangi jumlah VM yang dipesan.

Sebelum mengubah jumlah VM yang dicadangkan dalam pemesanan, pastikan kondisi berikut terpenuhi:

  • Jika Anda ingin meningkatkan jumlah VM yang dicadangkan dalam pemesanan, pastikan hal berikut:

    • Harus ada resource yang memadai di zona tempat pemesanan berada.

    • Anda harus memiliki kuota yang memadai—yaitu, kuota CPU dan kuota GPU—untuk resource tambahan yang Anda pesan. Untuk meningkatkan kuota, lihat Melihat dan mengelola kuota dalam dokumentasi Kuota Cloud.

  • Jika jenis penggunaan reservasi Anda bersifat spesifik dan Anda ingin mengurangi jumlah VM yang dicadangkan dalam reservasi, pastikan jumlah VM yang menggunakan reservasi tidak melebihi ukuran reservasi yang Anda inginkan. Anda dapat melakukannya dengan menggunakan metode berikut:

Untuk mengubah jumlah VM yang dicadangkan dalam pemesanan, pilih salah satu opsi berikut:

Konsol

  1. Di Konsol Google Cloud, buka halaman Pemesanan.

    Buka Pemesanan

  2. Di tab Pemesanan on demand (default), di kolom Nama, klik nama pemesanan yang ingin Anda ubah.

    Halaman detail pemesanan akan terbuka.

  3. Klik Edit.

  4. Di kolom Number of VM instances, masukkan jumlah VM terbaru yang akan dipesan.

  5. Untuk mengonfirmasi, klik Save.

    Mungkin perlu waktu beberapa detik untuk mengubah pemesanan Anda.

gcloud

Untuk mengubah jumlah VM yang dipesan dalam pemesanan, gunakan perintah gcloud compute reservations update.

gcloud compute reservations update RESERVATION_NAME \
    --vm-count=NUMBER_OF_VMS \
    --zone=ZONE

Ganti kode berikut:

  • RESERVATION_NAME: nama pemesanan yang ada.

  • NUMBER_OF_VMS: jumlah VM baru yang akan dipesan.

  • ZONE: zona tempat pemesanan berada.

REST

Untuk mengubah jumlah VM yang dicadangkan dalam pemesanan, buat permintaan POST ke metode reservations.resize.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME/resize

{
  "specificSkuCount": "NUMBER_OF_VMS"
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat pemesanan berada.

  • ZONE: zona tempat pemesanan berada.

  • RESERVATION_NAME: nama pemesanan yang ada.

  • NUMBER_OF_VMS: jumlah VM baru yang akan dipesan.

Mengubah kebijakan berbagi reservasi

Dengan mengubah kebijakan berbagi reservasi VM GPU, Anda dapat mengizinkan atau melarang tugas pelatihan kustom atau tugas prediksi di Vertex AI untuk menggunakan reservasi.

Jika Anda ingin melarang Vertex AI menggunakan reservasi, sebelum mengubah reservasi, pastikan tidak ada tugas pelatihan kustom atau tugas prediksi yang menggunakan reservasi. Jika tidak, Anda akan mengalami error.

Untuk mengubah kebijakan berbagi reservasi VM GPU, pilih salah satu opsi berikut:

Konsol

  1. Di Konsol Google Cloud, buka halaman Pemesanan.

    Buka Pemesanan

  2. Di tab Pemesanan on demand (default), di kolom Name, klik nama pemesanan VM GPU yang ingin Anda ubah.

    Halaman detail pemesanan akan terbuka.

  3. Di baris Berbagi dengan layanan Google Cloud lainnya, klik Edit setelan berbagi layanan.

  4. Di panel Reservation sharing, lakukan salah satu hal berikut:

    • Untuk mengizinkan Vertex AI menggunakan reservasi, pilih Bagikan reservasi.

    • Untuk melarang Vertex AI menggunakan reservasi, pilih Don't share reservation.

  5. Klik Simpan.

    Mungkin perlu waktu beberapa detik untuk mengubah pemesanan Anda.

gcloud

Untuk mengubah kebijakan berbagi reservasi VM GPU, gunakan perintah gcloud beta compute reservations update dengan flag --reservation-sharing-policy.

gcloud beta compute reservations update RESERVATION_NAME \
    --reservation-sharing-policy=SHARING_POLICY \
    --zone=ZONE

Ganti kode berikut:

  • RESERVATION_NAME: nama pemesanan yang ada.

  • SHARING_POLICY: kebijakan berbagi pemesanan. Tentukan salah satu nilai berikut:

    • Untuk mengizinkan Vertex AI menggunakan reservasi: ALLOW_ALL

    • Untuk melarang Vertex AI menggunakan reservasi: DISALLOW_ALL

  • ZONE: zona tempat pemesanan berada.

REST

Untuk mengubah kebijakan berbagi pemesanan VM GPU, buat permintaan PATCH ke metode beta.reservations.update. Di URL permintaan, sertakan parameter kueri paths yang ditetapkan ke reservationSharingPolicy.serviceShareType.

PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=reservationSharingPolicy.serviceShareType

{
  "name": "RESERVATION_NAME",
  "reservationSharingPolicy": {
    "serviceShareType": "SHARING_POLICY"
  }
}

Ganti kode berikut:

  • PROJECT_ID: ID project tempat reservasi berada.

  • ZONE: zona tempat pemesanan berada.

  • RESERVATION_NAME: nama pemesanan yang ada.

  • SHARING_POLICY: kebijakan berbagi pemesanan. Tentukan salah satu nilai berikut:

    • Untuk mengizinkan Vertex AI menggunakan reservasi: ALLOW_ALL

    • Untuk melarang Vertex AI menggunakan reservasi: DISALLOW_ALL

Mengubah properti lain di pemesanan

Jika ingin mengubah properti yang tidak disebutkan di bagian Ubah pemesanan, Anda harus membuat pemesanan pengganti.

Untuk mengganti pemesanan tanpa berisiko mengurangi kapasitas yang direservasi secara tidak disengaja, lakukan tindakan berikut:

  1. Buat project tunggal atau pemesanan bersama baru dengan properti yang telah diperbarui.

  2. Jika Anda tidak lagi memerlukan reservasi asli, hapus reservasi.

Memecahkan masalah

Pelajari cara memecahkan masalah terkait pembaruan pemesanan.

Langkah selanjutnya