Mengonfigurasi rekomendasi reservasi saat tidak ada aktivitas

Halaman ini menjelaskan cara melihat dan mengubah konfigurasi akun nonaktif, rekomendasi reservasi on-demand. Anda mungkin ingin memodifikasi konfigurasi untuk meningkatkan jumlah rekomendasi yang Anda terima, atau mendapatkan lebih sedikit rekomendasi penghapusan reservasi yang akan Anda gunakan.

Sebelum memulai

  • Jika Anda belum melakukannya, siapkan autentikasi. Authentication adalah proses yang digunakan untuk memverifikasi identitas Anda agar dapat mengakses layanan dan API Google Cloud. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine sebagai berikut.

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

    gcloud

    1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut: 

      gcloud init
    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.

      Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut: 

      gcloud init

Mengonfigurasi rekomendasi Anda

Untuk mengonfigurasi rekomendasi reservasi tidak ada aktivitas, lakukan hal berikut:

  1. Dapatkan konfigurasi saat ini untuk mendapatkan file JSON konfigurasi.
  2. Edit file konfigurasi dalam format JSON.
  3. Upload file konfigurasi baru untuk menerapkan perubahan.

Mendapatkan konfigurasi saat ini

Anda dapat memperoleh konfigurasi saat ini untuk rekomendasi reservasi saat tidak ada aktivitas untuk project Anda dengan menggunakan Google Cloud CLI atau REST.

gcloud

Untuk mendapatkan parameter konfigurasi saat ini, gunakan metode Perintah gcloud recommender recommender-config describe dan gunakan google.compute.IdleResourceRecommender sebagai ID Pemberi Rekomendasi:

gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \
  --location=ZONE

Ganti ZONE dengan zona yang ingin Anda dapatkan konfigurasi saat ini.

Contoh:

gcloud recommender recommender-config describe google.compute.IdleResourceRecommender \
  --location=us-central1-c

Perintah tersebut menampilkan konfigurasi pemberi rekomendasi, termasuk subkolom params.observation_period.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "observation_period": "604800s"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

REST

Untuk mengambil konfigurasi saat ini, gunakan metode recommenders.getConfig dan menetapkan google.compute.IdleResourceRecommender sebagai ID Pemberi Rekomendasi:

GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config

Ganti ZONE dengan zona yang berisi project Anda.

Dari command line, jalankan perintah berikut untuk mendapatkan pemberi rekomendasi untuk sebuah project:

PROJECT_ID=PROJECT_ID
ZONE=ZONE
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: ${PROJECT_ID}" \
https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.IdleResourceRecommender/config

Perintah tersebut menampilkan konfigurasi pemberi rekomendasi, termasuk subkolomnya yang dapat Anda ubah: params.observation_period.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "observation_period": "604800s"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

Memperbarui konfigurasi untuk sebuah project

Untuk memperbarui konfigurasi rekomendasi reservasi tidak ada aktivitas Anda, ubah untuk observation_period, lalu upload konfigurasi baru untuk project Anda.

Anda dapat menetapkan periode pengamatan ke nilai antara 1 hari dan 14 hari, menggunakan string dengan jumlah total detik yang diikuti dengan huruf s.

  • Untuk periode observasi selama 7 hari, gunakan "604800s".
  • Untuk periode observasi selama 30 hari, gunakan "2592000s".

Setelah Anda mengupload konfigurasi baru, perlu waktu sekitar 48 jam untuk melakukannya agar diterapkan. Hingga saatnya tiba, setiap rekomendasi yang dihasilkan akan menggunakan konfigurasi sebelumnya.

gcloud

Untuk memperbarui parameter konfigurasi, gunakan Perintah gcloud recommender recommender-config update dan gunakan google.compute.IdleResourceRecommender sebagai ID Pemberi Rekomendasi:

gcloud recommender recommender-config update google.compute.IdleResourceRecommender\
  --location=ZONE \
  --config-file=CONFIG_FILE_PATH \
  --etag=ETAG

Ganti kode berikut:

  • ZONE: zona tempat Anda ingin mendapatkan konfigurasi saat ini
  • CONFIG_FILE_PATH: jalur ke file JSON dengan konfigurasi saat ini
  • ETAG: nilai etag konfigurasi saat ini

Di file konfigurasi Anda, hanya tentukan recommenderGenerationConfig dengan parameter konfigurasi yang diupdate. Misalnya, untuk menentukan periode pengamatan selama 21 hari, gunakan file konfigurasi berikut:

{
  "params": {
    "observation_period": "1814400s"
  }
}

Jika berhasil, perintah akan menampilkan isi respons yang mirip dengan berikut ini, menunjukkan konfigurasi baru dengan parameter yang baru saja Anda diubah.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "observation_period": "1814400s"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

REST

Untuk mengupdate konfigurasi, buat permintaan PATCH ke recommenders.updateConfig dan menetapkan google.compute.IdleResourceRecommender sebagai ID Pemberi Rekomendasi:

PATCH https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "observation_period": "1814400s"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\""
}

Ganti kode berikut:

  • PROJECT_ID: ID project yang Anda ingin mengubah konfigurasi pemberi rekomendasi.
  • ZONE: zona yang berisi project Anda.

Simpan isi permintaan dalam file, misalnya config.json. Selanjutnya, Anda dapat mereferensikan file tersebut saat memperbarui konfigurasi pemberi rekomendasi untuk project Anda menggunakan perintah yang mirip dengan berikut ini:

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "x-goog-user-project: ${PROJECT_ID}" \
-d @config.json \
https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.IdleResourceRecommender/config

Perintah POST menampilkan isi respons yang mirip dengan yang berikut ini, yang menunjukkan konfigurasi baru dengan parameter yang baru saja Anda ubah.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "observation_period": "1814400s"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

Langkah selanjutnya