Pemberi rekomendasi project tanpa pengawasan

Pemberi rekomendasi project tanpa pengawasan menganalisis aktivitas penggunaan di project dalam organisasi Anda dan memberikan rekomendasi yang membantu Anda menemukan, mengklaim kembali, atau menghapus project tanpa pengawasan.

Ringkasan

Di organisasi yang bergerak cepat, bukan hal yang aneh jika resource cloud, termasuk seluruh project, terkadang terlupakan. Resource yang tidak diawasi seperti itu sulit diidentifikasi dan cenderung menyebabkan pemborosan yang tidak perlu serta risiko keamanan.

Pemberi rekomendasi project tanpa pengawasan menganalisis aktivitas penggunaan di semua project dalam organisasi Anda dan menyediakan fitur-fitur berikut untuk membantu Anda menemukan, mengklaim kembali, dan menghentikan project tanpa pengawasan:

• Insight penggunaan untuk setiap project (jaringan, API, pemilik project, aktivitas layanan, dan lainnya).
• Rekomendasi untuk menonaktifkan project yang memiliki aktivitas penggunaan rendah.
• Rekomendasi untuk menetapkan pemilik baru ke project yang memiliki aktivitas penggunaan tinggi, tetapi tidak memiliki pemilik aktif.

Menghentikan atau mengklaim kembali project tanpa pengawasan dapat memberikan dampak dan manfaat berikut bagi organisasi Anda:

• Pengurangan risiko keamanan (SECURITY)
• Pengurangan pembelanjaan yang tidak perlu (COST)
• Pengurangan jejak karbon yang terkait dengan workload Anda (SUSTAINABILITY)

Catatan: Pemberi rekomendasi project tanpa pengawasan hanya dapat digunakan untuk project yang ditetapkan ke organisasi.

Google Cloud

Cara kerjanya

Pemberi rekomendasi project tanpa pengawasan menganalisis penggunaan project selama 30 hari terakhir. Tabel berikut mencantumkan rekomendasi dan insight yang dapat dihasilkan oleh pemberi rekomendasi project tanpa pengawasan berdasarkan apakah aktivitas penggunaan rendah atau tinggi .

Penggunaan/jenis project	Subjenis insight	Rekomendasi	Subjenis rekomendasi
Project dengan: Penggunaan rendah selama 30 hari terakhir	PROJECT_ACTIVITY	Tinjau atau hapus project.	CLEANUP_PROJECT
Project dengan: Penggunaan tinggi selama 30 hari terakhir Pemilik pengguna ditetapkan, tetapi tidak ada yang aktif dalam project.	PROJECT_ACTIVITY	Klaim kembali project dengan menetapkan pemilik baru.	RECLAIM_PROJECT
Semua project non-Apps Script lainnya.	PROJECT_ACTIVITY	-	-

Catatan: Pemberi rekomendasi project tanpa pengawasan tidak menghasilkan insight atau rekomendasi apa pun untuk project Apps Script karena project ini dihapus secara otomatis setelah penghapusan skrip terkait.

Rekomendasi dan Insight tersedia di berbagai tingkat Hierarki Organisasi Cloud Anda. Untuk mengakses rekomendasi dan insight tersebut, Anda memerlukan binding peran IAM di tingkat yang sesuai:

• Di tingkat Project: Pemilik Project dapat menemukan dan menindaklanjuti insight dan rekomendasi untuk project yang dapat mereka akses.
• Di tingkat Organisasi: Administrator Organisasi dapat menemukan dan menindaklanjuti insight dan rekomendasi untuk project dalam organisasi cloud.
• Di tingkat Akun Penagihan: Administrator Penagihan dapat menemukan dan menindaklanjuti insight dan rekomendasi untuk project yang terkait dengan akun penagihan tertentu.

Catatan: Jumlah Insight dan Rekomendasi per Organisasi atau Akun Penagihan saat ini dibatasi hingga 10.000. Jika Organisasi atau Akun Penagihan Anda mencakup lebih dari 10.000 project dan Anda ingin meninjau seluruh rangkaian rekomendasi dan insight, sebaiknya Anda mengandalkan insight dan rekomendasi tingkat Project atau menggunakan ekspor insight dan rekomendasi BigQuery.

