Halaman ini diterjemahkan oleh Cloud Translation API.

Menggunakan set data Storage Insights
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Halaman ini menunjukkan cara membuat dan mengelola set data Storage Insights dan konfigurasi set data. Pelajari set data Insight Penyimpanan lebih lanjut.

Sebelum memulai

Sebelum Anda mulai membuat dan mengelola set data dan konfigurasi set data, ikuti petunjuk di subbagian berikutnya.

Mendapatkan peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk membuat dan mengelola set data, minta administrator untuk memberi Anda peran IAM berikut di project sumber Anda:

Untuk membuat, mengelola, dan melihat konfigurasi set data: Storage Insights Admin (roles/storageinsights.admin)
Untuk melihat, menautkan, dan membatalkan tautan set data:
- Storage Insights Analyst (roles/storageinsights.analyst)
- BigQuery Admin (roles/bigquery.admin)
Untuk menghapus set data tertaut: BigQuery Admin (roles/bigquery.admin)
Untuk melihat dan membuat kueri set data di BigQuery:
- Storage Insights Viewer (roles/storageinsights.viewer)
- BigQuery Job User (roles/bigquery.jobUser)
- BigQuery Data Viewer (roles/bigquery.dataViewer)

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk membuat dan mengelola set data. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat dan mengelola set data:

Membuat konfigurasi set data: storageinsights.datasetConfigs.create
Melihat konfigurasi set data:
- storageinsights.datasetConfigs.get
- storageinsights.datasetConfigs.list
Mengelola konfigurasi set data:
- storageinsights.datasetConfigs.update
- storageinsights.datasetConfigs.delete
Menautkan ke set data BigQuery: storageinsights.datasetConfigs.linkDataset
Hapus tautan ke set data BigQuery: storageinsights.datasetConfigs.unlinkDataset
Buat kueri set data tertaut BigQuery: bigquery.jobs.create or bigquery.jobs.*

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Mengaktifkan Storage Insights API

Konsol

Mengaktifkan storageinsights.googleapis.com API

Command line

Untuk mengaktifkan Storage Insights API di project saat ini, jalankan perintah berikut:

gcloud services enable storageinsights.googleapis.com

Untuk mengetahui detail selengkapnya tentang cara mengaktifkan layanan untuk project Google Cloud, lihat artikel Mengaktifkan dan menonaktifkan layanan.

Mengonfigurasi Storage Intelligence

Pastikan Storage Intelligence dikonfigurasi di project, folder, atau organisasi yang ingin Anda analisis dengan set data.

Membuat konfigurasi set data

Untuk membuat konfigurasi set data dan membuat set data, ikuti langkah-langkah berikut. Untuk mengetahui informasi selengkapnya tentang kolom yang dapat Anda tentukan saat membuat konfigurasi set data, lihat Properti konfigurasi set data.

Konsol

Di konsol Google Cloud, buka halaman Storage Insights Cloud Storage.

Buka Storage Insights
Klik Configure dataset.
Di bagian Nama set data Anda, masukkan nama untuk set data Anda. Secara opsional, masukkan deskripsi untuk set data.
Di bagian Define dataset scope, lakukan hal berikut:
- Pilih salah satu opsi berikut:
  - Untuk mendapatkan metadata penyimpanan untuk semua project di organisasi saat ini, pilih Sertakan organisasi.
  - Untuk mendapatkan metadata penyimpanan untuk semua project di folder yang dipilih, pilih Sertakan folder(Sub-organisasi/departemen). Untuk informasi tentang cara mendapatkan ID folder, lihat Melihat atau mencantumkan folder dan project. Untuk menambahkan folder, lakukan hal berikut:
    1. Di kolom Folder 1, masukkan ID folder.
    2. Jika perlu, untuk menambahkan beberapa ID folder, klik + Tambahkan folder lain.
  - Untuk mendapatkan metadata penyimpanan untuk project yang dipilih, pilih Sertakan project dengan memberikan nomor project. Untuk mempelajari cara menemukan nomor project, lihat Menemukan nama, nomor, dan ID project. Untuk menambahkan project, lakukan hal berikut:
    1. Di kolom Project 1, masukkan nomor project.
    2. Atau, untuk menambahkan beberapa nomor project, klik + Tambahkan project lain.
  - Untuk menambahkan project atau folder secara massal, pilih Upload daftar project /folder melalui file CSV. File CSV harus berisi nomor project atau ID folder yang ingin Anda sertakan dalam set data.
