Halaman ini menunjukkan cara membaca data objek dari bucket Cloud Storage langsung ke memori aplikasi atau secara interaktif di browser web atau terminal command line. Membaca objek ke dalam memori atau secara interaktif direkomendasikan saat Anda ingin melakukan streaming, memeriksa, atau memproses data dengan cara yang menghindari overhead CPU, I/O disk, dan latensi yang terkait dengan penulisan file ke dalam sistem file lokal yang persisten.
Untuk mengetahui petunjuk tentang cara mendownload objek ke penyimpanan persisten atau lokal, lihat Mendownload objek. Untuk ringkasan konseptual tentang pembacaan dan download objek, lihat Pembacaan dan download objek.
Peran yang diperlukan
Untuk mendapatkan izin yang Anda perlukan untuk membaca data objek, minta administrator untuk memberi Anda peran IAM berikut:
- Storage Object Viewer (
roles/storage.objectViewer) di bucket - Storage Admin (
roles/storage.admin) di project (hanya diperlukan untuk membaca data objek menggunakan konsol Cloud de Confiance )
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Peran Storage Object Viewer (roles/storage.objectViewer) berisi izin
storage.objects.get, yang diperlukan untuk membaca objek. Peran
Storage Admin (roles/storage.admin) berisi izin storage.buckets.list
dan storage.buckets.get, selain izin storage.objects.get. Izin ini diperlukan untuk mencantumkan bucket dalam project
dan melihat informasi tentang bucket. Peran Storage Admin (roles/storage.admin) yang mencakup izin ini hanya diperlukan jika Anda ingin membaca objek secara interaktif menggunakan konsol Cloud de Confiance .
Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.
Untuk mengetahui petunjuk tentang cara memberikan peran pada bucket, lihat Menetapkan dan mengelola kebijakan IAM pada bucket.
Membaca objek secara terprogram ke dalam memori
Bagian ini menjelaskan cara membaca data objek dengan melakukan streaming byte objek langsung ke memori aplikasi.
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.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
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.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
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.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
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.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
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.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
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.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
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.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
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.
Sebelum menjalankan contoh kode, tetapkan variabel
lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.
Rust
Membaca objek secara interaktif
Bagian ini menjelaskan cara membaca objek secara interaktif di
Cloud de Confiance jendela browser konsol atau terminal command line stdout.
Konsol
- Di konsol Cloud de Confiance , buka halaman Buckets Cloud Storage.
Di daftar bucket, klik nama bucket yang isinya ingin Anda lihat.
Di tab Objects, klik nama objek yang ingin Anda baca.
Di halaman Object details, klik URL publik atau URL yang diautentikasi dari objek untuk membaca datanya.
Command line
Untuk mengalirkan payload byte objek langsung ke terminal Anda stdout,
gunakan perintah gcloud storage cat:
gcloud storage cat gs://BUCKET_NAME/OBJECT_NAME
Ganti kode berikut:
BUCKET_NAME: nama bucket yang berisi objek yang ingin Anda baca. Contoh,my-bucket.OBJECT_NAME: nama objek yang ingin Anda baca. Contoh,dog.png.
REST API
Untuk membaca byte objek dan mengarahkan aliran output ke terminal
stdout, gunakan petunjuk berikut.
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization.Gunakan
cURLuntuk memanggil JSON API dengan permintaanobjects.getyang menyertakan opsi-o -dan parameter kuerialt=media:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o - \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Ganti kode berikut:
BUCKET_NAME: nama bucket yang berisi objek yang ingin Anda baca. Contoh,my-bucket.OBJECT_NAME: nama objek yang dienkode ke URL yang ingin Anda baca. Contohnya,pets/dog.png, yang berenkode URL menjadipets%2Fdog.png.
XML API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization.Gunakan
cURLuntuk memanggil XML API dengan permintaan ObjekGET:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME"
Ganti kode berikut:
BUCKET_NAME: nama bucket yang berisi objek yang ingin Anda baca. Contoh,my-bucket.OBJECT_NAME: nama objek yang dienkode ke URL yang ingin Anda baca. Contohnya,pets/dog.png, yang berenkode URL menjadipets%2Fdog.png.