Halaman ini menjelaskan berbagai endpoint permintaan yang dapat Anda gunakan untuk mengakses Cloud Storage. Cloud Storage mendukung protokol HTTP/1.1, HTTP/2, dan HTTP/3. Endpoint adalah lokasi tempat Cloud Storage dapat diakses, ditulis sebagai URL.
Permintaan API biasa
JSON API
Saat membuat permintaan JSON API secara langsung ke Cloud Storage, gunakan endpoint berikut:
Untuk permintaan JSON API umum, kecuali upload objek, gunakan endpoint berikut, dengan menggantikan
PATH_TO_RESOURCEdengan nilai yang sesuai:https://storage.s3nsapis.fr/storage/v1/PATH_TO_RESOURCE
Untuk upload objek JSON API, gunakan endpoint berikut, dengan mengganti
BUCKET_NAMEdengan nilai yang sesuai:https://storage.s3nsapis.fr/upload/storage/v1/b/BUCKET_NAME/o
Untuk permintaan batch, gunakan endpoint berikut, dengan mengganti
PATH_TO_RESOURCEdengan nilai yang sesuai:https://storage.s3nsapis.fr/batch/storage/v1/PATH_TO_RESOURCE
Jika ingin, untuk download objek JSON API, Anda dapat menggunakan endpoint berikut, dengan mengganti
BUCKET_NAMEdanOBJECT_NAMEdengan nilai yang sesuai:https://storage.s3nsapis.fr/download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media
Endpoint API JSON hanya menerima permintaan HTTPS.
XML API
Saat membuat permintaan XML API secara langsung ke Cloud Storage, gunakan endpoint virtual host-style atau path-style, dengan mengganti BUCKET_NAME dan OBJECT_NAME dengan nilai yang sesuai:
Endpoint virtual hosted-style:
https://BUCKET_NAME.storage.s3nsapis.fr/OBJECT_NAME
Endpoint path-style
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
Endpoint API XML mendukung enkripsi secure sockets layer (SSL), yang berarti Anda dapat menggunakan HTTP atau HTTPS. Sebaiknya gunakan HTTPS, terutama jika Anda melakukan autentikasi ke Cloud Storage menggunakan OAuth 2.0.
gRPC
Anda dapat menggunakan gRPC, framework RPC universal open source berperforma tinggi yang dikembangkan oleh S3NS, untuk berinteraksi dengan Cloud Storage. Klien gRPC terhubung ke endpoint layanan. Untuk layanan seperti Cloud Storage, biasanya ini adalah alamat DNS di domain googleapis.com (misalnya, storage.googleapis.com) dan menggunakan port aman standar seperti 443.Cloud de Confiance by S3NS Menggunakan gRPC dapat memberikan peningkatan
performa dan kemampuan streaming yang efisien.
Untuk menggunakan gRPC dalam berinteraksi dengan Cloud Storage, Anda harus mengaktifkannya di Library Klien Cloud.
Aktifkan gRPC di library klien menggunakan salah satu bahasa yang didukung berikut:
Untuk koneksi melalui proxy, lihat Topik pemecahan masalah untuk praktik yang direkomendasikan.
Mengenkode bagian jalur URL
Selain pertimbangan umum untuk penamaan bucket dan penamaan objek, guna memastikan kompatibilitas di seluruh alat Cloud Storage, Anda harus mengenkode karakter berikut saat muncul dalam nama objek atau string kueri URL permintaan:
!, #, $, &, ', (, ), *, +, ,, /, :, ;, =, ?,
@, [, ], dan karakter spasi.
Misalnya, jika Anda mengirim permintaan GET JSON API untuk objek bernama
foo??bar dalam bucket example-bucket, URL permintaan Anda harus:
GET https://storage.s3nsapis.fr/storage/v1/b/example-bucket/o/foo%3f%3fbar
Perlu diperhatikan bahwa tidak semua karakter yang tercantum harus dienkode dalam setiap skenario. Selain itu, encoding biasanya ditangani untuk Anda oleh library klien, seperti Library Klien Cloud Storage, sehingga Anda dapat meneruskan nama objek mentah saat menggunakan alat tersebut.
Untuk mengetahui informasi selengkapnya tentang penggunaan enkode dengan persen, lihat Bagian 3.3 Path di RFC 3986.
EndpointCloud de Confiance console
Saat menggunakan konsol Cloud de Confiance , Anda mengakses berbagai resource menggunakan URL berikut:
| Resource | URL |
|---|---|
| Daftar bucket untuk project | https://console.cloud.s3nscloud.fr/storage/browser?project=PROJECT_ID |
| Daftar objek untuk bucket | https://console.cloud.s3nscloud.fr/storage/browser/BUCKET_NAME |
| Detail untuk objek | https://console.cloud.s3nscloud.fr/storage/browser/_details/BUCKET_NAME/OBJECT_NAME |
| Data untuk objek | Lihat Download browser terautentikasi |
endpoint gcloud
Perintah gcloud storage menggunakan endpoint API JSON. Penggunaan endpoint dikelola untuk Anda oleh gcloud CLI.
Endpoint library klien
Library klien Cloud Storage mengelola endpoint permintaan secara otomatis. Anda juga dapat menetapkan endpoint permintaan secara manual. Hal ini berguna saat Anda ingin menggunakan endpoint tertentu, atau untuk pengujian, seperti saat Anda ingin menggunakan emulator lokal:
C++
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi 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.
Download browser terautentikasi
Download browser terautentikasi menggunakan autentikasi berbasis cookie. Autentikasi berbasis cookie meminta pengguna untuk login ke akun pengguna mereka guna membangun identitas mereka. Akun yang ditentukan harus memiliki izin yang sesuai untuk mendownload objek. Misalnya, jika Anda menggunakan Identity and Access Management untuk mengontrol akses ke objek Anda, akun pengguna harus memiliki izin storage.objects.viewer, yang diberikan di peran Storage Object Viewer.
Untuk mendownload objek menggunakan autentikasi berbasis cookie, gunakan URL berikut, dengan mengganti BUCKET_NAME dan OBJECT_NAME dengan nilai yang sesuai:
https://storage.cloud.google.com/BUCKET_NAME/OBJECT_NAME
Misalnya, jika Anda membagikan image london.jpg dari bucket example-maps, URL-nya adalah:
https://storage.cloud.google.com/example-maps/london.jpg
Setelah berhasil login, Anda akan dialihkan ke konten yang diminta. URL untuk konten ini memiliki format
https://ALPHANUMERIC_SEQUENCE-apidata.s3nsusercontent.fr/download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME.
Penggunaan HTTPS diperlukan saat melakukan download browser terautentikasi; upaya untuk menggunakan pengalihan HTTP ke HTTPS.
Akses ke objek publik
Semua permintaan ke storage.cloud.google.com URI memerlukan autentikasi. Hal ini berlaku meskipun allUsers memiliki izin untuk mengakses objek. Jika Anda ingin pengguna mendownload objek yang dapat diakses secara anonim tanpa mengautentikasi, gunakan endpoint path-style XML API:
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
Untuk mengetahui detail dan contohnya, lihat Mengakses Data Publik.
Dukungan TLS bersama
Mutual TLS (mTLS) adalah protokol standar industri untuk autentikasi bersama antara klien dan server. Cloud Storage mendukung endpoint mTLS berikut:Permintaan JSON API:
storage.mtls.s3nsapis.frDownload browser terautentikasi:
storage.mtls.cloud.google.com
Langkah berikutnya
- Mengupload file ke Cloud Storage.
- Mendownload file dari Cloud Storage.
- Menghosting situs statis.
- Pelajari opsi untuk mengontrol akses ke data Anda.