- Tentukan apakah Anda ingin menyertakan bucket mendatang secara otomatis dalam resource yang dipilih.
- Secara opsional, untuk menentukan filter pada bucket berdasarkan wilayah dan awalan bucket, luaskan bagian Filters (optional). Filter diterapkan secara tambahan pada bucket.
  
  Anda dapat menyertakan atau mengecualikan bucket dari wilayah tertentu. Misalnya, Anda dapat mengecualikan bucket yang berada di region me-central1 dan me-central2. Anda juga dapat menyertakan atau mengecualikan bucket menurut awalan. Misalnya, jika Anda ingin mengecualikan bucket yang diawali dengan my-bucket, masukkan awalan my-bucket*.
Klik Lanjutkan.
Di bagian Select retention period, pilih periode retensi data dalam set data.
Di bagian Select location to store configured dataset, pilih lokasi untuk menyimpan set data dan konfigurasi set data.
Di bagian Pilih jenis akun layanan, pilih jenis agen layanan untuk set data Anda. Agen layanan ini dibuat untuk Anda saat Anda membuat konfigurasi set data. Anda dapat memilih salah satu agen layanan berikut:
- Akun layanan cakupan konfigurasi: Agen layanan ini hanya dapat mengakses dan menulis set data yang dihasilkan oleh konfigurasi set data tertentu.
- Akun layanan cakupan project: Agen layanan ini dapat mengakses dan menulis set data yang dihasilkan dari semua konfigurasi set data dalam project.
Setelah membuat agen layanan, Anda harus memberikan izin yang diperlukan kepada agen layanan. Untuk informasi selengkapnya tentang agen layanan ini, lihat Properti konfigurasi set data.
Klik Configure.

Command line

Untuk membuat konfigurasi set data, jalankan perintah gcloud storage insights dataset-configs create dengan flag yang diperlukan:
```
gcloud storage insights dataset-configs create DATASET_CONFG_ID \
  --source-projects=SOURCE_PROJECT_NUMBERS \
  --location=LOCATION \
  --retention-period-days=RETENTION_PERIOD_DAYS \
  --organization=ORGANIZATION_ID
```
Ganti:
- DATASET_CONFIG_ID dengan nama yang ingin Anda berikan ke konfigurasi set data. Nama digunakan sebagai ID konfigurasi set data dan dapat diubah. Nama dapat berisi maksimal 128 karakter menggunakan huruf, angka, dan garis bawah.
- SOURCE_PROJECT_NUMBERS dengan nomor project yang ingin Anda sertakan dalam set data. Misalnya, 464036093014. Anda dapat menentukan satu atau beberapa project. Untuk mempelajari cara menemukan nomor project, lihat Menemukan nama, nomor, dan ID project.
  
  Sebagai alternatif penggunaan flag --source-projects, Anda dapat menggunakan flag --source-projects-file=FILE_PATH, yang memungkinkan Anda menentukan beberapa nomor project sekaligus dengan mengupload file yang berisi nomor project. File harus dalam format CSV dan harus diupload ke Cloud Storage.
- LOCATION dengan lokasi tempat konfigurasi set data dan set data akan disimpan.
- RETENTION_PERIOD_DAYS dengan periode retensi untuk data dalam set data.
- ORGANIZATION_ID dengan ID resource dari organisasi tempat project sumber berada. Project sumber di luar lokasi yang ditentukan dikecualikan dari konfigurasi set data. Untuk mempelajari cara menemukan ID organisasi, lihat Mendapatkan ID resource organisasi.
Secara opsional, Anda dapat menggunakan flag tambahan untuk mengonfigurasi set data dengan cermat:
- Gunakan --include-buckets=BUCKET_NAMES_OR_REGEX untuk menyertakan bucket tertentu berdasarkan nama atau ekspresi reguler. Jika flag ini digunakan, --exclude-buckets tidak dapat digunakan.
- Gunakan --exclude-buckets=BUCKET_NAMES_OR_REGEX untuk mengecualikan bucket tertentu berdasarkan nama atau ekspresi reguler. Jika flag ini digunakan, --include-buckets tidak dapat digunakan.
- Gunakan --project=DESTINATION_PROJECT_ID untuk menentukan project yang akan digunakan untuk menyimpan konfigurasi set data dan set data yang dihasilkan. Jika tanda ini tidak digunakan, project tujuan akan menjadi project aktif Anda. Untuk informasi selengkapnya tentang project ID, lihat Membuat dan mengelola project.
- Gunakan --auto-add-new-buckets untuk otomatis menyertakan bucket apa pun yang ditambahkan ke project sumber pada masa mendatang.
- Gunakan --skip-verification untuk melewati pemeriksaan dan kegagalan dari proses verifikasi, yang mencakup pemeriksaan untuk izin IAM yang diperlukan. Jika digunakan, beberapa atau semua bucket mungkin dikecualikan dari set data.
- Gunakan --identity=IDENTITY_TYPE untuk menentukan jenis agen layanan yang dibuat bersama konfigurasi set data. Nilainya adalah IDENTITY_TYPE_PER_CONFIG atau IDENTITY_TYPE_PER_PROJECT. Jika tidak ditentukan, defaultnya adalah IDENTITY_TYPE_PER_CONFIG.
- Gunakan --description=DESCRIPTION untuk menulis deskripsi konfigurasi set data.

