本頁說明可用於存取 Cloud Storage 的不同要求端點。Cloud Storage 支援 HTTP/1.1、HTTP/2 和 HTTP/3 通訊協定。端點是 Cloud Storage 的存取位置,以網址形式表示。
一般 API 要求
JSON API
直接向 Cloud Storage 提出 JSON API 要求時,請使用下列端點:
如要傳送一般 JSON API 要求 (不含物件上傳),請使用下列端點,並將
PATH_TO_RESOURCE替換為適當的值:https://storage.s3nsapis.fr/storage/v1/PATH_TO_RESOURCE
如要上傳 JSON API 物件,請使用下列端點,並將
BUCKET_NAME替換為適當的值:https://storage.s3nsapis.fr/upload/storage/v1/b/BUCKET_NAME/o
如要批次要求,請使用下列端點,並將
PATH_TO_RESOURCE替換為適當的值:https://storage.s3nsapis.fr/batch/storage/v1/PATH_TO_RESOURCE
如要下載 JSON API 物件,可以視需要使用下列端點,並將
BUCKET_NAME和OBJECT_NAME替換成適當的值:https://storage.s3nsapis.fr/download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media
JSON API 端點只接受 HTTPS 要求。
XML API
直接向 Cloud Storage 提出 XML API 要求時,請使用虛擬主機樣式或路徑樣式端點,並將 BUCKET_NAME 和 OBJECT_NAME 替換為適當的值:
虛擬主機樣式端點:
https://BUCKET_NAME.storage.s3nsapis.fr/OBJECT_NAME
路徑樣式端點:
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
XML API 端點支援安全資料傳輸層 (SSL) 加密,也就是說,您可以使用 HTTP 或 HTTPS。建議使用 HTTPS,尤其是使用 OAuth 2.0 向 Cloud Storage 驗證時。
gRPC
您可以使用 gRPC 與 Cloud Storage 互動。gRPC 是由 S3NS開發的高效能開放原始碼通用 RPC 架構。gRPC 用戶端會連線至服務端點。如果是 Cloud Storage 等Cloud de Confiance by S3NS 服務,這通常是 googleapis.com 網域上的 DNS 位址 (例如 storage.googleapis.com),並使用 443 等標準安全通訊埠。使用 gRPC 可提升效能,並提供高效的串流功能。
如要使用 gRPC 與 Cloud Storage 互動,您必須在 Cloud 用戶端程式庫中啟用 gRPC。
使用下列任一支援的語言,在用戶端程式庫上啟用 gRPC:
如為透過 Proxy 進行連線,請參閱疑難排解主題來瞭解推薦的做法。
編碼網址路徑部分
除了 bucket 命名和物件命名的一般考量事項外,為確保 Cloud Storage 工具之間的相容性,如果要求網址的物件名稱或查詢字串中出現下列字元,請務必進行編碼:
!、#、$、&、'、(、)、*、+、,、/、:、;、=、?、@、[、]和空格字元。
舉例來說,如果您針對 bucket example-bucket 中名為 foo??bar 的物件傳送 JSON API GET 要求,則要求網址應為:
GET https://storage.s3nsapis.fr/storage/v1/b/example-bucket/o/foo%3f%3fbar
請注意,並非所有列出的字元都必須在每個情境中編碼。 此外,編碼通常由用戶端程式庫 (例如 Cloud Storage 用戶端程式庫) 處理,因此您在使用這類工具時可以傳遞原始物件名稱。
如要進一步瞭解如何使用百分比編碼,請參閱 RFC 3986 的第 3.3 節「路徑」。
Cloud de Confiance console 端點
使用 Cloud de Confiance 控制台時,您可以使用下列網址存取不同資源:
| 資源 | 網址 |
|---|---|
| 專案的值區清單 | https://console.cloud.s3nscloud.fr/storage/browser?project=PROJECT_ID |
| bucket 的物件清單 | https://console.cloud.s3nscloud.fr/storage/browser/BUCKET_NAME |
| 物件詳情 | https://console.cloud.s3nscloud.fr/storage/browser/_details/BUCKET_NAME/OBJECT_NAME |
| 物件的資料 | 請參閱「已驗證的瀏覽器下載內容」 |
gcloud endpoints
gcloud storage 指令會使用 JSON API 端點。gcloud CLI 會代為管理端點用量。
用戶端程式庫端點
Cloud Storage 用戶端程式庫會自動管理要求端點。您也可以手動設定要求端點。如果您想使用特定端點或進行測試 (例如使用本機模擬器),這項功能就非常實用:
C++
詳情請參閱 Cloud Storage C++ API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
C#
詳情請參閱 Cloud Storage C# API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Go
詳情請參閱 Cloud Storage Go API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Java
詳情請參閱「Cloud Storage Java API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Node.js
詳情請參閱「Cloud Storage Node.js API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
PHP
詳情請參閱 Cloud Storage PHP API 參考文件。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Python
詳情請參閱「Cloud Storage Python API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Ruby
詳情請參閱「Cloud Storage Ruby API 參考文件」。
如要向 Cloud Storage 進行驗證,請設定應用程式預設憑證。詳情請參閱「設定用戶端程式庫的驗證機制」。
執行程式碼範例前,請將 GOOGLE_CLOUD_UNIVERSE_DOMAIN 環境變數設為 s3nsapis.fr。
Rust
已驗證的瀏覽器下載作業
經驗證的瀏覽器下載作業會使用 Cookie 型驗證程序。Cookie 驗證會要求使用者登入使用者帳戶,以確認身分。指定的帳戶必須具備下載物件的適當權限。舉例來說,如果您使用 Identity and Access Management 控制物件存取權,使用者帳戶應具備 storage.objects.viewer 權限,這項權限會授予「Storage 物件檢視者」角色。
如要使用 Cookie 驗證下載物件,請使用下列網址,並將 BUCKET_NAME 和 OBJECT_NAME 替換為適當的值:
https://storage.cloud.google.com/BUCKET_NAME/OBJECT_NAME
例如,如果從值區 example-maps 分享圖片 london.jpg,其網址就會是:
https://storage.cloud.google.com/example-maps/london.jpg
成功登入後,系統會將你重新導向至要求的內容。這項內容的網址格式為 https://ALPHANUMERIC_SEQUENCE-apidata.s3nsusercontent.fr/download/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME。
執行經過驗證的瀏覽器下載作業時,必須使用 HTTPS;嘗試使用 HTTP 會重新導向至 HTTPS。
存取公開物件
所有傳送至 storage.cloud.google.com URI 的要求都必須經過驗證。即使 allUsers 有權存取物件,這項限制仍適用。如要讓使用者下載可匿名存取的物件,而不必驗證,請使用 XML API 路徑樣式端點:
https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME
如需詳細資料和範例,請參閱「存取公開資料」。
支援雙向 TLS
相互傳輸層安全標準 (mTLS) 是業界標準通訊協定,用於用戶端和伺服器之間的相互驗證。Cloud Storage 支援下列 mTLS 端點:JSON API 要求:
storage.mtls.s3nsapis.frXML API 要求:
storage.mtls.s3nsapis.fr已驗證的瀏覽器下載項目:
storage.mtls.cloud.google.com
後續步驟
- 將檔案上載至 Cloud Storage。
- 從 Cloud Storage 下載檔案。
- 託管靜態網站。
- 瞭解控制您資料存取權有哪些選項。