Mengubah pemesanan

Dokumen ini menjelaskan cara mengubah reservasi yang ada.

Jika Anda ingin mengubah reservasi yang terkait dengan abonemen, lihat artikel Mengganti reservasi yang terlampir pada komitmen.

Sebelum memulai

Tinjau persyaratan dan pembatasan untuk pemesanan.
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 untuk mengubah reservasi, minta administrator untuk memberi Anda peran IAM Compute Admin (roles/compute.admin) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk mengubah reservasi. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengubah reservasi:

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

Anda mung juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaanlainnya.

Mengubah pemesanan

Anda dapat melakukan perubahan berikut pada reservasi yang sudah ada:

Mengubah penghapusan otomatis reservasi.

Bagian ini menjelaskan cara mengaktifkan opsi hapus otomatis di reservasi, mengubah tanggal dan waktu saat reservasi dihapus secara otomatis, atau menonaktifkan penghapusan otomatis reservasi.
Mengubah project konsumen di reservasi bersama.

Bagian ini menjelaskan cara menambahkan atau menghapus project konsumen yang dapat menggunakan reservasi bersama. Jika ingin menambahkan project yang dapat menggunakan reservasi bersama, project tersebut harus berada di organisasi yang sama dengan project tempat reservasi dibuat (project pemilik).
Mengubah jumlah VM yang dicadangkan dalam reservasi.

Bagian ini menjelaskan cara menambah atau mengurangi jumlah instance virtual machine (VM) yang dicadangkan dalam reservasi.

Jika Anda ingin mengubah properti lain dalam reservasi yang tidak dilampirkan ke abonemen, lihat artikel Mengubah properti lain di reservasi dalam dokumen ini.

Mengubah penghapusan otomatis reservasi

Anda dapat melakukan perubahan saat Compute Engine otomatis menghapus reservasi yang ada dengan melakukan salah satu tindakan berikut:

Mengaktifkan opsi hapus otomatis atau ubah saat reservasi dihapus otomatis.
Menonaktifkan opsi hapus otomatis.

Untuk mengubah penghapusan otomatis reservasi, gunakan Google Cloud Console, gcloud CLI, atau REST.

Konsol

Untuk mengubah penghapusan otomatis reservasi, ikuti langkah-langkah berikut:

Di Konsol Google Cloud, buka halaman Pemesanan.

Buka Pemesanan
Di kolom Nama, klik nama reservasi yang ingin diubah.

Halaman detail reservasi yang dipilih akan terbuka.
Di baris Auto-delete time, klik Edit auto-delete time.
Di panel Update reservation, lakukan salah satu langkah berikut:
- Untuk menghapus reservasi pada tanggal dan waktu tertentu, lakukan langkah 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 menghapus reservasi secara otomatis.
- Jika tidak, klik tombol Aktifkan hapus otomatis ke posisi nonaktif.
Klik Submit.

Mungkin perlu waktu beberapa detik untuk mengubah pemesanan Anda.

gcloud

Saat mengaktifkan opsi hapus otomatis dalam reservasi, Anda dapat menentukan tanggal dan waktu kapan reservasi harus dihapus atau menentukan durasi penghapusan reservasi.

Untuk mengaktifkan opsi hapus otomatis atau mengubah kapan reservasi harus dihapus, lakukan salah satu hal 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 \
    --project=PROJECT_ID \
    --zone=ZONE
```
Ganti kode berikut:
- RESERVATION_NAME: nama pemesanan yang ada.
- DELETE_AT_TIME: tanggal dan waktu yang diformat sebagai stempel waktu RFC 3339, yang harus seperti berikut:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  Ganti kode berikut:
  - YYYY-MM-DD: tanggal dengan format 4 digit tahun, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-).
  - HH:MM:SS: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:).
  - OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, jika tidak ingin menggunakan offset, tentukan Z.
- PROJECT_ID: ID project tempat reservasi berada.
- ZONE: zona tempat pemesanan berada.
Untuk menghapus reservasi 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 \
    --project=PROJECT_ID \
    --zone=ZONE
```
Ganti kode berikut:
- RESERVATION_NAME: nama pemesanan yang ada.
- DELETE_AFTER_DURATION: durasi dalam hari, jam, menit, atau detik sebelum reservasi otomatis dihapus. Misalnya, tentukan 30m selama 30 menit, atau 1d2h3m4s selama 1 hari, 2 jam, 3 menit, dan 4 detik.
- PROJECT_ID: ID project tempat reservasi berada.
- 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 \
    --project=PROJECT_ID \
    --zone=ZONE

Ganti kode berikut:

RESERVATION_NAME: nama pemesanan yang ada.
PROJECT_ID: ID project tempat reservasi berada.
ZONE: zona tempat pemesanan berada.

