Memperbarui bucket observabilitas

Anda dapat memperbarui nama tampilan, deskripsi, atau kunci Cloud Key Management Service dari bucket kemampuan observasi untuk mencerminkan perubahan organisasi atau merotasi kunci enkripsi.

Anda tidak dapat menggunakan operasi update ini untuk menyelesaikan masalah kepatuhan. Misalnya, Anda tidak dapat menggunakan operasi ini untuk mengubah lokasi bucket kemampuan observasi atau menerapkan kunci Cloud KMS ke bucket yang menggunakan enkripsi default Google.

Efek memperbarui kunci Cloud KMS

Mengupdate kunci Cloud KMS untuk bucket kemampuan observasi tidak akan memengaruhi data yang disimpan. Artinya, sebelum update selesai, kunci asli akan mengenkripsi data baru. Setelah update selesai, kunci yang diupdate akan mengenkripsi data baru.

Anda dapat terus mengakses dan melihat data yang disimpan asalkan kunci Cloud KMS asli tetap diaktifkan dan akun layanan Google Cloud Observability mempertahankan izin encrypter/decrypter.

Jika Anda menonaktifkan atau menghancurkan kunci Cloud KMS asli, data apa pun yang ditulis saat kunci tersebut aktif akan langsung tidak dapat diakses dan tidak dapat dibaca secara permanen.

Batasan

Berlaku batasan berikut:

• Anda tidak dapat mengubah lokasi.
• Anda tidak dapat menerapkan kunci Cloud KMS ke bucket kemampuan observasi yang menggunakan enkripsi default Google.
• Nama tampilan tidak boleh melebihi 100 byte yang dienkode.
• Deskripsi tidak boleh melebihi 1.000 byte yang dienkode.
• Data disimpan selama 30 hari. Anda dapat menghilangkan periode retensi atau menetapkannya ke 30.
• Jika Anda memperbarui kunci Cloud KMS, lokasi kunci harus sama persis dengan lokasi induk bucket kemampuan observasi.

Sebelum memulai

Konfigurasikan project dan peran IAM Anda, lalu pilih antarmuka yang ingin Anda gunakan.

Mengonfigurasi project dan peran Anda

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

1. Untuk mendapatkan izin yang diperlukan guna memperbarui bucket kemampuan observasi, minta administrator untuk memberi Anda peran IAM Observability Editor (roles/observability.editor) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

   Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Mengonfigurasi antarmuka

gcloud

Catatan: Anda harus menggunakan gcloud CLI versi 586.0.0 atau yang lebih baru.

Di konsol Google Cloud , aktifkan Cloud Shell.

Aktifkan Cloud Shell

Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan prompt command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

Terraform

Untuk menggunakan contoh Terraform di halaman ini dalam lingkungan pengembangan lokal, instal dan lakukan inisialisasi gcloud CLI, lalu siapkan Kredensial Default Aplikasi dengan kredensial pengguna Anda.

1. Instal Google Cloud CLI.

2. Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

3. Jika Anda menggunakan shell lokal, buat kredensial autentikasi lokal untuk akun pengguna Anda:

   gcloud auth application-default login

   Anda tidak perlu melakukannya jika menggunakan Cloud Shell.

   Jika error autentikasi ditampilkan, dan Anda menggunakan penyedia identitas (IdP) eksternal, pastikan Anda telah login ke gcloud CLI dengan identitas gabungan Anda.

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan ADC untuk lingkungan pengembangan lokal dalam dokumentasi autentikasi Google Cloud .

REST

Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

Instal Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

Mengonfigurasi kunci Cloud KMS

Opsional. Jika Anda berencana memperbarui kunci Cloud KMS yang digunakan bucket kemampuan observasi, lakukan hal berikut:

1. Aktifkan Cloud Key Management Service API, jika belum diaktifkan.

   Peran yang diperlukan untuk mengaktifkan API

   Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

   Mengaktifkan API

2. Buat key ring dan kunci.

   Lokasi bucket kemampuan observasi harus cocok dengan lokasi kunci.

3. Ganti PROJECT_ID dengan ID project Anda, lalu jalankan perintah berikut:

   gcloud observability settings describe \
   --location=global --project=PROJECT_ID
   

   Respons terhadap perintah sebelumnya mencantumkan ID akun layanan Google Cloud Observability.

4. Berikan peran Cloud KMS CryptoKey Encrypter/Decrypter ke akun layanan Google Cloud Observability.

   gcloud kms keys add-iam-policy-binding \
   --project=KMS_PROJECT_ID \
   --member=serviceAccount:[e-mail] \
   --role=roles/cloudkms.cryptoKeyEncrypterDecrypter \
   --location=KMS_KEY_LOCATION \
   --keyring=KMS_KEY_RING \
   KMS_KEY_NAME
   

   Sebelum menjalankan perintah sebelumnya, buat pengganti berikut:

   • KMS_PROJECT_ID: ID alfanumerik unik, yang terdiri dari nama project Google Cloud Anda dan nomor yang ditetapkan secara acak, dari project Google Cloud yang menjalankan Cloud KMS. Untuk mengetahui informasi tentang cara mendapatkan ID ini, lihat Mengidentifikasi project.
   • service-PROJECT_NUMBER: Nama akun layanan Google Cloud Observability yang tercantum di langkah sebelumnya.
   • KMS_KEY_LOCATION: Region kunci Cloud KMS.
   • KMS_KEY_RING: Nama key ring Cloud KMS.
   • KMS_KEY_NAME: Nama kunci Cloud KMS. Formatnya adalah sebagai berikut: projects/KMS_PROJECT_ID/locations/LOCATION/keyRings/KMS_KEY_RING/cryptoKeys/KEY.

