Halaman ini menjelaskan cara membuat, mencantumkan, mengupload, menghapus, dan mendapatkan metadata folder di bucket dengan namespace hierarkis yang diaktifkan.
Sebelum memulai
Pastikan bucket Anda mengaktifkan namespace hierarkis. Untuk mengetahui petunjuk mendetail tentang cara mengaktifkan namespace hierarkis di bucket, lihat Membuat bucket dengan namespace hierarkis yang diaktifkan.
Membuat folder
Bagian ini menjelaskan cara membuat folder.
Konsol
-
Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
- Di daftar bucket, klik nama bucket tempat Anda ingin membuat folder.
- Di halaman Bucket details, klik Create folder untuk membuat folder kosong.
- Di kolom Nama, masukkan nama untuk folder Anda. Untuk pertimbangan penamaan, lihat Pertimbangan.
-
Klik Buat.
Folder yang baru dibuat akan muncul di panel Folder browser.
Command line
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
Di lingkungan pengembangan Anda, jalankan perintah
gcloud storage folders create
:gcloud storage folders create --recursive gs://BUCKET_NAME/FOLDER_NAME
Dengan:
BUCKET_NAME
adalah nama bucket Anda. Misalnya,my-bucket
.FOLDER_NAME
adalah nama folder yang ingin Anda buat. Contoh,my-folder/
. Untuk mengetahui informasi tentang nama folder, lihat dokumentasi ringkasan folder.--recursive
adalah tanda yang secara otomatis membuat semua folder induk yang tidak ada bersama dengan folder. 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 mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk 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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization
.- Buat file JSON yang berisi setelan untuk folder, yang harus menyertakan
name
untuk folder. Lihat dokumentasi Folders: Insert untuk mengetahui daftar lengkap setelan. Berikut adalah setelan yang wajib disertakan:{ "name": "FOLDER_NAME", }
Dengan FOLDER_NAME adalah nama folder yang ingin Anda buat. Misalnya,
my-folder/
. Untuk mengetahui 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:
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 bersama dengan folder. Setelan ini bersifat opsional jika folder induk sudah ada.
Mencantumkan folder
Bagian ini menjelaskan cara mencantumkan folder.
Konsol
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Di daftar bucket, klik nama bucket yang foldernya ingin Anda cantumkan.
Dari panel Folder browser, gunakan panah peluas
untuk meluaskan daftar folder dalam bucket Anda.Daftar menampilkan folder, folder simulasi, dan folder terkelola di bucket Anda.
Command line
Untuk mencantumkan semua folder dalam bucket, jalankan perintah gcloud storage folders list
:
gcloud storage folders list gs://BUCKET_NAME/
Dengan:
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 mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk 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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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 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
.
Mengupload folder
Bagian ini menjelaskan cara mengupload folder ke bucket.
Konsol
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket tempat Anda ingin mengupload folder.
Di tab Bucket details, lakukan salah satu tindakan berikut:
Tarik folder dari desktop atau pengelola file Anda ke panel utama di konsol Google Cloud .
Klik Upload > Upload folder, pilih folder yang ingin diupload dalam dialog yang muncul, lalu klik Buka.
Untuk mempelajari cara mendapatkan informasi error mendetail tentang operasi Cloud Storage yang gagal di Google Cloud konsol, lihat Pemecahan masalah.
Command line
Gunakan perintah gcloud storage cp
dengan flag --recursive
:
gcloud storage cp --recursive FOLDER_LOCATION gs://DESTINATION_BUCKET_NAME
Dengan:
FOLDER_LOCATION
adalah jalur lokal ke folder yang ingin Anda upload. Contoh,../uploads/my-folder/
.DESTINATION_BUCKET_NAME
adalah nama bucket tempat Anda mengupload folder. Contoh,my-bucket
.
Jika berhasil, responsnya akan terlihat seperti contoh berikut:
Copying file://DIR/OBJ1 at 10.06.32 PM.png to gs://BUCKET_NAME/DIR/OBJ1 at 10.06.32 PM.png Copying file://DIR/OBJ1 at 10.06.32 PM.png to gs://BUCKET_NAME/DIR/OBJ1 at 10.06.32 PM.png Completed files 2/2 | 1.7MiB/1.7MiB
Menghapus folder
Bagian ini menjelaskan cara menghapus folder.
Konsol
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Di daftar bucket, klik nama bucket yang foldernya ingin Anda hapus.
Dari panel Folder browser, gunakan panah peluas
untuk meluaskan daftar folder dalam bucket Anda.Cari folder yang ingin Anda hapus.
Klik menu
Tindakan lainnya di folder.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 lainnya, akan dihapus dari bucket Cloud Storage Anda.
Command line
Untuk menghapus folder kosong, jalankan perintah gcloud storage folders delete
:
gcloud storage folders delete gs://BUCKET_NAME/FOLDER_NAME
Dengan:
BUCKET_NAME
adalah nama bucket. Misalnya,my-bucket
.FOLDER_NAME
adalah nama 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 mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk 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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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 permintaanDELETE
Folder:curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders/FOLDER_NAME"
Dengan:
BUCKET_NAME
adalah nama bucket yang berisi folder yang ingin Anda hapus. Contoh,my-bucket
.FOLDER_NAME
adalah nama folder yang dienkode URL yang ingin Anda hapus. Contohnya,my-folder/
, yang berenkode URL menjadimy-folder%2F
.
Mendapatkan metadata folder
Bagian ini menjelaskan cara mendapatkan metadata folder.
Command line
Untuk mendapatkan metadata folder, jalankan perintah gcloud storage folders describe
:
gcloud storage folders describe gs://BUCKET_NAME/FOLDER_NAME
Dengan:
BUCKET_NAME
adalah nama bucket yang berisi folder yang metadatanya ingin Anda ambil. Contoh,my-bucket
.FOLDER_NAME
adalah nama folder yang metadatanya ingin Anda ambil. 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 mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk 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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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, lihat Menyiapkan autentikasi untuk library klien.
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 permintaanGET
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:
BUCKET_NAME
adalah nama bucket yang berisi folder yang metadatanya ingin Anda ambil. Contoh,my-bucket
.FOLDER_NAME
adalah nama folder yang dienkode ke URL yang metadatanya ingin Anda ambil. Contoh,my-folder/
, URL dienkode sebagaimy-folder%2F
.
Mengelola akses pada folder
Bagian ini menjelaskan cara mengelola akses di folder Anda dengan menetapkan kebijakan Identity and Access Management (IAM), sehingga Anda bisa mendapatkan kontrol akses terperinci atas grup objek tertentu dalam bucket.
Untuk mengelola akses di folder Anda, ikuti langkah-langkah berikut:
Aktifkan pengelolaan di folder Anda dengan membuat folder terkelola dengan nama yang sama seperti folder yang ada. Untuk mengetahui petunjuk selengkapnya, lihat Membuat folder terkelola.
Langkah berikutnya
- Mengganti nama folder.
- Buat bucket dengan namespace hierarkis diaktifkan.
- Gunakan ruang nama hierarkis untuk workload Hadoop.
- Mengoptimalkan pengelolaan folder.
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