REST API

JSON API

Menginstal dan melakukan inisialisasi gcloud CLI , yang memungkinkan Anda membuat token akses untuk header Authorization.

Buat file JSON yang berisi informasi berikut:
```
{
  "organization_number": "ORGANIZATION_ID",
  "source_projects": {
    "project_numbers": ["PROJECT_NUMBERS", ...]
  },
  "retention_period_days": "RETENTION_PERIOD_DAYS",
  "identity": {
    "type": "IDENTITY_TYPE"
  }
}
```
Ganti:
- ORGANIZATION_ID dengan ID resource dari organisasi tempat project sumber berada. Untuk mempelajari cara menemukan ID organisasi, lihat Mendapatkan ID resource organisasi.
- PROJECT_NUMBERS dengan nomor project yang ingin Anda sertakan dalam set data. Anda dapat menentukan satu project atau beberapa project. Project harus ditentukan sebagai daftar string.
- RETENTION_PERIOD_DAYS dengan jumlah hari data yang akan diambil dalam snapshot set data. Contoh, 90.
- IDENTITY_TYPE dengan jenis akun layanan yang dibuat bersama konfigurasi set data. Nilainya adalah IDENTITY_TYPE_PER_CONFIG atau IDENTITY_TYPE_PER_PROJECT.
Untuk membuat konfigurasi set data, gunakan cURL untuk memanggil JSON API dengan permintaan Create DatasetConfig:
```
curl -X POST --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs?datasetConfigId=DATASET_CONFIG_ID" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json"
```
Ganti:
- JSON_FILE_NAME dengan jalur ke file JSON yang Anda buat di langkah sebelumnya. Atau, Anda dapat meneruskan instance DatasetConfig dalam isi permintaan.
- PROJECT_ID dengan ID project yang akan menjadi milik konfigurasi set data dan set data.
- LOCATION dengan lokasi tempat set data dan konfigurasi set data akan berada. Contohnya, us-central1.
- DATASET_CONFIG_ID dengan nama yang ingin Anda berikan ke konfigurasi set data. Nama digunakan sebagai ID konfigurasi set data dan tidak dapat diubah. Nama dapat berisi maksimal 128 karakter menggunakan huruf, angka, dan garis bawah. Nama harus diawali dengan huruf.
- ACCESS_TOKEN dengan token akses yang Anda buat saat menginstal dan melakukan inisialisasi Google Cloud CLI.

Untuk memecahkan masalah error pemrosesan snapshot yang dicatat ke dalam log di error_attributes_view, lihat Error set data Storage Insights.

Memberikan izin yang diperlukan kepada agen layanan

Google Cloud membuat agen layanan cakupan konfigurasi atau cakupan project untuk Anda saat Anda membuat konfigurasi set data. Agen layanan mengikuti format penamaan service-PROJECT_NUMBER@gcp-sa-storageinsights.iam.gserviceaccount.com dan muncul di halaman IAM Konsol Google Cloud saat Anda mencentang kotak Sertakan pemberian peran yang disediakan Google. Anda juga dapat menemukan nama agen layanan dengan melihat resource DatasetConfig menggunakan JSON API.