Menyusun peringkat aktivitas penggunaan project

Project dapat diberi peringkat untuk memiliki aktivitas penggunaan yang rendah atau tinggi, berdasarkan rekomendasi yang diberikan. Peringkat aktivitas penggunaan project dihitung berdasarkan konten yang disertakan dalam insight pemanfaatan project.

Untuk project yang diidentifikasi memiliki aktivitas penggunaan rendah, kondisi berikut berlaku:

Klasifikasi penggunaan	Kondisi
Organisasi yang memiliki lebih dari 50 project	Project diberi peringkat berdasarkan tingkat aktivitas penggunaan di semua konten yang disertakan dalam insight pemanfaatan project. Project diklasifikasikan sebagai tanpa pengawasan jika termasuk dalam 10% aktivitas penggunaan dibandingkan dengan semua project lain dalam organisasi tersebut.
Organisasi yang memiliki kurang dari 50 project	Rata-rata harian panggilan API yang digunakan oleh project (consumedApiDailyCount) kurang dari 100. Cloud Logging adalah satu-satunya layanan yang digunakan oleh project. Semua insight pemanfaatan project lainnya memiliki nilai yang sama dengan nol.

Catatan: Rekomendasi hanya diberikan untuk project yang sudah berusia lebih dari 30 hari.

Prioritas dan dampak rekomendasi

Rekomendasi project yang tidak diawasi berisi kolom berikut yang membantu memprioritaskan dan memperkirakan manfaat penerapannya:

• priority - Nilai prioritas antara P1-P4, dengan P1 sebagai prioritas tertinggi.
• primaryImpact - SECURITY. Jumlah rekomendasi keamanan berprioritas tinggi dalam project tanpa pengawasan.
• additionalImpact(s) - COST dan SUSTAINABILITY. Pengurangan biaya ($) dan emisi keberlanjutan (kgCO₂e) yang akan diperoleh jika project dihapus.

Prioritas rekomendasi

Prioritas rekomendasi project tanpa pengawasan berkisar dari P1 hingga P4, dengan P1 sebagai prioritas tertinggi.

Pemberi rekomendasi memulai dengan meninjau rekomendasi keamanan di setiap project yang tidak diawasi. Dari sana, rekomendasi proyek yang tidak diawasi akan ditetapkan prioritasnya sama dengan rekomendasi prioritas tertinggi yang ditemukan dalam proyek. Misalnya, jika project tanpa pengawasan memiliki 10 rekomendasi keamanan, delapan rekomendasi P2 dan dua rekomendasi P1, rekomendasi project tanpa pengawasan akan diberi nilai prioritas P1.

Rekomendasi keamanan yang paling sering muncul dalam project yang tidak diawasi berasal dari IAM Recommender. Rekomendasi project tanpa pengawasan dengan prioritas P1 kemungkinan berarti ada bucket penyimpanan cloud yang dapat diakses publik di project tanpa pengawasan tersebut (pelajari lebih lanjut cara IAM Recommender menetapkan prioritas).

Dampak keamanan

Kolom primaryImpact - SECURITY menawarkan securityProjection yang sama dengan jumlah rekomendasi keamanan berprioritas tinggi (P2 dan yang lebih tinggi) dalam project yang tidak diawasi. Misalnya, saat project memiliki rekomendasi untuk mengganti peran Editor yang luas dengan peran yang lebih terperinci, rekomendasi tersebut memiliki prioritas P2 dan dihitung dalam priorityRecommendationCount.

Dampak Biaya

Kolom additionalImpact - COST menawarkan costProjection yang merupakan perkiraan penghematan biaya jika project yang tidak diawasi dihapus. Estimasi ini didasarkan pada biaya yang dikeluarkan dari resource yang berjalan di project yang tidak diawasi selama 30 hari terakhir.

Catatan: Untuk melihat harga kustom dalam proyeksi biaya, akun penagihan cloud terkait tidak boleh berubah dalam 30 hari terakhir, dan pengguna harus memiliki izin penagihan.

Dampak keberlanjutan

