Pemberi rekomendasi project tanpa pengawasan

Pemberi rekomendasi project yang tidak diawasi akan menganalisis aktivitas penggunaan pada project di organisasi Anda dan memberikan rekomendasi yang membantu Anda menemukan, mengklaim kembali, atau menghapus project yang tidak diawasi.

Ringkasan

Dalam organisasi yang bergerak cepat, terkadang resource cloud, termasuk keseluruhan project, terlupakan. Resource tanpa pengawasan semacam itu dapat sulit diidentifikasi dan cenderung mengakibatkan pemborosan dan risiko keamanan yang tidak perlu.

Pemberi rekomendasi project tanpa pengawasan akan menganalisis aktivitas penggunaan di semua project di organisasi Anda dan menyediakan fitur berikut untuk membantu Anda menemukan, mengklaim kembali, dan menonaktifkan project yang tidak diawasi:

• Analisis penggunaan untuk setiap project (jaringan, API, pemilik project, aktivitas layanan, dan lainnya).
• Rekomendasi untuk menolak 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 yang tidak diawasi dapat memberikan dampak dan manfaat berikut bagi organisasi Anda:

• Pengurangan risiko keamanan (SECURITY)
• Pengurangan pengeluaran 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 kerja Duet AI

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

Penggunaan/jenis project	Subjenis insight	Rekomendasi	Subjenis rekomendasi
Project dengan: Penggunaan rendah selama 30 hari terakhir	PROJECT_ACTIVITY	Tinjau atau hapus proyek.	CLEANUP_PROJECT
Project dengan: Penggunaan tinggi selama 30 hari terakhir Pemilik pengguna yang ditetapkan, tetapi tidak ada yang aktif pada 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 akan menghasilkan insight atau rekomendasi apa pun untuk project Apps Script karena project ini dihapus otomatis setelah skrip terkait dihapus.

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

• Di level Project: Project Owner dapat menemukan dan menindaklanjuti insight dan rekomendasi untuk project yang dapat mereka akses.
• Di tingkat Organisasi: Administrator Organisasi dapat menemukan dan menindaklanjuti insight serta 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 menyertakan lebih dari 10.000 project dan Anda ingin meninjau kumpulan rekomendasi dan insight yang lengkap, sebaiknya Anda mengandalkan insight dan rekomendasi tingkat Project atau menggunakan ekspor insight dan rekomendasi BigQuery.

Memberi peringkat aktivitas penggunaan proyek

Project dapat diberi peringkat agar memiliki aktivitas penggunaan rendah atau tinggi, berdasarkan rekomendasi yang diberikan. Peringkat aktivitas penggunaan project dihitung berdasarkan konten yang disertakan dalam insight penggunaan 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 level aktivitas penggunaan di seluruh konten yang tercakup dalam insight pemanfaatan project. Project diklasifikasikan sebagai tanpa pengawasan jika berada dalam 10% dari 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 sebuah project. Semua wawasan pemanfaatan proyek lainnya memiliki nilai yang sama dengan nol.

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

Prioritas dan dampak rekomendasi

Rekomendasi project tanpa pengawasan berisi kolom berikut yang membantu memprioritaskan dan memperkirakan manfaat penerapannya:

• priority - Nilai prioritas antara P1-P4, dengan P1 menjadi prioritas tertinggi.
• primaryImpact—SECURITY. Jumlah rekomendasi keamanan berprioritas tinggi dalam project yang tidak diawasi.
• additionalImpact(s) - COST dan SUSTAINABILITY. Pengurangan biaya ($) dan emisi keberlanjutan (kgCO₂e) yang akan direalisasikan 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, class ini akan menetapkan prioritas rekomendasi project tanpa pengawasan yang sama dengan rekomendasi prioritas tertinggi yang ditemukan dalam project tersebut. Misalnya, jika sebuah project tanpa pengawasan memiliki 10 rekomendasi keamanan, delapan rekomendasi P2, dan dua rekomendasi P1, rekomendasi project yang tidak diawasi akan diberi nilai prioritas P1.