Untuk mengaktifkan Storage Insights guna membuat dan menulis set data, minta administrator untuk memberikan peran Layanan Pengumpul Insight Penyimpanan (roles/storage.insightsCollectorService) kepada agen layanan di organisasi yang berisi project sumber. Peran ini harus diberikan ke setiap agen layanan cakupan konfigurasi yang dibuat untuk setiap konfigurasi set data yang datanya Anda inginkan. Jika Anda menggunakan agen layanan cakupan project, peran ini hanya boleh diberikan satu kali agar agen layanan dapat membaca dan menulis set data untuk semua konfigurasi set data dalam project.

Untuk mengetahui petunjuk tentang cara memberikan peran di project, lihat Mengelola akses.

Menautkan set data

Untuk menautkan set data ke BigQuery, selesaikan langkah-langkah berikut:

Konsol

Di konsol Google Cloud, buka halaman Storage Insights Cloud Storage.

Buka Storage Insights
Klik nama konfigurasi set data yang menghasilkan set data yang ingin Anda tautkan.
Di bagian BigQuery linked dataset, klik Link dataset untuk menautkan set data Anda.

Command line

Untuk menautkan set data ke BigQuery, jalankan perintah gcloud storage insights dataset-configs create-link:
```
gcloud storage insights dataset-configs create-link DATASET_CONFIG_ID --location=LOCATION
```
Ganti:
- DATASET_CONFIG_ID dengan nama konfigurasi set data yang menghasilkan set data yang ingin Anda tautkan.
- LOCATION dengan lokasi set data Anda. Misalnya, us-central1.
Sebagai alternatif untuk menentukan DATASET_CONFIG_NAME dan LOCATION, Anda dapat menentukan jalur konfigurasi set data lengkap. Contoh:
```
gcloud storage insights dataset-configs create-link projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID_
```
Ganti:
- DESTINATION_PROJECT_ID dengan ID project yang berisi konfigurasi set data. Untuk informasi selengkapnya tentang project ID, lihat Membuat dan mengelola project.
- DATASET_CONFIG_ID dengan nama konfigurasi set data yang menghasilkan set data yang ingin Anda tautkan.
- LOCATION dengan lokasi set data dan konfigurasi set data Anda. Misalnya, us-central1.

REST API

JSON API

Menginstal dan melakukan inisialisasi gcloud CLI , yang memungkinkan Anda membuat token akses untuk header Authorization.

Buat file JSON yang berisi informasi berikut:

{
  "name": "DATASET_NAME"
}

Ganti:

DATASET_NAME dengan nama set data yang ingin Anda tautkan. Contoh, my_project.my_dataset276daa7e_2991_4f4f_b9d4_e354b48426a2.

Gunakan cURL untuk memanggil JSON API dengan permintaan linkDataset DatasetConfig:
```
curl --request POST --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigsDATASET_CONFIG_ID:linkDataset?" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
```
Ganti:
- JSON_FILE_NAME dengan jalur ke file JSON yang Anda buat di langkah sebelumnya.
- PROJECT_ID dengan ID project yang menjadi milik konfigurasi set data.
- LOCATION dengan lokasi tempat set data dan konfigurasi set data berada. Contohnya, us-central1.
- DATASET_CONFIG_ID dengan nama konfigurasi set data yang menghasilkan set data yang ingin Anda tautkan.
- ACCESS_TOKEN dengan token akses yang Anda buat saat menginstal dan melakukan inisialisasi Google Cloud CLI.

Melihat dan membuat kueri set data tertaut

Untuk melihat dan membuat kueri set data tertaut, ikuti langkah-langkah berikut:

Di konsol Google Cloud, buka halaman Storage Insights Cloud Storage.

Buka Storage Insights

Daftar konfigurasi set data yang dibuat di project Anda akan muncul.
Klik set data tertaut BigQuery dari konfigurasi set data yang ingin Anda lihat.

Set data tertaut BigQuery akan muncul di konsol Google Cloud. Untuk mengetahui informasi tentang skema set data metadata, lihat Skema set data metadata.
Anda dapat membuat kueri tabel dan tampilan di set data tertaut dengan cara yang sama seperti saat membuat kueri tabel BigQuery lainnya.

Membatalkan tautan set data

Untuk menghentikan konfigurasi set data agar tidak dipublikasikan ke set data BigQuery, batalkan tautan set data. Untuk membatalkan tautan set data, selesaikan langkah-langkah berikut:

Konsol

Di konsol Google Cloud, buka halaman Storage Insights Cloud Storage.