Kolom additionalImpact - SUSTAINABILITY menawarkan sustainabilityProjection yang merupakan estimasi emisi karbon yang dihasilkan oleh resource yang berjalan dalam project tanpa pengawasan selama 30 hari terakhir. Estimasi diukur dalam kilogram setara karbon dioksida (kgCO₂e).

Isi insight pemanfaatan project

Isi insight pemanfaatan project adalah nilai kolom yang digunakan untuk memberi peringkat aktivitas penggunaan project dan membuat rekomendasi CLEANUP_PROJECT dan/atau RECLAIM_PROJECT.

Peringatan: Insight pemanfaatan project dibuat untuk semua project, terlepas dari apakah project tersebut tanpa pengawasan atau tidak. Insight ini dibuat setiap hari. Satu insight saja bukanlah indikator yang andal agar suatu project dianggap sebagai project tanpa pengawasan. Jangan menghapus project berdasarkan insight satu hari.

Tabel berikut mencantumkan berbagai kolom yang ditampilkan pemberi rekomendasi sebagai bagian dari insight PROJECT_ACTIVITY:

Kolom	Deskripsi
Tingkat penggunaan
usagePercentile	Persentil tingkat penggunaan project ini dibandingkan dengan project lain dalam organisasi yang sama. Jika persentil adalah -1, berarti nilai tidak dihitung. Nilai tidak dihitung jika organisasi memiliki kurang dari 50 project.
Aktivitas API
activeServiceAccountDailyCount	Rata-rata harian akun layanan dengan aktivitas autentikasi dalam project ini.
apiClientDailyCount	Rata-rata harian klien unik panggilan API yang dihasilkan oleh project ini.
consumedApiDailyCount	Rata-rata harian panggilan API yang digunakan oleh project ini.
datastoreApiDailyCount	Rata-rata harian panggilan Datastore API yang digunakan oleh project ini
Aktivitas jaringan
vpcEgressDailyBytes	Rata-rata harian byte keluar VPC dari project ini.
vpcIngressDailyBytes	Rata-rata harian byte ingress VPC ke project ini
Penggunaan penagihan
hasBillingAccount	Memeriksa apakah project memiliki akun penagihan di akhir pengamatan
serviceWithBillableUsage	Nama layanan yang dapat ditagih yang digunakan dalam 30 hari terakhir.
Penggunaan layanan cloud
activeAppengineInstanceDailyCount: system/instance_count	Rata-rata harian jumlah instance App Engine aktif dalam project ini
activeCloudsqlInstanceDailyCount	Rata-rata harian jumlah instance Cloud SQL aktif dalam project ini.
activeGceInstanceDailyCount	Rata-rata harian jumlah instance Compute Engine aktif dalam project ini.
bigqueryInflightJobDailyCount	Rata-rata harian tugas BigQuery yang sedang berjalan dalam project ini.
bigqueryInflightQueryDailyCount	Rata-rata harian jumlah kueri BigQuery dalam proses di project ini.
bigqueryStorageDailyBytes	Rata-rata harian penyimpanan BigQuery dalam proses di project ini.
bigqueryTableDailyCount	Rata-rata harian jumlah tabel BigQuery dalam project ini.
gcsObjectDailyCount	Rata-rata harian jumlah objek Cloud Storage dalam project ini.
gcsRequestDailyCount	Rata-rata harian jumlah Cloud Storage API dalam project ini.
gcsStorageDailyBytes	Rata-rata harian byte penyimpanan yang digunakan oleh Cloud Storage dalam project ini.
Aktivitas pengguna
numActiveUserOwners	Jumlah pemilik project jenis pengguna aktif di akhir periode pengamatan. Aktif berarti akun pengguna tidak dinonaktifkan dan ada beberapa aktivitas yang diidentifikasi dalam project ini selama periode pengamatan.
owners	Daftar pemilik project dan aktivitas mereka
Kolom lainnya
hasActiveOauthTokens	Memeriksa apakah project memiliki token OAuth aktif yang digunakan dalam 180 hari terakhir.
carbonFootprintDailyKgCO2	Rata-rata harian emisi karbon yang dihasilkan oleh project ini berdasarkan data 30 hari terakhir yang tersedia.
costProjection	Proyeksi penghematan biaya untuk durasi yang ditentukan jika project dihapus. Harga kustom atau harga jual ditampilkan berdasarkan izin akun penagihan. Estimasi ini didasarkan pada data yang tersedia selama 30 hari terakhir dan bukan merupakan tagihan.
severity	severity disetel ke nilai yang sesuai dengan insight keamanan tingkat keparahan tertinggi yang ditemukan dalam project. Misalnya, berdasarkan cara IAM Recommender menetapkan tingkat keparahan untuk insight-nya, tingkat keparahan CRITICAL pada insight project yang tidak diawasi kemungkinan berarti ada bucket Cloud Storage yang dapat diakses publik dalam project yang tidak diawasi.

