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.
- Untuk mengetahui informasi selengkapnya tentang parameter yang dapat Anda gunakan untuk menyesuaikan rekomendasi, lihat Memilih parameter konfigurasi yang tepat.
- Untuk mengetahui informasi selengkapnya tentang cara mengambil tindakan saat Anda mendapatkan rekomendasi tentang reservasi yang tidak ada aktivitas atau kurang dimanfaatkan, lihat Melihat dan menerapkan rekomendasi reservasi yang tidak ada aktivitas atau Melihat dan menerapkan rekomendasi reservasi yang kurang dimanfaatkan.
Sebelum memulai
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses yang digunakan untuk memverifikasi identitas Anda untuk mengakses Trusted Cloud by S3NS 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:
gcloud
-
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
- Set a default region and zone.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, Anda menggunakan kredensial yang Anda berikan ke gcloud CLI.
Instal Google Cloud CLI, lalu login ke gcloud CLI dengan identitas gabungan Anda. Setelah login, lakukan inisialisasi Google Cloud CLI dengan menjalankan perintah berikut:
gcloud init
Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Trusted Cloud .
Mengonfigurasi rekomendasi Anda
Untuk mengonfigurasi rekomendasi reservasi yang kurang dimanfaatkan, lakukan hal berikut:
- Dapatkan konfigurasi saat ini untuk mendapatkan file JSON konfigurasi.
- Edit file konfigurasi dalam format JSON.
- 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 gunakangoogle.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 recommender, termasuk sub-bidang
params.under_utilized_reservation_lookback_period
danparams.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 tentukangoogle.compute.RightSizeResourceRecommender
sebagai ID Pemberi Rekomendasi: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 pemberi rekomendasi, termasuk sub-bidang yang dapat Anda ubah:
params.under_utilized_reservation_lookback_period
danparams.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 (minimum7
dan maksimum30
), diikuti denganD
, 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 gunakangoogle.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 dapatkanCONFIG_FILE_PATH
: jalur ke file JSON dengan konfigurasi saat iniETAG
: nilai etag konfigurasi saat iniBILLING_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 metoderecommenders.updateConfig
dan tentukangoogle.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
- Pelajari cara melihat dan menerapkan rekomendasi pemesanan yang tidak ada aktivitas.
- Pelajari cara melihat dan menerapkan rekomendasi pemesanan yang kurang dimanfaatkan.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-19 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-19 UTC."],[[["\u003cp\u003eThis page explains how to configure underutilized reservation recommendations, which are Pre-GA products available "as is" with potentially limited support.\u003c/p\u003e\n"],["\u003cp\u003eYou can modify the configuration to adjust the number of recommendations received by altering parameters like the lookback period (7-30 days) and utilization threshold.\u003c/p\u003e\n"],["\u003cp\u003eConfiguration changes require getting the current configuration in JSON format, editing it, and then uploading the updated file using either the Google Cloud CLI or REST API.\u003c/p\u003e\n"],["\u003cp\u003eTo update the configuration you must have \u003ccode\u003erecommender.computeRightSizeResourceRecommender.get\u003c/code\u003e to view, and \u003ccode\u003erecommender.computeRightSizeResourceRecommender.update\u003c/code\u003e permissions to modify.\u003c/p\u003e\n"],["\u003cp\u003eAfter uploading a new configuration, it will take approximately 48 hours for the changes to become effective and to be used to generate any new recommendations.\u003c/p\u003e\n"]]],[],null,[]] -