Mengubah pemesanan


Dokumen ini menjelaskan cara mengubah pemesanan. Untuk mengubah pemesanan yang dilampirkan ke komitmen, lihat Mengganti pemesanan yang dilampirkan ke komitmen.

Ubah pemesanan saat, misalnya, kebutuhan kapasitas Anda berubah atau Anda ingin mengubah workload mana yang dapat menggunakan pemesanan.

Batasan

Sebelum Anda mengubah reservasi, pertimbangkan hal berikut:

  • Anda hanya dapat mengubah pemesanan bersama di project yang sama tempat Anda membuatnya.

  • Anda hanya dapat mengubah pemesanan yang dibuat secara otomatis setelah:

    • Untuk pemesanan untuk masa mendatang yang dibuat di AI Hypercomputer, Anda hanya dapat mengubah pemesanan setelah waktu mulainya.

    • Untuk pemesanan untuk masa mendatang yang dibuat di Compute Engine, Anda hanya dapat mengubah pemesanan setelah waktu berakhirnya.

  • Anda dapat mengubah pemesanan yang dibuat otomatis untuk pemesanan untuk masa mendatang di AI Hypercomputer hanya untuk mengizinkan atau melarang tugas Vertex AI menggunakannya.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Autentikasi adalah proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Google Cloud layanan dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi 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. After installing the Google Cloud CLI, initialize it by running the following command:

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      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.

          After installing the Google Cloud CLI, initialize it by running the following command:

          gcloud init

          If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Peran yang diperlukan

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

Peran bawaan 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 dalam reservasi, project konsumen dalam reservasi bersama, atau apakah tugas Vertex AI dapat menggunakan reservasi instance dengan GPU terlampir: compute.reservations.update di project
  • Untuk mengubah jumlah instance 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 pemesanan, gunakan salah satu metode berikut:

Untuk mengubah properti yang tidak tercantum dalam daftar ini, Anda harus membuat pemesanan baru. Untuk mengetahui petunjuknya, 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 penghapusan otomatis pemesanan.

  • Menonaktifkan opsi hapus otomatis.

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

Konsol

  1. Di konsol Google Cloud , buka halaman Reservations.

    Buka Pemesanan

  2. Di tab On-demand reservations (default), di kolom Name, klik nama reservasi yang ingin Anda ubah.

    Halaman detail pemesanan akan terbuka.

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

  4. Di panel Perbarui reservasi, 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 Aktifkan hapus otomatis 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 Kirim.

    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 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 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 detik sebelum pemesanan dihapus secara otomatis. Misalnya, tentukan 86400 untuk 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 di antara 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 konsumsi pemesanan, lihat cara memverifikasi konsumsi pemesanan.

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

Konsol

  1. Di konsol Google Cloud , buka halaman Reservations.

    Buka Pemesanan

  2. Di tab On-demand reservations (default), di kolom Name, klik nama reservasi 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 hal berikut:

      1. Klik Tambahkan project.

      2. Centang kotak untuk setiap project dari organisasi project pemilik yang ingin Anda ajak berbagi pemesanan.

      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 tentukan project pemilik dalam daftar. Secara default, pengguna 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 ID project yang dipisahkan koma untuk berbagi pemesanan. 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 ID project yang dipisahkan koma yang tidak lagi Anda izinkan menggunakan reservasi 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 ID project yang dipisahkan koma untuk berbagi pemesanan. Misalnya, tentukan project-1,project-2.

REST

Saat mengubah project konsumen untuk pemesanan bersama, Anda harus menentukan ID project yang ingin Anda izinkan, atau hentikan izinnya, 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 reservasi 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. Dalam URL permintaan, sertakan parameter kueri paths=shareSettings.projectMap.PROJECT_ID untuk setiap project yang ingin Anda hentikan penggunaan pemesanan bersama ini. 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 ini.

Mengubah jumlah instance yang dipesan dalam pemesanan

Anda dapat menambah atau mengurangi jumlah instance komputasi yang dipesan dalam pemesanan. Namun, sebelum Anda mengubah jumlah instance, pertimbangkan hal berikut untuk menghindari error:

  • Untuk menambah jumlah instance dalam reservasi apa pun, pastikan hal-hal berikut:

  • Untuk mengurangi jumlah instance dalam reservasi tertentu, pastikan jumlah instance yang menggunakan reservasi tidak melebihi jumlah baru yang lebih kecil. Jika ya, lakukan salah satu tindakan berikut dengan instance yang melebihi jumlah baru:

    • Menghapus instance

    • Hentikan atau tangguhkan instance

Untuk mengubah jumlah instance yang dicadangkan dalam reservasi, pilih salah satu opsi berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Reservations.

    Buka Pemesanan

  2. Di tab On-demand reservations (default), di kolom Name, klik nama reservasi yang ingin Anda ubah.

    Halaman detail pemesanan akan terbuka.

  3. Klik Edit.

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

  5. Untuk mengonfirmasi, klik Save.

    Mungkin perlu waktu beberapa detik untuk mengubah pemesanan Anda.

gcloud

Untuk mengubah jumlah instance 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 instance baru yang akan dipesan.

  • ZONE: zona tempat pemesanan berada.

REST

Untuk mengubah jumlah instance yang dipesan 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 instance baru yang akan dipesan.

Mengubah kebijakan berbagi pemesanan

Saat Anda mengubah kebijakan berbagi pemesanan instance komputasi GPU, Anda mengontrol apakah tugas pelatihan atau prediksi Vertex AI menggunakan pemesanan tersebut.

Sebelum Anda melarang tugas Vertex AI menggunakan reservasi, hentikan semua tugas Vertex AI yang menggunakannya. Jika tidak, Anda akan mengalami error.

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

Konsol

  1. Di konsol Google Cloud , buka halaman Reservations.

    Buka Pemesanan

  2. Di tab On-demand reservations (default), di kolom Name, klik nama reservasi instance GPU yang ingin Anda ubah. Halaman yang memberikan detail pemesanan akan muncul.

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

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

    • Untuk mengizinkan tugas Vertex AI menggunakan reservasi, pilih Share reservation.

    • Untuk melarang tugas Vertex AI menggunakan reservasi, pilih Jangan bagikan reservasi.

  5. Klik Simpan.

    Mungkin perlu waktu beberapa detik untuk mengubah pemesanan Anda.

gcloud

Untuk mengubah kebijakan berbagi pemesanan instance GPU, gunakan perintah gcloud compute reservations update dengan flag --reservation-sharing-policy.

gcloud 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 tugas Vertex AI menggunakan reservasi: ALLOW_ALL

    • Untuk melarang tugas Vertex AI menggunakan reservasi: DISALLOW_ALL

  • ZONE: zona tempat pemesanan berada

REST

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

PATCH https://compute.googleapis.com/compute/v1/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 pemesanan berada.

  • ZONE: zona tempat pemesanan berada.

  • RESERVATION_NAME: nama pemesanan yang ada.

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

    • Untuk mengizinkan tugas Vertex AI menggunakan reservasi: ALLOW_ALL

    • Untuk melarang tugas Vertex AI menggunakan reservasi: DISALLOW_ALL

Mengubah properti lain di pemesanan

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

Untuk mengganti pemesanan tanpa risiko pengurangan yang tidak diinginkan pada kapasitas yang dipesan, lakukan tindakan berikut:

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

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

Memecahkan masalah

Pelajari cara memecahkan masalah terkait pembaruan pemesanan.

Langkah berikutnya