Rekomendasi keamanan yang paling sering muncul dalam project tanpa pengawasan adalah dari IAM Recommender. Rekomendasi project tanpa pengawasan dengan prioritas P1 kemungkinan berarti ada bucket penyimpanan cloud yang dapat diakses secara publik dalam project tanpa pengawasan (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 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 akan memiliki prioritas P2 dan dihitung di priorityRecommendationCount.

Dampak Biaya

Kolom additionalImpact - COST menawarkan costProjection yang merupakan perkiraan penghematan biaya jika project tanpa pengawasan dihapus. Hal ini didasarkan pada biaya yang timbul dari resource yang berjalan dalam project tanpa pengawasan 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 perkiraan emisi karbon yang dikontribusikan oleh resource yang berjalan dalam project tanpa pengawasan selama 30 hari terakhir. Estimasi ini diukur dalam kilogram ekuivalen karbon dioksida (kgCO₂e).

Isi wawasan tentang pemanfaatan proyek

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

Peringatan: Insight penggunaan project dibuat untuk semua project, terlepas dari apakah project tersebut tidak diawasi atau tidak. Wawasan ini dihasilkan setiap hari. Satu wawasan bukanlah indikator yang dapat diandalkan agar sebuah proyek dianggap tidak diawasi. Jangan menghapus project berdasarkan insight satu hari.

Tabel berikut mencantumkan berbagai kolom yang ditampilkan oleh 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 persentilnya adalah -1, artinya nilainya tidak dihitung. Nilai ini tidak dihitung jika organisasi memiliki kurang dari 50 project.
Aktivitas API
activeServiceAccountDailyCount	Rata-rata harian akun layanan dengan aktivitas autentikasi di bagian project ini.
apiClientDailyCount	Rata-rata harian klien yang berbeda dari 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 masuk VPC ke dalam project ini
Penggunaan penagihan
hasBillingAccount	Memeriksa apakah proyek memiliki akun penagihan pada akhir pengamatan
serviceWithBillableUsage	Nama layanan yang dapat ditagih yang digunakan dalam 30 hari terakhir.
Penggunaan layanan cloud
activeAppengineInstanceDailyCount: system/instance_count	Rata-rata harian dari jumlah instance App Engine yang aktif dalam project ini
activeCloudsqlInstanceDailyCount	Rata-rata harian dari jumlah instance Cloud SQL aktif dalam project ini.
activeGceInstanceDailyCount	Rata-rata harian dari jumlah instance Compute Engine aktif dalam project ini.
bigqueryInflightJobDailyCount	Rata-rata harian tugas BigQuery yang sedang berlangsung dalam project ini.
bigqueryInflightQueryDailyCount	Rata-rata harian jumlah kueri BigQuery yang sedang berlangsung dalam project ini.
bigqueryStorageDailyBytes	Rata-rata harian penyimpanan BigQuery yang sedang berlangsung dalam project ini.
bigqueryTableDailyCount	Rata-rata harian jumlah tabel BigQuery dalam project ini.
gcsObjectDailyCount	Rata-rata harian jumlah objek Cloud Storage di 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 tipe pengguna aktif di akhir periode observasi. Aktif berarti bahwa akun pengguna tidak dinonaktifkan dan ada beberapa aktivitas yang diidentifikasi dalam project ini selama periode observasi.
owners	Daftar pemilik project dan aktivitasnya
Kolom lainnya
hasActiveOauthTokens	Memeriksa apakah project memiliki token OAuth aktif yang digunakan dalam 180 hari terakhir.
carbonFootprintDailyKgCO2	Rata-rata harian emisi karbon yang dikontribusikan oleh project ini berdasarkan data 30 hari terakhir yang tersedia.
costProjection	Proyeksi penghematan biaya untuk durasi yang ditentukan jika project itu harus dihapus. Harga kustom atau harga jual ditampilkan berdasarkan izin akun penagihan. Ini adalah perkiraan berdasarkan data yang tersedia selama 30 hari terakhir dan bukan merupakan tagihan.
severity	severity disetel ke nilai yang sesuai dari insight keamanan dengan tingkat keparahan tertinggi yang ditemukan dalam project. Misalnya, berdasarkan cara IAM Recommender menetapkan tingkat keparahan untuk insight, tingkat keparahan CRITICAL pada insight project yang tidak dipantau kemungkinan berarti ada bucket penyimpanan cloud yang dapat diakses secara publik dalam project tanpa pengawasan.

Rekomendasi untuk menghapus project

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

Peringatan: Periksa dengan cermat insight pemanfaatan yang terkait dengan project. Menghapus project dapat menyebabkan kehilangan data yang tidak dapat dipulihkan. Untuk informasi selengkapnya, lihat Menonaktifkan (menghapus) project.

Perhatian: Rekomendasi diberikan untuk project tenant. Menghapus project ini dapat menyebabkan hilangnya data karena kolom pemanfaatan project tambahan yang tidak diambil untuk project tersebut.

Rekomendasi untuk menetapkan pemilik baru ke sebuah project

Sebaiknya tetapkan pemilik baru untuk project jika memenuhi semua kondisi seperti yang tercantum di bawah ini:

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

Catatan: Jika sebuah project tidak memiliki pemilik pengguna yang ditetapkan, project tersebut dianggap sebagai perilaku yang dimaksudkan jika rekomendasi RECLAIM_PROJECT tidak diberikan.

Harga

Untuk mengetahui detail selengkapnya tentang harga Active Assist, lihat pricing 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 --billing-project gcloud/API.
• Pastikan Anda memiliki salah satu peran yang diperlukan berikut yang ditetapkan:

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

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

Memberikan peran ini di tingkat Organisasi memungkinkan Anda mengakses rekomendasi dan insight untuk project di organisasi satu per satu, atau secara kolektif (semua project yang tidak diawasi dalam organisasi) menggunakan API level Organisasi.

Memberikan peran ini di tingkat Akun Penagihan memungkinkan Anda mengakses rekomendasi dan insight untuk project yang menggunakan akun penagihan yang ditentukan.

Untuk mengetahui informasi selengkapnya tentang cara memilih tidak ikut, lihat memilih tidak ikut insight dan rekomendasi.

ID Pemberi Rekomendasi

Berikut adalah ID pemberi rekomendasi project dan jenis insight yang tidak dipantau:

• 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 yang tidak dipantau menggunakan gcloud, dan menggunakan curl untuk mengirim permintaan ke API pemberi rekomendasi.

gcloud

Untuk melihat rekomendasi dan insight menggunakan gcloud, ikuti langkah-langkah di bawah ini. 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 yang tidak dipantau dalam project yang berbeda saat menggunakan project tempat Anda telah 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 (ini akan sama PROJECT_ID seperti yang diberikan pada langkah sebelumnya).
   • PROJECT_ID: ID project lain yang rekomendasinya ingin Anda lihat tanpa pengawasan.
   Catatan: Jika perintah tidak menampilkan rekomendasi apa pun, berarti project tidak tanpa pengawasan atau belum ada selama 30 hari atau lebih.

3. Untuk mencantumkan rekomendasi project tanpa pengawasan bagi seluruh organisasi, saat menggunakan project tempat Anda telah 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 (ID ini akan sama dengan PROJECT_ID seperti yang diberikan pada langkah sebelumnya).
   • ORGANIZATION_ID: ID Organisasi yang rekomendasi project tanpa pengawasannya akan Anda lihat.

4. Untuk menampilkan rekomendasi project tanpa pengawasan yang menggunakan Akun Penagihan tertentu, saat 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 (ID ini akan sama dengan PROJECT_ID seperti yang diberikan pada langkah sebelumnya).
   • BILLING_ACCOUNT_ID: ID Akun Penagihan Google Cloud Anda.

Catatan: Anda dapat memperluas detail Rekomendasi dari perintah list dengan menambahkan flag --format=yaml ke bagian akhir.

Insight

1. Untuk menampilkan daftar penggunaan 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 bagi project yang berbeda, saat menggunakan project tempat Anda telah 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 (ini akan sama PROJECT_ID seperti yang diberikan pada langkah sebelumnya).
   • PROJECT_ID: ID project lain yang ingin Anda lihat insight pemberi rekomendasi tanpa pengawasan.

3. Untuk mencantumkan insight penggunaan bagi seluruh organisasi, saat menggunakan project tempat Anda telah 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 (ID ini akan sama dengan PROJECT_ID seperti yang diberikan pada langkah sebelumnya).
   • ORGANIZATION_ID: ID Organisasi yang insight penggunaannya ingin Anda lihat.

4. Untuk mencantumkan insight penggunaan yang menggunakan Akun Penagihan tertentu, saat menggunakan project tempat Anda telah 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 (ID ini akan sama dengan PROJECT_ID seperti yang diberikan pada langkah sebelumnya).
   • BILLING_ACCOUNT_ID: ID Akun Penagihan Google Cloud Anda.

Catatan: Anda dapat memperluas detail Insight dari perintah list dengan menambahkan flag --format=yaml ke bagian akhir.

API

Untuk melihat rekomendasi dan insight, Anda dapat menggunakan curl untuk mengirim permintaan ke API pemberi rekomendasi. 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 Google Cloud API, 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 yang tidak dipantau dalam project yang berbeda saat menggunakan project tempat Anda telah 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 (ini akan sama PROJECT_ID seperti yang diberikan pada langkah sebelumnya).
   • PROJECT_ID: ID project lain yang rekomendasinya ingin Anda lihat tanpa pengawasan.

3. Untuk mencantumkan rekomendasi project tanpa pengawasan bagi seluruh organisasi, saat menggunakan project tempat Anda telah 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 (ini akan sama PROJECT_ID seperti yang diberikan pada langkah sebelumnya).
   • ORGANIZATION_ID: ID Organisasi yang rekomendasi project tanpa pengawasannya akan Anda lihat.

4. Untuk menampilkan rekomendasi project tanpa pengawasan yang menggunakan Akun Penagihan tertentu, 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/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 (ini akan sama PROJECT_ID seperti yang diberikan pada langkah sebelumnya).
   • BILLING_ACCOUNT_ID: ID Akun Penagihan Google Cloud Anda.

Insight

1. Untuk menampilkan daftar penggunaan 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 bagi project yang berbeda, saat menggunakan project tempat Anda telah 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 (ini akan sama PROJECT_ID seperti yang diberikan pada langkah sebelumnya).
   • PROJECT_ID: ID project lain yang ingin Anda lihat insight pemberi rekomendasi tanpa pengawasan.

3. Untuk mencantumkan insight penggunaan bagi seluruh organisasi, saat menggunakan project tempat Anda telah 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 (ini akan sama PROJECT_ID seperti yang diberikan pada langkah sebelumnya).
   • ORGANIZATION_ID: ID Organisasi yang rekomendasi project tanpa pengawasannya akan Anda lihat.

4. Untuk mencantumkan insight penggunaan yang menggunakan Akun Penagihan tertentu, saat menggunakan project tempat Anda telah 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 (ini akan sama PROJECT_ID seperti yang diberikan pada langkah sebelumnya).
   • BILLING_ACCOUNT_ID: ID Akun Penagihan Google Cloud Anda.

Mengonfigurasi parameter rekomendasi

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

Tabel berikut mencantumkan berbagai parameter yang dapat dikonfigurasi:

Parameter	Deskripsi	Nilai yang Diharapkan
minimum_observation_period	Periode observasi minimum menentukan jumlah hari aktivitas Proyek yang akan dianalisis, sebelum Rekomendasi dihasilkan. Menyetel nilai ini saat ini hanya didukung 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.

Mengupdate konfigurasi

1. Untuk memperbarui konfigurasi Unattended Project Recommender untuk organisasi tertentu, pilih project milik organisasi tempat Anda mengaktifkan Recommender API, dan 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 mengupdate 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 Google Cloud API, 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.

Mengupdate konfigurasi

1. Untuk memperbarui konfigurasi Unattended Project Recommender untuk organisasi tertentu, pilih project milik organisasi tempat Anda mengaktifkan Recommender API, dan 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 selanjutnya

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