Rekomendasi untuk menghapus project

Project direkomendasikan untuk dihapus jika memiliki penggunaan rendah dalam 30 hari terakhir dan tidak ada token OAuth yang digunakan dalam 180 hari terakhir.

Peringatan: Periksa dengan cermat insight penggunaan yang terkait dengan project. Menghapus project dapat menyebabkan hilangnya data yang tidak dapat dibatalkan. Untuk mengetahui informasi selengkapnya, lihat Menonaktifkan (menghapus) project.

Perhatian: Rekomendasi diberikan untuk project tenant. Menghapus project ini dapat menyebabkan kehilangan data karena kolom penggunaan project tambahan yang tidak dicatat untuk project ini.

Rekomendasi untuk menetapkan pemilik baru ke project

Sebaiknya tetapkan pemilik baru ke project jika project tersebut memenuhi semua kondisi seperti yang tercantum di bawah:

• Semua pemilik yang ditetapkan tidak aktif di project selama 90 hari terakhir atau tidak lagi bekerja di perusahaan.
• Project memiliki aktivitas penggunaan yang tinggi.

Catatan: Jika project tidak memiliki pemilik pengguna yang ditetapkan, hal ini dianggap sebagai perilaku yang diinginkan di mana rekomendasi RECLAIM_PROJECT tidak diberikan.

Harga

Untuk mengetahui detail selengkapnya tentang harga Active Assist, lihat harga pemberi rekomendasi.

Sebelum memulai

Sebelum dapat melihat insight dan rekomendasi, Anda harus melakukan hal berikut:

• Anda harus mengaktifkan Recommender API. Anda hanya perlu mengaktifkan API di satu project penagihan. Anda kemudian dapat menggunakan project penagihan yang sama ini untuk memeriksa rekomendasi dan insight untuk project lain, seluruh organisasi, atau akun penagihan, menggunakan fungsi gcloud/API.--billing-project
• Pastikan Anda telah diberi salah satu peran yang diperlukan berikut:

Deskripsi	Peran
Lihat rekomendasi	recommender.projectUtilViewer
Melihat dan memperbarui rekomendasi	recommender.projectUtilAdmin
Memilih tidak ikut serta dalam insight dan rekomendasi di Pusat Transparansi dan Kontrol	dataprocessing.admin

Peran ini memberikan serangkaian izin yang memungkinkan Anda mengakses insight dan rekomendasi. Untuk mengetahui informasi selengkapnya tentang peran, lihat memahami peran dan memberikan izin IAM.

Dengan memberikan peran ini di tingkat Organisasi, Anda dapat mengakses rekomendasi dan insight untuk project dalam organisasi secara individual, atau secara kolektif (semua project yang tidak dipantau dalam organisasi) menggunakan API tingkat Organisasi.

Dengan memberikan peran ini di tingkat Akun Penagihan, Anda dapat mengakses rekomendasi dan insight untuk project yang menggunakan akun penagihan tertentu.

Untuk mengetahui informasi selengkapnya tentang cara menonaktifkan, lihat menonaktifkan insight dan rekomendasi.

ID Pemberi Rekomendasi

Berikut adalah ID dan jenis insight pemberi rekomendasi project tanpa pengawasan:

• google.resourcemanager.projectUtilization.Recommender
• google.resourcemanager.projectUtilization.Insight

Izin IAM yang diperlukan

Untuk mengakses daftar rekomendasi dan insight, izin berikut diperlukan:

• recommender.resourcemanagerProjectUtilizationRecommendations.get
• recommender.resourcemanagerProjectUtilizationRecommendations.list
• recommender.resourcemanagerProjectUtilizationInsights.get
• recommender.resourcemanagerProjectUtilizationInsights.list

Untuk memperbarui rekomendasi dan insight (misalnya, untuk menolak rekomendasi), izin berikut diperlukan:

• recommender.resourcemanagerProjectUtilizationRecommendations.update
• recommender.resourcemanagerProjectUtilizationInsights.update

Melihat rekomendasi project tanpa pengawasan

Bagian ini menjelaskan cara memeriksa insight dan rekomendasi tanpa pengawasan menggunakan gcloud, dan menggunakan curl untuk mengirim permintaan ke Recommender API.

gcloud

Untuk melihat rekomendasi dan insight menggunakan gcloud, ikuti langkah-langkah di bawah. Untuk informasi selengkapnya, lihat Menggunakan API - Insight dan Menggunakan API - Rekomendasi.

Rekomendasi

1. Untuk mencantumkan rekomendasi project tanpa pengawasan untuk project tempat Anda mengaktifkan Recommender API, jalankan perintah berikut:

     gcloud recommender recommendations list \
     --project=PROJECT_ID \
     --location=global \
     --recommender=google.resourcemanager.projectUtilization.Recommender
   

   Ganti kode berikut:

   • PROJECT_ID: Project ID.

2. Untuk mencantumkan rekomendasi project tanpa pengawasan di project lain saat menggunakan project tempat Anda mengaktifkan Recommender API (seperti pada langkah sebelumnya), jalankan perintah berikut:

     gcloud recommender recommendations list \
     --billing-project=BILLING_PROJECT_ID \
     --project=PROJECT_ID \
     --location=global \
     --recommender=google.resourcemanager.projectUtilization.Recommender
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang telah Anda aktifkan dengan Recommender API (ID ini akan sama dengan PROJECT_ID yang diberikan pada langkah sebelumnya).
   • PROJECT_ID: ID project lain yang rekomendasinya ingin Anda lihat.
   Catatan: Jika perintah tidak menampilkan rekomendasi apa pun, berarti project tersebut tidak tanpa pengawasan atau belum ada selama 30 hari atau lebih.

3. Untuk mencantumkan rekomendasi project tanpa pengawasan untuk seluruh organisasi, sambil menggunakan project tempat Anda mengaktifkan Recommender API (seperti pada langkah sebelumnya), jalankan perintah berikut:

     gcloud recommender recommendations list \
     --billing-project=BILLING_PROJECT_ID \
     --organization=ORGANIZATION_ID \
     --location=global \
     --recommender=google.resourcemanager.projectUtilization.Recommender
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang telah Anda aktifkan dengan Recommender API (ini akan menjadi PROJECT_ID yang sama seperti yang diberikan pada langkah sebelumnya).
   • ORGANIZATION_ID: ID Organisasi yang rekomendasi project tanpa pengawasan ingin Anda lihat.

4. Untuk mencantumkan rekomendasi project yang tidak diawasi yang menggunakan Akun Penagihan tertentu, sambil menggunakan project tempat Anda mengaktifkan Recommender API (seperti pada langkah sebelumnya), jalankan perintah berikut:

     gcloud recommender recommendations list \
     --billing-project=BILLING_PROJECT_ID \
     --billing-account=BILLING_ACCOUNT_ID \
     --location=global \
     --recommender=google.resourcemanager.projectUtilization.Recommender
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang telah Anda aktifkan dengan Recommender API (ini akan menjadi PROJECT_ID yang sama seperti yang diberikan pada langkah sebelumnya).
   • BILLING_ACCOUNT_ID: ID Google Cloud Akun Penagihan Anda.

Catatan: Anda dapat meluaskan detail Rekomendasi dari perintah daftar dengan menambahkan tanda --format=yaml di bagian akhir.

Insight

1. Untuk mencantumkan insight penggunaan untuk project tertentu, jalankan perintah berikut:

     gcloud recommender insights list \
     --project=PROJECT_ID \
     --location=global \
     --insight-type=google.resourcemanager.projectUtilization.Insight
   

   Ganti kode berikut:

   • PROJECT_ID: Project ID.