REST

Saat mengaktifkan opsi hapus otomatis dalam reservasi, Anda dapat menentukan tanggal dan waktu kapan reservasi harus dihapus atau menentukan durasi penghapusan reservasi.

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

Untuk menghapus reservasi pada tanggal dan waktu tertentu, buat permintaan PATCH ke metode beta.reservations.update dengan parameter kueri paths 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, yang harus seperti berikut:
```
YYYY-MM-DDTHH:MM:SSOFFSET
```
  Ganti kode berikut:
  - YYYY-MM-DD: tanggal dengan format 4 digit tahun, 2 digit bulan, dan 2 digit hari dalam sebulan, yang dipisahkan dengan tanda hubung (-).
  - HH:MM:SS: waktu diformat sebagai jam 2 digit menggunakan waktu 24 jam, menit 2 digit, dan detik 2 digit yang dipisahkan dengan titik dua (:).
  - OFFSET: zona waktu yang diformat sebagai offset Waktu Universal Terkoordinasi (UTC). Misalnya, untuk menggunakan Waktu Standar Pasifik (PST), tentukan -08:00. Atau, jika tidak ingin menggunakan offset, tentukan Z.
Untuk menghapus reservasi setelah durasi tertentu, buat permintaan PATCH ke metode beta.reservations.update dengan parameter kueri paths ditetapkan ke deleteAfterDuration.
```
PATCH https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/reservations/RESERVATION_NAME?paths=deleteAfterDuration

{
  "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 reservasi otomatis dihapus. 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 di reservasi bersama

Anda dapat mengubah project konsumen untuk reservasi bersama yang sudah ada. Project konsumen adalah project yang digunakan bersama oleh reservasi dan dapat menggunakan reservasi.

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 reservasi dikonfigurasi agar otomatis digunakan oleh setiap VM yang cocok dengan properti reservasi (perilaku default), setiap project konsumen yang ditambahkan mungkin akan mulai menggunakan resource dari reservasi. Jika Anda ingin memantau konsumsi reservasi, lihat cara memverifikasi konsumsi reservasi.

Untuk mengubah project konsumen yang dapat menggunakan reservasi bersama, gunakan Google Cloud Console, gcloud CLI, atau REST.

Konsol

Guna mengubah project konsumen untuk reservasi bersama, ikuti langkah-langkah berikut:

Di Konsol Google Cloud, buka halaman Pemesanan.

Buka Pemesanan
Di kolom Nama, klik nama pemesanan yang ingin Anda deskripsikan.

Halaman detail reservasi akan terbuka.
Klik Edit.
Di bagian Selected projects, lakukan salah satu langkah berikut:
- Untuk berhenti berbagi pemesanan dengan project konsumen tertentu, klik Delete.
- Untuk mulai membagikan reservasi ke satu atau beberapa project tertentu, lakukan langkah berikut:
  1. Klik Tambahkan project.
  2. Pilih kotak centang untuk setiap project dari organisasi project pemilik yang ingin Anda ajak berbagi reservasi.
  3. Klik Select.
Untuk mengonfirmasi perubahan, klik Save.

Mungkin perlu waktu beberapa detik untuk mengubah pemesanan Anda.

gcloud

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

Guna mengubah project konsumen untuk reservasi bersama, pilih salah satu metode berikut:

Untuk mengizinkan satu atau beberapa project menggunakan reservasi bersama, gunakan perintah gcloud compute reservations update dengan flag --add-share-with.
```
gcloud compute reservations update RESERVATION_NAME \
    --project=PROJECT_ID \
    --add-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE
```
Ganti kode berikut:
- RESERVATION_NAME: nama reservasi bersama yang ada.
- PROJECT_ID: ID project pemilik, yang merupakan project yang digunakan untuk membuat reservasi bersama.
- CONSUMER_PROJECT_IDS: daftar ID project yang dipisahkan koma yang digunakan untuk berbagi reservasi. Misalnya, tentukan project-1,project-2.
- ZONE: zona tempat reservasi bersama berada.
Untuk berhenti mengizinkan satu atau beberapa project menggunakan reservasi bersama, gunakan perintah gcloud compute reservations update dengan flag --remove-share-with.
```
gcloud compute reservations update RESERVATION_NAME \
    --project=PROJECT_ID \
    --remove-share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE
```
Ganti kode berikut:
- RESERVATION_NAME: nama reservasi bersama yang ada.
- PROJECT_ID: ID project pemilik, yang merupakan project yang digunakan untuk membuat reservasi bersama.
- CONSUMER_PROJECT_IDS: daftar ID project yang dipisahkan koma dan Anda tidak ingin lagi membagikan reservasi. Misalnya, tentukan project-1,project-2.
- ZONE: zona tempat reservasi bersama berada.
Untuk mengganti daftar project yang dapat menggunakan pemesanan bersama, gunakan perintah gcloud compute reservations update dengan flag --share-with.
```
gcloud compute reservations update RESERVATION_NAME \
    --project=PROJECT_ID \
    --share-with=CONSUMER_PROJECT_IDS \
    --zone=ZONE
```
Ganti kode berikut:
- RESERVATION_NAME: nama reservasi bersama yang ada.
- PROJECT_ID: ID project pemilik, yang merupakan project yang digunakan untuk membuat reservasi bersama.
- ZONE: zona tempat reservasi bersama berada.
- CONSUMER_PROJECT_IDS: daftar ID project yang dipisahkan koma yang digunakan untuk berbagi reservasi. Misalnya, tentukan project-1,project-2.

REST

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

Guna mengubah project konsumen untuk reservasi bersama, pilih salah satu metode berikut:

Untuk mengizinkan satu atau beberapa project menggunakan reservasi 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 ajak berbagi reservasi.

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 reservasi bersama berada.
- RESERVATION_NAME: nama reservasi bersama yang ada.
- CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: ID dua project yang ingin Anda bagikan reservasi.
Untuk berhenti mengizinkan satu atau beberapa project menggunakan reservasi 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 pembagian reservasinya. Selain itu, Anda harus menghilangkan kolom shareSetting dari isi permintaan.

Misalnya, untuk berhenti 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"
}
```
Ganti kode berikut:
- PROJECT_ID: ID project pemilik, yang merupakan project yang digunakan untuk membuat reservasi bersama.
- ZONE: zona tempat reservasi bersama berada.
- RESERVATION_NAME: nama reservasi bersama yang ada.
- CONSUMER_PROJECT_ID_1 dan CONSUMER_PROJECT_ID_2: ID dua project yang tidak ingin Anda ajak berbagi reservasi.

Mengubah jumlah VM yang dicadangkan dalam reservasi

Anda dapat mengubah reservasi yang ada untuk menambah atau mengurangi jumlah VM yang dicadangkan.

Sebelum mengubah jumlah VM yang dicadangkan dalam reservasi, pastikan hal berikut:

Jika Anda ingin meningkatkan jumlah VM yang dicadangkan dalam reservasi, pembatasan berikut berlaku:
- Harus ada resource yang memadai di zona tempat pemesanan berada.
- Anda harus memiliki kuota yang cukup untuk resource tambahan yang Anda reservasi.
Jika jenis konsumsi reservasi Anda 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:
- Hapus VM.
- Perbarui properti reservationAffinity di VM.
Jika tidak, Anda akan mengalami error .

Untuk mengubah jumlah VM yang dicadangkan dalam reservasi, gunakan Konsol Google Cloud, gcloud CLI, atau REST.

Konsol

Untuk mengubah jumlah VM yang dicadangkan dalam reservasi, ikuti langkah-langkah berikut:

Di Konsol Google Cloud, buka halaman Pemesanan.

Buka Pemesanan
Di kolom Nama, klik nama reservasi yang ingin diubah.

Halaman detail reservasi akan terbuka.
Klik Edit.
Di kolom Number of VM instances, masukkan jumlah VM terbaru yang akan dipesan.
Untuk mengonfirmasi, klik Save.

Mungkin perlu waktu beberapa detik untuk mengubah pemesanan Anda.

gcloud

Untuk mengubah jumlah VM yang dicadangkan dalam reservasi, gunakan perintah gcloud compute reservations update.

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

Ganti kode berikut:

RESERVATION_NAME: nama reservasi yang ada.
PROJECT_ID: ID project tempat reservasi berada.
NUMBER_OF_VMS: jumlah VM baru yang akan dicadangkan.
ZONE: zona tempat pemesanan berada.

REST

Untuk mengubah jumlah VM yang dicadangkan dalam reservasi, 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 reservasi berada.
ZONE: zona tempat pemesanan berada.
RESERVATION_NAME: nama reservasi yang ada.
NUMBER_OF_VMS: jumlah VM baru yang akan dicadangkan.

Mengubah properti lain di pemesanan

Untuk mengubah properti lain di reservasi yang sudah ada, lakukan tindakan berikut:

Buat single-project atau reservasi bersama baru dengan properti yang diperbarui.
Menghapus reservasi yang ada.

Memecahkan masalah

Pelajari cara memecahkan masalah terkait update reservasi.

Langkah selanjutnya

Pelajari cara melihat reservasi Anda.
Pelajari cara menggunakan pemesanan.
Pelajari cara menghapus reservasi.