Laman ini menjelaskan cara membuat, membuat daftar, menghapus, dan memperoleh {i>metadata<i} dari folder dalam bucket dengan namespace hierarkis diaktifkan.
Membuat folder
Bagian ini menjelaskan cara membuat folder.
Konsol
-
Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
- Pada daftar bucket, klik nama bucket yang ingin dibuat ke folder tersebut.
- Di halaman Bucket details, klik Create folder untuk membuat folder kosong.
- Di kolom Nama, masukkan nama untuk folder Anda. Untuk penamaan pertimbangan, lihat Pertimbangan.
-
Klik Create.
Folder yang baru Anda buat akan muncul di panel Folder browser.
Command line
-
Di konsol Google Cloud, aktifkan Cloud Shell.
Di bagian bawah Google Cloud Console, Cloud Shell sesi akan terbuka dan menampilkan perintah 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 sesi.
-
Di lingkungan pengembangan Anda, jalankan perintah berikut:
gcloud alpha storage folders create --recursive gs://BUCKET_NAME/FOLDER_NAME
Dengan keterangan:
BUCKET_NAME
adalah nama bucket Anda. Misalnya,my-bucket
.FOLDER_NAME
adalah namanya folder yang ingin Anda buat. Contoh,my-folder/
. Untuk informasi tentang nama folder, lihat dokumentasi ringkasan folder.--recursive
adalah tanda yang secara otomatis membuat semua folder induk yang tidak ada beserta foldernya. Setelan ini bersifat opsional jika folder induk sudah ada.
Jika permintaan berhasil, perintah akan menampilkan pesan berikut ini:
Completed 1/1
Library Klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
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.
PHP
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
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.
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.
REST API
JSON API
Instal dan lakukan inisialisasi gcloud CLI, untuk membuat token akses bagi header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya dalam header
Authorization
.- Buat file JSON yang berisi setelan untuk folder, yang harus menyertakan
name
untuk folder. Lihat Folder: Menyisipkan dokumentasi untuk daftar lengkap pengaturan. Berikut adalah setelan yang diperlukan untuk disertakan:{ "name": "FOLDER_NAME", }
Dengan FOLDER_NAME adalah nama folder yang ingin Anda buat. Sebagai contoh,
my-folder/
. Untuk informasi tentang nama folder, lihat dokumentasi ringkasan folder. - Gunakan
cURL
untuk memanggil JSON API:curl -X POST --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/folders?recursive=true"
Dengan keterangan:
JSON_FILE_NAME
adalah nama file JSON yang berisi setelan untuk folder.BUCKET_NAME
adalah nama bucket tempat Anda ingin membuat folder.recursive
disetel ke benar (true) untuk membuat semua folder induk yang tidak ada secara otomatis beserta foldernya. Setelan ini bersifat opsional jika folder induk sudah ada.
Mencantumkan folder
Bagian ini menjelaskan cara membuat daftar folder.
Konsol
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Di daftar bucket, klik nama bucket yang foldernya ingin Anda daftar.
Dari panel Folder browser, gunakan panah luaskan
untuk meluaskan folder dalam bucket Anda.Daftar akan menampilkan folder, folder simulasi, dan folder terkelola di bucket Anda.
Command line
Untuk menampilkan semua folder dalam bucket, jalankan perintah berikut:
gcloud alpha storage folders list gs://BUCKET_NAME/
Dengan keterangan:
BUCKET_NAME
adalah nama bucket yang berisi folder yang ingin Anda cantumkan. Contoh,my-bucket
.
Respons yang berhasil akan terlihat seperti contoh berikut:
bucket: hns-bucket id: hns-bucket/A/ kind: storage#folder name: A/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/A timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/B/ kind: storage#folder name: B/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/B timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/B/D/ kind: storage#folder name: D/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/B/D timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/C/ kind: storage#folder name: C/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/C timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' --- bucket: hns-bucket id: hns-bucket/C/E/ kind: storage#folder name: E/ selfLink: https://www.googleapis.com/storage/v1/b/hns-bucket/f/C/E timeCreated: '2023-05-05T16:32:08.878000+00:00' updated: '2023-05-05T16:32:08.878000+00:00' ...
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Python
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
REST API
JSON API
Membuat gcloud CLI menginstal dan melakukan inisialisasi, untuk 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 untuk mencantumkan folder:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders"
Dengan
BUCKET_NAME
adalah nama bucket yang berisi folder yang ingin Anda cantumkan. Contoh,my-bucket
.
Menghapus folder
Bagian ini menjelaskan cara menghapus folder.
Konsol
- Di Konsol Google Cloud, buka halaman Bucket Cloud Storage.
Di daftar bucket, klik nama bucket yang foldernya ingin Anda hapus.
Dari panel Folder browser, gunakan panah luaskan
untuk meluaskan folder dalam bucket Anda.Cari folder yang ingin Anda hapus.
Klik folder
Lainnya Actions.Klik Hapus folder.
Untuk mengonfirmasi bahwa Anda ingin menghapus folder, ketik
DELETE
di kolom Hapus.Klik Hapus.
Folder dan isinya, termasuk objek yang disimpan dan folder terkelola, akan dihapus dari bucket Cloud Storage.
Command line
Untuk menghapus folder kosong, jalankan perintah berikut:
gcloud alpha storage folders delete gs://BUCKET_NAME/FOLDER_NAME
Dengan keterangan:
BUCKET_NAME
adalah nama bucket. Misalnya,my-bucket
.FOLDER_NAME
adalah namanya folder yang ingin Anda hapus. Contoh,my-folder/
.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
PHP
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage PHP API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
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.
Ruby
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
REST API
JSON API
Membuat gcloud CLI menginstal dan melakukan inisialisasi, untuk 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 FolderDELETE
permintaan:curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders/FOLDER_NAME"
Dengan keterangan:
BUCKET_NAME
adalah nama bucket yang berisi folder yang ingin Anda hapus. Contoh,my-bucket
.FOLDER_NAME
adalah nama yang dienkode ke URL folder yang ingin Anda hapus. Contohnya,my-folder/
, yang berenkode URL menjadimy-folder%2F
.
Mendapatkan metadata folder
Bagian ini menjelaskan cara mendapatkan metadata dari folder.
Command line
Untuk mendapatkan metadata folder, jalankan perintah berikut:
gcloud alpha storage folders describe gs://BUCKET_NAME/FOLDER_NAME
Dengan keterangan:
BUCKET_NAME
adalah nama bucket yang berisi folder yang metadatanya ingin Anda ambil. Contoh,my-bucket
.FOLDER_NAME
adalah nama folder yang metadatanya yang ingin diambil. Contoh,my-folder/
.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Go
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Go API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Java
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Node.js
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Node.js API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
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.
Python
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Python API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Ruby
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Ruby API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
REST API
JSON API
Instal dan lakukan inisialisasi gcloud CLI, untuk membuat token akses bagi header
Authorization
.Atau, Anda dapat membuat token akses menggunakan OAuth 2.0 Playground dan menyertakannya di header
Authorization
.Gunakan
cURL
untuk memanggil JSON API denganGET
Permintaan folder:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders/FOLDER_NAME"
Dengan keterangan:
BUCKET_NAME
adalah nama bucket yang berisi folder yang {i>metadata<i}-nya ingin Anda ambil. Contoh,my-bucket
.FOLDER_NAME
adalah nama yang dienkode ke URL folder yang {i>metadata<i}-nya ingin Anda ambil. Contoh,my-folder/
, URL dienkode sebagaimy-folder%2F
.
Mengelola akses di folder
Bagian ini menjelaskan cara mengelola akses di folder Anda dengan menyetel Kebijakan Identity and Access Management (IAM), agar Anda mendapatkan akses yang lebih mendetail mengontrol kelompok objek tertentu dalam bucket.
Untuk mengelola akses di folder Anda, ikuti langkah-langkah berikut:
Aktifkan pengelolaan pada folder Anda dengan membuat folder terkelola dengan nama yang sama dengan folder yang sudah ada. Untuk petunjuk terperinci, lihat Membuat folder terkelola.
Langkah selanjutnya
- Mengganti nama folder.
- Membuat dan mengelola bucket dengan namespace hierarkis yang diaktifkan.
- Menggunakan namespace hierarkis untuk workload Hadoop.
Coba sendiri
Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa Cloud Storage dalam skenario dunia nyata. Pelanggan baru mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.
Coba Cloud Storage gratis