Buka Storage Insights
Klik nama konfigurasi set data yang membuat set data yang ingin Anda batalkan tautannya.
Di bagian BigQuery linked dataset, klik Unlink dataset untuk membatalkan tautan set data Anda.

Command line

Untuk membatalkan tautan set data, jalankan perintah gcloud storage insights dataset-configs delete-link:
```
gcloud storage insights dataset-configs delete-link DATASET_CONFIG_ID --location=LOCATION
```
Ganti:
- DATASET_CONFIG_ID dengan nama konfigurasi set data yang menghasilkan set data yang ingin Anda batalkan tautannya.
- LOCATION dengan lokasi set data dan konfigurasi set data Anda. Misalnya, us-central1.
Sebagai alternatif untuk menentukan DATASET_CONFIG_NAME dan LOCATION, Anda dapat menentukan jalur konfigurasi set data lengkap. Contoh:
```
gcloud storage insights dataset-configs delete-link projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID
```
Ganti:
- DESTINATION_PROJECT_ID dengan ID project yang berisi konfigurasi set data. Untuk informasi selengkapnya tentang project ID, lihat Membuat dan mengelola project.
- DATASET_CONFIG_ID dengan nama konfigurasi set data yang menghasilkan set data yang ingin Anda batalkan tautannya.
- LOCATION dengan lokasi set data dan konfigurasi set data Anda. Misalnya, us-central1.

REST API

JSON API

Menginstal dan melakukan inisialisasi gcloud CLI , yang memungkinkan Anda membuat token akses untuk header Authorization.

Buat file JSON yang berisi informasi berikut:

{
  "name": "DATASET_NAME"
}

Ganti:

DATASET_NAME dengan nama set data yang ingin Anda batalkan tautannya. Contoh, my_project.my_dataset276daa7e_2991_4f4f_b9d4_e354b48426a2.

Gunakan cURL untuk memanggil JSON API dengan permintaan unlinkDataset DatasetConfig:
```
curl --request POST --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigsDATASET_CONFIG_ID:unlinkDataset?" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
```
Ganti:
- JSON_FILE_NAME dengan jalur ke file JSON yang Anda buat di langkah sebelumnya.
- PROJECT_ID dengan ID project yang menjadi milik konfigurasi set data.
- LOCATION dengan lokasi set data dan konfigurasi set data. Misalnya, us-central1.
- DATASET_CONFIG_ID dengan nama konfigurasi set data yang menghasilkan set data yang ingin Anda batalkan tautannya.
- ACCESS_TOKEN dengan token akses yang Anda buat saat menginstal dan melakukan inisialisasi Google Cloud CLI.

Melihat konfigurasi set data

Untuk melihat konfigurasi set data, selesaikan langkah-langkah berikut:

Konsol

Di konsol Google Cloud, buka halaman Storage Insights Cloud Storage.

Buka Storage Insights
Klik nama konfigurasi set data yang ingin Anda lihat.

Detail konfigurasi set data akan ditampilkan.

Command line

Untuk mendeskripsikan konfigurasi set data, jalankan perintah gcloud storage insights dataset-configs describe:
```
gcloud storage insights dataset-configs describe DATASET_CONFG_ID \
  --location=LOCATION
```
Ganti:
- DATASET_CONFIG_ID dengan nama konfigurasi set data.
- LOCATION dengan lokasi set data dan konfigurasi set data.
Sebagai alternatif untuk menentukan DATASET_CONFIG_NAME dan LOCATION, Anda dapat menentukan jalur konfigurasi set data lengkap. Contoh:
```
gcloud storage insights dataset-configs describe projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID
```
Ganti:
- DESTINATION_PROJECT_ID dengan ID project yang berisi konfigurasi set data. Untuk informasi selengkapnya tentang project ID, lihat Membuat dan mengelola project.
- DATASET_CONFIG_ID dengan nama konfigurasi set data yang menghasilkan set data yang ingin Anda lihat.
- LOCATION dengan lokasi set data dan konfigurasi set data Anda. Misalnya, us-central1.

REST API

JSON API

Menginstal dan melakukan inisialisasi gcloud CLI , yang memungkinkan Anda membuat token akses untuk header Authorization.