Mengupdate bucket kemampuan observasi

gcloud

Catatan: Anda harus menggunakan gcloud CLI versi 586.0.0 atau yang lebih baru.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

• BUCKET_ID: ID bucket kemampuan observasi. Misalnya, ID ini mungkin berupa _Trace.
• LOCATION: Lokasi bucket kemampuan observasi.
• DESCRIPTION: Deskripsi. Kolom ini bersifat opsional.
• DISPLAY_NAME: Nama tampilan. Kolom ini bersifat opsional.
• PROJECT_ID: ID project.

Perintah gcloud CLI juga menyediakan opsi untuk mengupdate kunci Cloud KMS. Untuk informasi selengkapnya, lihat gcloud observability buckets update.

Jalankan perintah gcloud observability buckets update:

Linux, macOS, atau Cloud Shell

gcloud observability buckets update BUCKET_ID \
 --location=LOCATION \
 --description="DESCRIPTION" \
 --display-name="DISPLAY_NAME" \
 --project=PROJECT_ID

Windows (PowerShell)

gcloud observability buckets update BUCKET_ID `
 --location=LOCATION `
 --description="DESCRIPTION" `
 --display-name="DISPLAY_NAME" `
 --project=PROJECT_ID

Windows (cmd.exe)

gcloud observability buckets update BUCKET_ID ^
 --location=LOCATION ^
 --description="DESCRIPTION" ^
 --display-name="DISPLAY_NAME" ^
 --project=PROJECT_ID

Perintah update memulai operasi yang berjalan lama dan memblokir hingga operasi selesai. Berikut adalah contoh respons saat perintah berhasil:

Request issued for: [_Trace]
Waiting for operation [projects/my-project/locations/us/operations/operation-1790096940299-65c156c3d730f-5fbc9362-10d93b76] to complete...done.
Updated bucket [_Trace].
createTime: '2026-09-09T21:06:30.590367694Z'
description: Updated bucket for storing trace data
displayName: Updated display name
name: projects/my-project/locations/us/buckets/_Trace
updateTime: '2026-09-22T17:09:00.301850190Z'

Terraform

Untuk memperbarui nama tampilan, deskripsi, atau CMEK, gunakan resource Terraform google_observability_bucket dan tetapkan kolom berikut:

• project: ID project Anda.
• location: Lokasi bucket kemampuan observasi. Untuk mengetahui informasi selengkapnya, lihat Lokasi.
• bucket_id: ID bucket kemampuan observasi. Kolom ini harus ditetapkan ke _Trace.

Anda hanya dapat memperbarui deskripsi, nama tampilan, dan CMEK. Untuk mengetahui informasi selengkapnya, lihat dokumentasi untuk resource.

REST

Untuk memperbarui bucket kemampuan observasi, kirim permintaan ke projects.locations.buckets.patch.

Anda harus menentukan parameter induk, yang mengidentifikasi bucket yang akan diupdate. Parameter ini memiliki format berikut:

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

Kolom dalam ekspresi sebelumnya memiliki arti berikut:

• PROJECT_ID: ID project.
• LOCATION: Lokasi bucket kemampuan observasi.
• BUCKET_ID: ID bucket kemampuan observasi. Misalnya, ID ini mungkin adalah _Trace.

Parameter kueri harus menentukan kolom updateMask, yang mengidentifikasi kolom yang akan diubah. Contoh:

• Untuk memperbarui deskripsi, gunakan updateMask=description.
• Untuk memperbarui kunci Cloud KMS dan deskripsi, gunakan updateMask=description,cmekSettings.kmsKey.

Isi permintaan adalah objek Bucket. Anda harus mengisi setiap kolom yang ditentukan oleh mask update. Jangan isi kolom yang tidak Anda perbarui.

Misalnya, untuk memperbarui kolom description saja, Anda dapat menggunakan objek Bucket berikut:

{
    "description": "Updated description for my observability bucket."
}

Responsnya adalah objek Operation. Biasanya, metode ini memerlukan waktu kurang dari satu menit untuk diselesaikan.

Biasanya, untuk menentukan apakah metode yang menampilkan objek Operation sudah selesai, Anda melakukan polling pada objek dengan memanggil projects.locations.operations.get hingga kolom Operation.done ditetapkan ke true. Kemudian, Anda dapat menggunakan kolom lain dalam struktur Operation untuk menentukan apakah metode berhasil atau gagal.

Namun, metode patch selesai dengan cepat. Oleh karena itu, alternatifnya adalah menunggu sebentar, lalu memverifikasi update dengan mencantumkan bucket kemampuan observasi Anda.

Langkah berikutnya

• Melihat dan menganalisis telemetri
• Menetapkan default untuk bucket kemampuan observasi: Konfigurasikan lokasi penyimpanan default dan kunci enkripsi yang dikelola pelanggan (CMEK) default untuk bucket kemampuan observasi Anda.