Halaman ini menjelaskan cara melihat dan mengubah konfigurasi rekomendasi pemesanan on-demand yang kurang digunakan. Anda dapat mengubah konfigurasi untuk meningkatkan jumlah rekomendasi yang Anda terima, atau mendapatkan lebih sedikit rekomendasi untuk menghapus reservasi yang ingin Anda gunakan.
- Untuk 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 tidak digunakan secara optimal, lihat Melihat dan menerapkan rekomendasi reservasi yang tidak ada aktivitas atau Melihat dan menerapkan rekomendasi reservasi yang tidak digunakan secara optimal.
Sebelum memulai
-
Jika Anda belum melakukannya, siapkan autentikasi.
Autentikasi adalah
proses yang digunakan untuk memverifikasi identitas Anda agar dapat mengakses Google Cloud layanan dan API.
Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat mengautentikasi ke Compute Engine dengan memilih salah satu opsi berikut:
Select the tab for how you plan to use the samples on this page:
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
REST
Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Untuk informasi selengkapnya, lihat Mengautentikasi untuk menggunakan REST dalam Google Cloud dokumentasi autentikasi.
-
Mengonfigurasi rekomendasi Anda
Untuk mengonfigurasi rekomendasi reservasi yang kurang dimanfaatkan, lakukan hal berikut:
- Mendapatkan 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 reservasi yang kurang dimanfaatkan untuk project Anda menggunakan Google Cloud CLI atau REST.
Izin yang diperlukan untuk langkah ini
Untuk melakukan tugas ini, Anda harus memiliki izin berikut:
recommender.computeRightSizeResourceRecommender.get
pada project.
Selesaikan tugas ini menggunakan salah satu metode berikut.
Untuk mendapatkan parameter konfigurasi saat ini, gunakan
perintah gcloud recommender recommender-config describe
dan gunakan google.compute.RightSizeResourceRecommender
sebagai
ID 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 perekomendasikan, termasuk subkolom
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" }
Untuk mengambil konfigurasi saat ini, gunakan metode
recommenders.getConfig
dan tentukan google.compute.RightSizeResourceRecommender
sebagai
ID 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 perekomendasikannya 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 perekomendasikan, termasuk subkolom
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 nilai minimum 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 berlaku. Hingga saatnya tiba, setiap rekomendasi yang dihasilkan akan menggunakan konfigurasi sebelumnya.
Izin yang diperlukan untuk langkah ini
Untuk melakukan tugas ini, Anda harus memiliki izin berikut:
recommender.computeRightSizeResourceRecommender.get
di project untuk melihat konfigurasi.recommender.computeRightSizeResourceRecommender.update
di project untuk mengubah konfigurasi.
Selesaikan tugas ini menggunakan salah satu metode berikut.
Untuk memperbarui parameter konfigurasi, gunakan
perintah gcloud recommender recommender-config update
dan gunakan google.compute.RightSizeResourceRecommender
sebagai
ID 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 tempat Anda ingin mendapatkan konfigurasi saat iniCONFIG_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 diperbarui. Misalnya, untuk menentukan
periode pengamatan 21 hari dan nilai minimum pemesanan yang kurang dimanfaatkan
menjadi 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 menampilkan 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" }
Untuk memperbarui konfigurasi, buat permintaan PATCH
ke metode recommenders.updateConfig
dan tentukan google.compute.RightSizeResourceRecommender
sebagai ID 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 perekomendasikannya 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 ini, yang menampilkan
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.