Gunakan cURL untuk memanggil JSON API dengan permintaan Get DatasetConfig:
```
curl -X GET \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
```
Ganti:
- PROJECT_ID dengan ID project yang menjadi milik konfigurasi set data.
- LOCATION dengan lokasi set data dan konfigurasi set data. Misalnya, us-central1.
- DATASET_CONFIG_ID dengan nama konfigurasi set data.
- ACCESS_TOKEN dengan token akses yang Anda buat saat menginstal dan melakukan inisialisasi Google Cloud CLI.

Mencantumkan konfigurasi set data

Untuk membuat daftar konfigurasi set data dalam project, selesaikan langkah-langkah berikut:

Konsol

Di konsol Google Cloud, buka halaman Storage Insights Cloud Storage.

Buka Storage Insights

Daftar konfigurasi set data akan ditampilkan.

Command line

Untuk mencantumkan konfigurasi set data dalam project, jalankan perintah gcloud storage insights dataset-configs list:
```
gcloud storage insights dataset-configs list --location=LOCATION
```
Ganti:
- LOCATION dengan lokasi set data dan konfigurasi set data. Misalnya, us-central1.
Anda dapat menggunakan flag opsional berikut untuk menentukan perilaku panggilan listingan:
- Gunakan --page-size untuk menentukan jumlah maksimum hasil yang akan ditampilkan per halaman.
- Gunakan --filter=FILTER untuk memfilter hasil. Untuk mengetahui informasi selengkapnya tentang cara menggunakan flag --filter, jalankan gcloud topic filters dan lihat dokumentasi.
- Gunakan --sort-by=SORT_BY_VALUE untuk menentukan daftar yang dipisahkan koma dari nama kunci kolom resource yang digunakan untuk pengurutan. Contoh, --sort-by=DATASET_CONFIG_NAME.

REST API

JSON API

Menginstal dan melakukan inisialisasi gcloud CLI , yang memungkinkan Anda membuat token akses untuk header Authorization.

Gunakan cURL untuk memanggil JSON API dengan permintaan Get DatasetConfig:
```
curl -X GET \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
```
Ganti:
- PROJECT_ID dengan ID project yang menjadi milik konfigurasi set data.
- LOCATION dengan lokasi set data dan konfigurasi set data. Misalnya, us-central1.
- ACCESS_TOKEN dengan token akses yang Anda buat saat menginstal dan melakukan inisialisasi Google Cloud CLI.

Memperbarui konfigurasi set data

Untuk memperbarui konfigurasi set data, selesaikan langkah-langkah berikut:

Konsol

Di konsol Google Cloud, buka halaman Storage Insights Cloud Storage.

Buka Storage Insights
Klik nama konfigurasi set data yang ingin diperbarui.
Di tab Konfigurasi set data yang muncul, klik Edit untuk memperbarui kolom.

Command line

Untuk memperbarui konfigurasi set data, jalankan perintah gcloud storage insights dataset-configs update:
```
gcloud storage insights dataset-configs update DATASET_CONFG_ID \
  --location=LOCATION
```
Ganti:
- DATASET_CONFIG_ID dengan nama konfigurasi set data.
- LOCATION dengan lokasi set data dan konfigurasi set data.
Gunakan flag berikut untuk memperbarui properti konfigurasi set data:
- Gunakan --skip-verification untuk melewati pemeriksaan dan kegagalan dari proses verifikasi, yang mencakup pemeriksaan untuk izin IAM yang diperlukan. Jika digunakan, beberapa atau semua bucket mungkin dikecualikan dari set data.
- Gunakan --retention-period-days=DAYS untuk menentukan jumlah hari data yang akan diambil dalam snapshot set data. Contoh, 90.
- Gunakan --description=DESCRIPTION untuk menulis deskripsi konfigurasi set data.

REST API

JSON API

Menginstal dan melakukan inisialisasi gcloud CLI , yang memungkinkan Anda membuat token akses untuk header Authorization.