2. Untuk mencantumkan insight penggunaan project lain, sambil menggunakan project tempat Anda mengaktifkan Recommender API (seperti pada langkah sebelumnya), jalankan perintah berikut:

     gcloud recommender insights list \
     --billing-project=BILLING_PROJECT_ID \
     --project=PROJECT_ID \
     --location=global \
     --insight-type=google.resourcemanager.projectUtilization.Insight
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang telah Anda aktifkan dengan Recommender API (ID ini akan sama dengan PROJECT_ID yang diberikan pada langkah sebelumnya).
   • PROJECT_ID: ID project lain yang ingin Anda lihat insight pemberi rekomendasinya yang tidak diawasi.

3. Untuk mencantumkan insight penggunaan seluruh organisasi, sambil menggunakan project tempat Anda mengaktifkan Recommender API (seperti pada langkah sebelumnya), jalankan perintah berikut:

     gcloud recommender insights list \
     --billing-project=BILLING_PROJECT_ID \
     --organization=ORGANIZATION_ID \
     --location=global \
     --insight-type=google.resourcemanager.projectUtilization.Insight
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang telah Anda aktifkan dengan Recommender API (ini akan menjadi PROJECT_ID yang sama seperti yang diberikan pada langkah sebelumnya).
   • ORGANIZATION_ID: ID Organisasi yang ingin Anda lihat insight penggunaannya.

4. Untuk mencantumkan insight penggunaan yang menggunakan Akun Penagihan tertentu, sambil menggunakan project tempat Anda mengaktifkan Recommender API (seperti pada langkah sebelumnya), jalankan perintah berikut:

     gcloud recommender insights list \
     --billing-project=BILLING_PROJECT_ID \
     --billing-account=BILLING_ACCOUNT_ID \
     --location=global \
     --insight-type=google.resourcemanager.projectUtilization.Insight
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang telah Anda aktifkan dengan Recommender API (ini akan menjadi PROJECT_ID yang sama seperti yang diberikan pada langkah sebelumnya).
   • BILLING_ACCOUNT_ID: ID Google Cloud Akun Penagihan Anda.

Catatan: Anda dapat meluaskan detail Insight dari perintah daftar dengan menambahkan tanda --format=yaml di bagian akhir.

API

Untuk melihat rekomendasi dan insight, Anda dapat menggunakan curl untuk mengirim permintaan ke API recommender. Untuk mengizinkan permintaan dari command line, Anda menggunakan token akses OAuth. Token akses OAuth adalah string yang memberikan akses sementara ke API.

Catatan: Jika Anda belum memahami prasyarat autentikasi untuk memanggil API Google Cloud , lihat Ringkasan autentikasi.

Rekomendasi

1. Untuk mencantumkan rekomendasi project tanpa pengawasan untuk project tempat Anda mengaktifkan Recommender API, jalankan perintah berikut:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global/\
   recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"
   

   Ganti kode berikut:

   • PROJECT_ID`: Project ID.
   Catatan: Jika panggilan API tidak menampilkan rekomendasi apa pun, project tersebut tidak tanpa pengawasan atau belum ada selama 30 hari atau lebih.

2. Untuk mencantumkan rekomendasi project tanpa pengawasan di project lain saat menggunakan project tempat Anda mengaktifkan Recommender API (seperti pada langkah sebelumnya), jalankan perintah berikut:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: BILLING_PROJECT_ID" \
   "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global/\
   recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang telah Anda aktifkan dengan Recommender API (ID ini akan sama dengan PROJECT_ID yang diberikan pada langkah sebelumnya).
   • PROJECT_ID: ID project lain yang rekomendasinya ingin Anda lihat.

3. Untuk mencantumkan rekomendasi project tanpa pengawasan untuk seluruh organisasi, sambil menggunakan project tempat Anda mengaktifkan Recommender API (seperti pada langkah sebelumnya), jalankan perintah berikut:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: BILLING_PROJECT_ID" \
   "https://recommender.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/\
   recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang telah Anda aktifkan dengan Recommender API (ID ini akan sama dengan PROJECT_ID yang diberikan pada langkah sebelumnya).
   • ORGANIZATION_ID: ID Organisasi yang rekomendasi project tanpa pengawasan ingin Anda lihat.

4. Untuk mencantumkan rekomendasi project yang tidak diawasi yang menggunakan Akun Penagihan tertentu, sambil menggunakan project tempat Anda mengaktifkan Recommender API (seperti pada langkah sebelumnya), jalankan perintah berikut:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: BILLING_PROJECT_ID" \
   "https://recommender.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/locations/global/\
   recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang telah Anda aktifkan dengan Recommender API (ID ini akan sama dengan PROJECT_ID yang diberikan pada langkah sebelumnya).
   • BILLING_ACCOUNT_ID: ID Google Cloud Akun Penagihan Anda.

Insight

1. Untuk mencantumkan insight penggunaan untuk project tertentu, jalankan perintah berikut:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/global\
   /insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
   

   Ganti kode berikut:

   • PROJECT_ID`: Project ID.

