Pemberi rekomendasi project tanpa pengawasan

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

Ringkasan

Dalam organisasi yang bergerak cepat, resource cloud, termasuk seluruh project, terkadang terlupakan. Resource yang tidak diawasi tersebut dapat sulit diidentifikasi dan cenderung menyebabkan pemborosan dan risiko keamanan yang tidak perlu.

Pemberi rekomendasi project tanpa pengawasan menganalisis aktivitas penggunaan di semua project di organisasi Anda dan menyediakan fitur berikut untuk membantu Anda menemukan, mengklaim kembali, dan mematikan 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.

Mematikan atau mengklaim kembali project tanpa pengawasan 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 beban kerja Anda (SUSTAINABILITY)

Catatan: 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	Ambil 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 Scripts karena project ini otomatis dihapus 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 serta 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 menyertakan lebih dari 10.000 project dan Anda ingin meninjau kumpulan lengkap rekomendasi dan insight, sebaiknya Anda mengandalkan insight dan rekomendasi tingkat Project atau menggunakan ekspor insight dan rekomendasi BigQuery.

Mengurutkan 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 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 tingkat aktivitas penggunaan di semua konten yang disertakan dalam insight penggunaan project. Project diklasifikasikan sebagai tidak terpantau jika berada dalam 10% aktivitas penggunaan dibandingkan dengan semua project lain di 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 penggunaan project lainnya memiliki nilai sama dengan nol.

Catatan: Rekomendasi hanya diberikan untuk project yang sudah 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 sebagai prioritas tertinggi.
• primaryImpact - SECURITY. Jumlah rekomendasi keamanan prioritas tinggi dalam project tanpa pengawasan.
• additionalImpact(s) - COST dan SUSTAINABILITY. Pengurangan biaya ($) dan emisi keberlanjutan (kgCO₂e) yang akan diwujudkan 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 tanpa pengawasan. Dari sana, prioritas rekomendasi project tanpa pengawasan ditetapkan sama dengan rekomendasi prioritas tertinggi yang ditemukan dalam project. 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 ditemukan dalam project tanpa pengawasan berasal dari Pemberi Rekomendasi IAM. Rekomendasi project tanpa pengawasan dengan prioritas P1 kemungkinan berarti ada bucket penyimpanan cloud yang dapat diakses publik di project tanpa pengawasan (pelajari lebih lanjut cara Pemberi Rekomendasi IAM menetapkan prioritas).

Dampak keamanan

Kolom primaryImpact - SECURITY menawarkan securityProjection yang sama dengan jumlah rekomendasi keamanan prioritas tinggi (P2 dan yang lebih tinggi) dalam project tanpa pengawasan. Misalnya, jika 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 tanpa pengawasan dihapus. Hal ini didasarkan pada biaya yang timbul dari resource yang berjalan di 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 estimasi emisi karbon yang disumbangkan oleh resource yang berjalan di project tanpa pengawasan selama 30 hari terakhir. Estimasi diukur dalam kilogram setara karbon dioksida (kgCO₂e).

Konten insight pemanfaatan project

Konten insight penggunaan 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 diawasi atau tidak. Insight ini dihasilkan secara harian. Satu insight bukanlah indikator yang andal untuk project yang dianggap tidak diawasi. Jangan hapus 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 persentilnya -1, artinya nilai tidak dihitung. Nilai ini 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 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 traffic masuk 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 di project ini.
bigqueryInflightQueryDailyCount	Rata-rata harian jumlah kueri BigQuery yang sedang berjalan di project ini.
bigqueryStorageDailyBytes	Rata-rata harian penyimpanan BigQuery yang sedang diproses 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
Bidang lainnya
hasActiveOauthTokens	Memeriksa apakah project memiliki token OAuth aktif yang digunakan dalam 180 hari terakhir.
carbonFootprintDailyKgCO2	Rata-rata harian emisi karbon yang disumbangkan oleh project ini berdasarkan data 30 hari terakhir yang tersedia.
costProjection	Proyeksi penghematan biaya untuk durasi yang ditentukan jika project akan dihapus. Harga kustom atau harga jual ditampilkan berdasarkan izin akun penagihan. Ini adalah estimasi berdasarkan data yang tersedia selama 30 hari terakhir dan bukan merupakan tagihan.
severity	severity ditetapkan ke nilai yang sesuai dari insight keamanan dengan tingkat keparahan tertinggi yang ditemukan dalam project. Misalnya, berdasarkan cara Rekomendasi IAM menetapkan tingkat keparahan untuk insight-nya, tingkat keparahan CRITICAL pada insight project tanpa pengawasan kemungkinan berarti ada bucket cloud storage yang dapat diakses publik di project tanpa pengawasan.

Rekomendasi untuk menghapus project

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

Peringatan: Periksa insight penggunaan yang terkait dengan project dengan cermat. Menghapus project dapat menyebabkan hilangnya 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 penggunaan project tambahan yang tidak diambil 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 ini:

• Semua pemilik yang ditetapkan tidak aktif dalam 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, project tersebut dianggap sebagai perilaku yang diinginkan saat 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. Kemudian, Anda 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 ini:

Deskripsi	Peran
Melihat 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 di organisasi secara terpisah, atau secara kolektif (semua project yang tidak diawasi di organisasi) menggunakan API tingkat Organisasi.

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

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

ID Rekomendasi

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

• 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 menutup 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 menampilkan 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 (ini akan menjadi PROJECT_ID yang sama seperti yang diberikan pada langkah sebelumnya).
   • PROJECT_ID: ID project lain yang rekomendasi project tanpa pengawasannya ingin Anda lihat.
   Catatan: Jika perintah tidak menampilkan rekomendasi apa pun, project tersebut tidak tanpa pengawasan atau belum ada selama 30 hari atau lebih.

3. Untuk membuat daftar rekomendasi project tanpa pengawasan untuk seluruh organisasi, saat 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 Andaaktifkan dengan Recommender API (ini akan menjadi PROJECT_ID yang sama seperti yang diberikan pada langkah sebelumnya).
   • ORGANIZATION_ID: ID Organisasi yang rekomendasi project tanpa pengawasannya ingin 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 Andaaktifkan dengan Recommender API (ini akan menjadi PROJECT_ID yang sama seperti yang diberikan pada langkah sebelumnya).
   • BILLING_ACCOUNT_ID: ID Akun Penagihan Google Cloud Anda.

Catatan: Anda dapat memperluas detail Rekomendasi dari perintah daftar dengan menambahkan flag --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 untuk project lain, saat 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 Anda aktifkan dengan Recommender API (ini akan menjadi PROJECT_ID yang sama seperti yang diberikan pada langkah sebelumnya).
   • PROJECT_ID: ID project lain yang insight perekomendasikan tanpa pengawasannya ingin Anda lihat.

3. Untuk membuat daftar insight penggunaan bagi seluruh organisasi, saat 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 Andaaktifkan dengan Recommender API (ini akan menjadi PROJECT_ID yang sama 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 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 Andaaktifkan dengan Recommender API (ini akan menjadi PROJECT_ID yang sama seperti yang diberikan pada langkah sebelumnya).
   • BILLING_ACCOUNT_ID: ID Akun Penagihan Google Cloud Anda.

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

API

Untuk melihat rekomendasi dan insight, 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.

Rekomendasi

1. Untuk menampilkan 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 (ini akan menjadi PROJECT_ID yang sama seperti yang diberikan pada langkah sebelumnya).
   • PROJECT_ID: ID project lain yang rekomendasi project tanpa pengawasannya ingin Anda lihat.

3. Untuk menampilkan rekomendasi project tanpa pengawasan untuk seluruh organisasi, 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/organizations/ORGANIZATION_ID/locations/global/\
   recommenders/google.resourcemanager.projectUtilization.Recommender/recommendations"
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang 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 pengawasannya ingin 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 Anda aktifkan dengan Recommender API (ini akan menjadi PROJECT_ID yang sama seperti yang diberikan pada langkah sebelumnya).
   • BILLING_ACCOUNT_ID: ID Akun Penagihan Google Cloud 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 untuk 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\
   /insightTypes/google.resourcemanager.projectUtilization.Insight/insights"
   

   Ganti kode berikut:

   • BILLING_PROJECT_ID: ID project yang Anda aktifkan dengan Recommender API (ini akan menjadi PROJECT_ID yang sama seperti yang diberikan pada langkah sebelumnya).
   • PROJECT_ID: ID project lain yang insight perekomendasikan tanpa pengawasannya ingin Anda lihat.

3. Untuk membuat daftar insight penggunaan bagi seluruh organisasi, 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: 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 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 pengawasannya ingin Anda lihat.

4. Untuk mencantumkan insight penggunaan 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: 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 Anda aktifkan dengan Recommender API (ini akan menjadi PROJECT_ID yang sama seperti yang diberikan pada langkah sebelumnya).
   • BILLING_ACCOUNT_ID: ID Akun Penagihan Google Cloud 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. Penetapan nilai ini saat ini hanya didukung di tingkat Organisasi.	"P30D"[DEFAULT], "P60D", "P90D", "P180D", "P270D", "P365D"

gcloud

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

Melihat konfigurasi

1. Untuk melihat konfigurasi Rekomendasi Project Tanpa Pengawas untuk organisasi tertentu, jalankan perintah berikut dari project milik organisasi tersebut yang 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 Rekomendasi Project Tanpa Pengawasan 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 perekomendasikan, 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 Rekomendasi Project Tanpa Pengawas untuk organisasi tertentu, jalankan perintah berikut dari project milik organisasi tersebut yang 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 Rekomendasi Project Tanpa Pengawasan 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 selanjutnya

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