Buat file JSON yang berisi informasi opsional berikut:
```
{
  "organization_number": "ORGANIZATION_ID",
  "source_projects": {
    "project_numbers": "PROJECT_NUMBERS"
  },
  "retention_period_days": RETENTION_PERIOD"
}
```
Ganti:
- ORGANIZATION_ID dengan ID resource dari organisasi tempat project sumber berada.
- PROJECT_NUMBERS dengan nomor project yang ingin Anda sertakan dalam set data. Anda dapat menentukan satu project atau beberapa project. Project harus ditentukan dalam format daftar.
- RETENTION_PERIOD dengan jumlah hari data yang bergerak untuk diambil dalam snapshot set data. Contoh, 90.
Untuk memperbarui konfigurasi set data, gunakan cURL untuk memanggil JSON API dengan permintaan Patch DatasetConfig:
```
curl -X PATCH --data-binary @JSON_FILE_NAME \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID?updateMask=RETENTION_PERIOD" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
```
Ganti:
- JSON_FILE_NAME dengan jalur ke file JSON yang Anda buat di langkah sebelumnya.
- PROJECT_ID dengan ID project yang menjadi milik konfigurasi set data.
- LOCATION dengan lokasi set data dan konfigurasi set data. Misalnya, us-central1.
- DATASET_CONFIG_ID dengan nama konfigurasi set data yang ingin Anda perbarui.
- RETENTION_PERIOD dengan jumlah hari data yang bergerak untuk diambil dalam snapshot set data. Contoh, 90.
- ACCESS_TOKEN dengan token akses yang Anda buat saat menginstal dan melakukan inisialisasi Google Cloud CLI.

Menghapus konfigurasi set data

Untuk menghapus konfigurasi set data, selesaikan langkah-langkah berikut:

Konsol

Di konsol Google Cloud, buka halaman Storage Insights Cloud Storage.

Buka Storage Insights
Klik nama konfigurasi set data yang ingin Anda hapus.
Klik Hapus .

Command line

Untuk menghapus konfigurasi set data, jalankan perintah gcloud storage insights dataset-configs delete:
```
gcloud storage insights dataset-configs delete DATASET_CONFG_ID \
  --location=LOCATION
```
Ganti:
- DATASET_CONFIG_ID dengan nama konfigurasi set data yang ingin Anda hapus.
- LOCATION dengan lokasi set data dan konfigurasi set data. Misalnya, us-central1.
Gunakan flag berikut untuk memperbarui properti konfigurasi set data:
- Gunakan --auto-delete-link untuk membatalkan tautan set data yang dihasilkan dari konfigurasi set data yang ingin Anda hapus. Anda harus membatalkan tautan set data sebelum dapat menghapus konfigurasi set data yang membuat set data.
- Gunakan --retention-period-days=DAYS untuk menentukan jumlah hari data yang akan diambil dalam snapshot set data. Contoh, 90.
Sebagai alternatif untuk menentukan DATASET_CONFIG_NAME dan LOCATION, Anda dapat menentukan jalur konfigurasi set data lengkap. Contoh:
```
gcloud storage insights dataset-configs describe projects/DESTINATION_PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID
```

REST API

JSON API

Menginstal dan melakukan inisialisasi gcloud CLI , yang memungkinkan Anda membuat token akses untuk header Authorization.

Gunakan cURL untuk memanggil JSON API dengan permintaan Delete DatasetConfig:
```
curl -X DELETE \
"https://storageinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasetConfigs/DATASET_CONFIG_ID" \
  --header "Authorization: Bearer ACCESS_TOKEN" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
```
Ganti:
- PROJECT_ID dengan ID project yang menjadi milik konfigurasi set data.
- LOCATION dengan lokasi set data dan konfigurasi set data. Misalnya, us-central1.
- DATASET_CONFIG_ID dengan nama konfigurasi set data yang ingin Anda hapus.
- ACCESS_TOKEN dengan token akses yang Anda buat saat menginstal dan melakukan inisialisasi Google Cloud CLI.

Menggunakan set data Storage Insights Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Sebelum memulai

Mendapatkan peran yang diperlukan

Izin yang diperlukan

Mengaktifkan Storage Insights API

Konsol

Command line

Mengonfigurasi Storage Intelligence

Membuat konfigurasi set data

Konsol

Command line

REST API

JSON API

Memberikan izin yang diperlukan kepada agen layanan

Menautkan set data

Konsol

Command line

REST API

JSON API

Melihat dan membuat kueri set data tertaut

Membatalkan tautan set data

Konsol

Command line

REST API

JSON API

Melihat konfigurasi set data

Konsol

Command line

REST API

JSON API

Mencantumkan konfigurasi set data

Konsol

Command line

REST API

JSON API

Memperbarui konfigurasi set data

Konsol

Command line

REST API

JSON API

Menghapus konfigurasi set data

Konsol

Command line

REST API

JSON API

Langkah berikutnya

Menggunakan set data Storage Insights
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.