Halaman ini menunjukkan cara menambahkan, mengubah, menghapus, dan melihat label yang ditetapkan pada bucket di Cloud Storage.
Peran yang diperlukan
Guna mendapatkan izin yang diperlukan untuk menambahkan dan mengelola label bucket, minta administrator Anda untuk memberi Anda peran IAM Storage Admin (roles/storage.admin
) di bucket.
Peran yang ditentukan sebelumnya ini berisi izin yang diperlukan untuk menambahkan dan mengelola label bucket. Untuk melihat izin persis yang diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
storage.buckets.get
storage.buckets.list
- Izin ini hanya diperlukan jika Anda berencana menggunakan Konsol Google Cloud untuk menjalankan petunjuk di halaman ini.
storage.buckets.update
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus.
Untuk mengetahui petunjuk tentang cara memberikan peran pada bucket, baca Menggunakan IAM dengan bucket.
Menambahkan, mengubah, atau menghapus label bucket
Konsol
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket yang ingin Anda tambahkan, ubah, atau hapus labelnya.
Di halaman Bucket details, klik tab Configuration.
Klik ikon Edit (edit) untuk Labels.
Jendela editor label akan muncul.
Untuk menambahkan label, klik tombol Tambahkan label add_box, lalu tentukan
key
danvalue
untuk label Anda.Untuk mengubah label yang ada, klik Nilainya, lalu masukkan nilai baru.
Untuk menghapus label, klik ikon Sampah yang terkait dengan label yang ingin dihapus.
Klik Save.
Untuk mempelajari cara mendapatkan informasi error mendetail tentang operasi Cloud Storage yang gagal di Konsol Google Cloud, lihat Pemecahan masalah.
Command line
Untuk menambahkan label baru atau memperbarui label yang ada, gunakan perintah gcloud storage buckets update
dengan flag --update-labels
. Contoh:
gcloud storage buckets update gs://BUCKET_NAME --update-labels=KEY_1=VALUE_1
Di mana
BUCKET_NAME
adalah nama bucket tempat label diterapkan. Contoh,my-bucket
.KEY_1
adalah nama kunci untuk label Anda. Contoh,pet
.VALUE_1
adalah nilai untuk label Anda. Misalnya,dog
.
Untuk menghapus label yang ada, gunakan tanda -remove-labels
. Contoh:
gcloud storage buckets update gs://BUCKET_NAME --remove-labels=KEY_1
Anda dapat mengubah beberapa label menggunakan perintah sebelumnya dengan menyertakan label dalam daftar yang dipisahkan koma dalam tanda yang relevan. Misalnya, --update-labels=blue-key=cyan,red-key=ruby
.
Untuk menghapus semua label yang terpasang ke bucket, gunakan perintah berikut:
gcloud storage buckets update gs://BUCKET_NAME --clear-labels
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menambahkan label yang ditentukan ke bucket, atau mengubah label tersebut jika sudah ada untuk bucket:
Contoh berikut menghapus label yang ditentukan dari bucket:
C#
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menambahkan label yang ditentukan ke bucket, atau mengubah label tersebut jika sudah ada untuk bucket:
Contoh berikut menghapus label yang ditentukan dari bucket:
Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menambahkan label yang ditentukan ke bucket, atau mengubah label tersebut jika sudah ada untuk bucket:
Contoh berikut menghapus label yang ditentukan dari bucket:
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menambahkan label yang ditentukan ke bucket, atau mengubah label tersebut jika sudah ada untuk bucket:
Contoh berikut menghapus label yang ditentukan dari bucket:
Node.js
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menambahkan label yang ditentukan ke bucket, atau mengubah label tersebut jika sudah ada untuk bucket:
Contoh berikut menghapus label yang ditentukan dari bucket:
PHP
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menambahkan label yang ditentukan ke bucket, atau mengubah label tersebut jika sudah ada untuk bucket:
Contoh berikut menghapus label yang ditentukan dari bucket:
Python
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menambahkan label yang ditentukan ke bucket, atau mengubah label tersebut jika sudah ada untuk bucket:
Contoh berikut menghapus label yang ditentukan dari bucket:
Ruby
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Contoh berikut menambahkan label yang ditentukan ke bucket, atau mengubah label tersebut jika sudah ada untuk bucket:
Contoh berikut menghapus label yang ditentukan dari bucket:
REST API
JSON API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Buat file JSON yang berisi informasi berikut:
{ "labels": { "KEY_1": "VALUE_1" } }
Di mana
KEY_1
adalah nama kunci untuk label Anda. Contoh,pet
.VALUE_1
adalah nilai untuk label Anda. Contoh,dog
. Jika Anda ingin menghapus kunci, gunakannull
sebagai pengganti"<var>VALUE_1</var>"
.
Gunakan
cURL
untuk memanggil JSON API dengan permintaan BucketPATCH
:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=labels"
Dengan keterangan:
JSON_FILE_NAME
adalah jalur untuk file JSON yang Anda buat pada Langkah 2.BUCKET_NAME
adalah nama bucket tempat label diterapkan. Contoh,my-bucket
.
Anda dapat menambahkan, mengedit, atau menghapus beberapa pasangan key:value
dalam permintaan.
XML API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Buat file XML yang berisi informasi berikut:
<Tagging> <TagSet> <Tag> <Key>KEY_1</Key> <Value>VALUE_1</Value> </Tag> </TagSet> </Tagging>
Dengan keterangan:
KEY_1
adalah nama kunci untuk label Anda. Contoh,pet
.VALUE_1
adalah nilai untuk label Anda. Contoh,dog
.
Perhatikan bahwa Anda dapat menambahkan beberapa elemen
<Tag>
dalam satu permintaan. Jika ingin menghapus semua label pada bucket, gunakan satu elemen<Tag>
kosong dalam file tersebut:<Tagging> <TagSet> <Tag> </Tag> </TagSet> </Tagging>
Gunakan
cURL
untuk memanggil XML API dengan permintaan BucketPUT
dan parameter string kueritagging
.curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?tagging"
Dengan keterangan:
XML_FILE_NAME
adalah jalur untuk file XML yang Anda buat pada Langkah 2.BUCKET_NAME
adalah nama bucket tempat label diterapkan. Contoh,my-bucket
.
Melihat label bucket
Konsol
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Klik nama bucket yang labelnya ingin Anda lihat.
Klik tab Configuration.
Label yang ditetapkan pada bucket akan dicantumkan di kolom Label.
Untuk mempelajari cara mendapatkan informasi error mendetail tentang operasi Cloud Storage yang gagal di Konsol Google Cloud, lihat Pemecahan masalah.
Command line
Gunakan perintah gcloud storage buckets describe
dengan flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(labels)"
Dengan BUCKET_NAME
adalah nama bucket
yang labelnya ingin Anda lihat. Contoh, my-bucket
.
Jika berhasil dan terdapat label untuk bucket, responsnya akan mirip dengan berikut ini:
labels: red-key: ruby blue-key: cyan
Jika berhasil dan labelnya tidak ada untuk bucket, responsnya akan mirip dengan berikut ini:
null
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Untuk melihat label bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom label dalam respons.C#
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C# API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Untuk melihat label bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom label dalam respons.Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Untuk melihat label bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom label dalam respons.Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Untuk melihat label bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom label dalam respons.Node.js
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Untuk melihat label bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom label dalam respons.PHP
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Untuk melihat label bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom label dalam respons.Python
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Untuk melihat label bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom label dalam respons.Ruby
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Untuk melihat label bucket, ikuti petunjuk untuk menampilkan metadata bucket dan cari kolom label dalam respons.REST API
JSON API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Gunakan
cURL
untuk memanggil JSON API dengan permintaan BucketGET
yang menyertakan parameter string kuerifields=labels
:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=labels"
Dengan
BUCKET_NAME
adalah nama bucket yang labelnya ingin Anda lihat. Contoh,my-bucket
.
Responsnya akan terlihat seperti contoh berikut:
{ "labels" : { (your_label_key): your_label_value }, }
XML API
Telah menginstal dan melakukan inisialisasigcloud CLI, agar dapat membuat token akses untuk header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Gunakan
cURL
untuk memanggil XML API dengan permintaan BucketGET
dan parameter string kueritagging
.curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?tagging"
Dengan
BUCKET_NAME
adalah nama bucket yang labelnya ingin Anda lihat. Contoh,my-bucket
.
Responsnya akan terlihat seperti contoh berikut ini:
<Tagging> <TagSet> <Tag> <Key>your_label_key</Key> <Value>your_label_value</Value> </Tag> </TagSet> </Tagging>
Langkah selanjutnya
- Pelajari tag bucket.
- Dapatkan metadata bucket tambahan.