2. Untuk mencantumkan insight penggunaan project lain, sambil menggunakan project tempat Anda mengaktifkan Recommender API (seperti pada langkah sebelumnya), jalankan perintah berikut:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "x-goog-user-project: BILLING_PROJECT_ID/" \
   "https://recommender.googleapis.com/v1/projects/PROJECT_ID//locations/global\
   /insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang telah Anda aktifkan dengan Recommender API (ID ini akan sama dengan PROJECT_ID yang diberikan pada langkah sebelumnya).
   • PROJECT_ID: ID project lain yang ingin Anda lihat insight pemberi rekomendasinya yang tidak diawasi.

3. Untuk mencantumkan insight penggunaan seluruh organisasi, sambil menggunakan project tempat Anda mengaktifkan Recommender API (seperti pada langkah sebelumnya), jalankan perintah berikut:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: PROJECT_ID/" \
   "https://recommender.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/global/\
   insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang telah Anda aktifkan dengan Recommender API (ID ini akan sama dengan PROJECT_ID yang diberikan pada langkah sebelumnya).
   • ORGANIZATION_ID: ID Organisasi yang rekomendasi project tanpa pengawasan ingin Anda lihat.

4. Untuk mencantumkan insight penggunaan yang menggunakan Akun Penagihan tertentu, sambil menggunakan project tempat Anda mengaktifkan Recommender API (seperti pada langkah sebelumnya), jalankan perintah berikut:

   curl \
   -H "Authorization: Bearer $(gcloud auth print-access-token)"  \
   -H "x-goog-user-project: PROJECT_ID/" \
   "https://recommender.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/locations/global/\
   insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang telah Anda aktifkan dengan Recommender API (ID ini akan sama dengan PROJECT_ID yang diberikan pada langkah sebelumnya).
   • BILLING_ACCOUNT_ID: ID Google Cloud Akun Penagihan Anda.

Mengonfigurasi parameter rekomendasi

Bagian ini menjelaskan cara melihat dan mengonfigurasi pemberi rekomendasi ini menggunakan gcloud dan curl.

Tabel berikut mencantumkan berbagai parameter yang dapat dikonfigurasi:

Parameter	Deskripsi	Nilai yang Diharapkan
minimum_observation_period	Periode pengamatan minimum menentukan jumlah hari aktivitas Project yang akan dianalisis, sebelum Rekomendasi dibuat. Saat ini, nilai ini hanya dapat ditetapkan di tingkat Organisasi.	"P30D"[DEFAULT], "P60D", "P90D", "P180D", "P270D", "P365D"

gcloud

Untuk melihat dan memperbarui konfigurasi pemberi rekomendasi menggunakan gcloud, ikuti langkah-langkah di bawah.

Melihat konfigurasi

1. Untuk melihat konfigurasi Pemberi Rekomendasi Project Tanpa Pengawasan untuk organisasi tertentu, jalankan perintah berikut dari project milik organisasi tersebut yang telah mengaktifkan Recommender API:

   gcloud beta recommender recommender-config describe \
   google.resourcemanager.projectUtilization.Recommender \
   --organization=ORGANIZATION_ID \
   --location=global
   

   Ganti kode berikut:

   • ORGANIZATION_ID: ID organisasi.

