Mengonfigurasi rekomendasi reservasi yang kurang dimanfaatkan

Halaman ini menjelaskan cara melihat dan mengubah konfigurasi rekomendasi reservasi sesuai permintaan yang kurang dimanfaatkan. Anda dapat mengubah konfigurasi untuk meningkatkan jumlah rekomendasi yang Anda terima, atau untuk mendapatkan lebih sedikit rekomendasi guna menghapus reservasi yang akan Anda gunakan.

Sebelum memulai

  • Siapkan autentikasi jika Anda belum melakukannya. Autentikasi memverifikasi identitas Anda untuk mengakses layanan Google Cloud dan API. Untuk menjalankan kode atau sampel dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine dengan memilih salah satu opsi berikut:

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

    gcloud

    1. Instal Google Cloud CLI. Setelah penginstalan, inisialisasi Google Cloud CLI dengan menjalankan perintah berikut: 

      gcloud init

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

  • Tetapkan 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.

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

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

Mengonfigurasi rekomendasi Anda

Untuk mengonfigurasi rekomendasi reservasi yang kurang dimanfaatkan, 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 pemesanan yang kurang dimanfaatkan untuk project Anda menggunakan Google Cloud CLI atau REST.

Selesaikan tugas ini menggunakan salah satu metode berikut.

gcloud

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

gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \
  --location=ZONE --billing-account=BILLING_ACCOUNT_ID

Ganti kode berikut:

  • ZONE dengan zona yang berisi reservasi untuk mencantumkan rekomendasi.
  • BILLING_ACCOUNT_ID dengan ID akun penagihan Anda.

Contoh:

gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \
  --location=us-central1-c --billing-account=my-billing-account-id

Perintah ini menampilkan konfigurasi pemberi rekomendasi, termasuk sub-bidang params.under_utilized_reservation_lookback_period dan params.under_utilized_reservation_utilization_threshold yang dapat diubah.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P7D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

REST

Untuk mengambil konfigurasi saat ini, gunakan metode recommenders.getConfig dan tentukan google.compute.RightSizeResourceRecommender sebagai ID Recommender:

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

Ganti kode berikut:

  • PROJECT_ID: ID project yang konfigurasi rekomendasinya ingin Anda ubah.
  • ZONE: zona yang berisi project Anda.

Dari command line, jalankan perintah berikut untuk mendapatkan konfigurasi recommender untuk 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.RightSizeResourceRecommender/config

Perintah ini menampilkan konfigurasi recommender, termasuk sub-kolom yang dapat Anda ubah: params.under_utilized_reservation_lookback_period dan params.under_utilized_reservation_utilization_threshold.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P7D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

Memperbarui konfigurasi untuk sebuah project

Untuk memperbarui konfigurasi rekomendasi reservasi yang kurang dimanfaatkan, ubah nilai untuk under_utilized_reservation_lookback_period dan upload konfigurasi baru untuk project Anda.

Anda dapat menetapkan periode pengamatan ke nilai 7 hari hingga 30 hari, menggunakan string yang diawali dengan P, lalu bilangan bulat untuk jumlah hari (minimum 7 dan maksimum 30), diikuti dengan D, misalnya:

  • Untuk periode pengamatan 7 hari, gunakan "P7D".
  • Untuk periode pengamatan 30 hari, gunakan "P30D".

Demikian pula, tetapkan batas penggunaan yang memicu rekomendasi reservasi yang kurang dimanfaatkan dengan mengubah nilai untuk under_utilized_reservation_utilization_threshold dan upload konfigurasi baru untuk project Anda, misalnya:

  • Untuk nilai minimum 80%, "0.8".

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

Selesaikan tugas ini menggunakan salah satu metode berikut.

gcloud

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

gcloud recommender recommender-config update google.compute.RightSizeResourceRecommender\
  --location=ZONE \
  --config-file=CONFIG_FILE_PATH \
  --etag=ETAG \
  --billing-account=BILLING_ACCOUNT_ID

Ganti kode berikut:

  • ZONE: zona yang konfigurasinya saat ini ingin Anda dapatkan
  • CONFIG_FILE_PATH: jalur ke file JSON dengan konfigurasi saat ini
  • ETAG: nilai etag konfigurasi saat ini
  • BILLING_ACCOUNT_ID: ID akun penagihan

Dalam file konfigurasi, tentukan hanya objek recommenderGenerationConfig dengan parameter konfigurasi yang telah diupdate. Misalnya, untuk menentukan periode pengamatan 21 hari dan nilai minimum pemesanan yang kurang dimanfaatkan sebesar 80%, gunakan file konfigurasi berikut:

{
  "params": {
    "under_utilized_reservation_lookback_period": "P21D",
    "under_utilized_reservation_utilization_threshold": "0.8"
  }
}

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

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P21D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

REST

Untuk mengupdate konfigurasi, buat permintaan PATCH ke metode recommenders.updateConfig dan tentukan google.compute.RightSizeResourceRecommender sebagai ID Pemberi Rekomendasi:

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

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P21D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\""
}

Ganti kode berikut:

  • PROJECT_ID: ID project yang konfigurasi rekomendasinya ingin Anda ubah.
  • 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.RightSizeResourceRecommender/config

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

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P21D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

Langkah berikutnya