2. Contoh Output:

   etag: ETAG
   name: organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config
   recommenderGenerationConfig:
     params:
       minimum_observation_period: P30D
   revisionId: DEFAULT
   updateTime: '2022-04-19T00:57:55Z'
   

   Perhatikan nilai ETAG:

   • ETAG: Nilai ini akan digunakan di recommender-config update.

Memperbarui konfigurasi

1. Untuk memperbarui konfigurasi Unattended Project Recommender untuk organisasi tertentu, pilih project milik organisasi tersebut tempat Anda telah mengaktifkan Recommender API, buat file config.gcloud:

   
   {
    "params": {
       "minimum_observation_period": DURATION
     }
   }
   

   Ganti kode berikut:

   • DURATION: Satu nilai dari "P30D", "P60D", "P90D", "P180D", "P270D", "P365D"

2. Jalankan perintah berikut:

   gcloud beta recommender recommender-config update \
   google.resourcemanager.projectUtilization.Recommender \
   --organization=ORGANIZATION_ID \
   --location=global \
   --config-file=config.gcloud \
   --etag=ETAG
   

   Ganti kode berikut:

   • ORGANIZATION_ID: ID organisasi.
   • ETAG: Nilai etag yang ditampilkan dari recommender-config describe.

API

Untuk melihat dan memperbarui konfigurasi pemberi rekomendasi, Anda dapat menggunakan curl untuk mengirim permintaan ke Recommender API. Untuk mengizinkan permintaan dari command line, Anda menggunakan token akses OAuth. Token akses OAuth adalah string yang memberikan akses sementara ke API.

Catatan: Jika Anda belum memahami prasyarat autentikasi untuk memanggil API Google Cloud , lihat Ringkasan autentikasi.

Melihat konfigurasi

1. Untuk melihat konfigurasi Pemberi Rekomendasi Project Tanpa Pengawasan untuk organisasi tertentu, jalankan perintah berikut dari project milik organisasi tersebut yang telah mengaktifkan Recommender API:

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "x-goog-user-project: PROJECT_ID" \
   https://recommender.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config
   

   Ganti kode berikut:

   • PROJECT_ID: Project ID.
   • ORGANIZATION_ID: ID organisasi.

2. Contoh Output:

   
   {
     "name": "organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config",
     "recommenderGenerationConfig": {
       "params": {
         "minimum_observation_period": "P60D"
       }
     },
     "etag": ETAG,
     "updateTime": "2022-04-21T18:51:17.407255Z",
     "revisionId": "75c3b0d7"
   }
   
   

   Perhatikan nilai ETAG:

   • ETAG: Nilai ini akan digunakan di curl PATCH.

Memperbarui konfigurasi

1. Untuk memperbarui konfigurasi Unattended Project Recommender untuk organisasi tertentu, pilih project milik organisasi tersebut tempat Anda telah mengaktifkan Recommender API, buat file request.json:

   
   {
     "name": "organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config",
     "recommenderGenerationConfig": {
       "params": {
         "minimum_observation_period": DURATION
       }
     },
   "etag": ETAG,
   }
   

   Ganti kode berikut:

   • DURATION: Satu nilai dari "P30D", "P60D", "P90D", "P180D", "P270D", "P365D"
   • ETAG: Nilai etag yang ditampilkan dari CURL get.

2. Jalankan command line berikut:

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   -H "x-goog-user-project: PROJECT_ID" \
   -H "Content-Type: application/json; charset=utf-8" -d @request.json \
   https://recommender.googleapis.com/v1beta1/organizations/ORGANIZATION_ID/locations/global/recommenders/google.resourcemanager.projectUtilization.Recommender/config
   

   Ganti kode berikut:

   • PROJECT_ID: Project ID.
   • ORGANIZATION_ID: ID organisasi.

Langkah berikutnya

• Menghentikan (menghapus) project
• Menghapus project dalam organisasi
• Metodologi pelaporan Jejak Karbon
• Tutorial interaktif (buka di Cloud Shell)