值區、物件以及 ACL
值區是能在此讀取與寫入檔案的儲存位置,使用 Cloud Storage 適用的 App Engine 用戶端程式庫時,請務必指定值區。您的專案可存取多個值區。請注意,用戶端程式庫不支援建立值區。
存取控制清單 (ACL) 控制了值區以及值區內物件的存取權。當您在專案中建立值區時,您的專案以及 App Engine 應用程式將自動新增至允許值區存取權限的 ACL 中。
請注意,具有值區存取權限的 ACL 與該值區中管理物件的很多 ACL 不同。因此,您的應用程式對本身啟用的值區具有讀寫權限,但只對在值區中建立的物件有完全的權限。您的應用程式對其他應用程式或其他人所建立物件的存取權限,會受限於由物件建立者給予您應用程式的權限。
如果在值區中建立物件,但沒有明確定義 ACL,則會使用值區擁有者指派給值區的預設物件 ACL。如果值區擁有者未指定預設物件 ACL,物件的預設值為 public-read
,也就是說,任何擁有值區存取權的使用者都可以讀取物件。
ACL 和用戶端程式庫
使用用戶端程式庫的應用程式無法變更值區 ACL,但可以指定用以控制應用程式所建物件存取權的 ACL。有關可用 ACL 設定的說明,請參閱開啟方法的說明文件。修改 Cloud Storage 物件
一旦您在值區中建立物件,即無法再加以修改或附加項目。您必須使用相同名稱 (包含有您所需項目) 的新物件,來覆寫該物件。
Cloud Storage 以及子目錄
建立物件時,Cloud Storage 適用的 App Engine 用戶端程式庫可讓您提供子目錄分隔符號,但 Cloud Storage 中並沒有真正的子目錄。Cloud Storage 中的子目錄是物件檔案名稱的一部分。
例如,您可能認為建立物件 somewhere/over/the/rainbow.mp3
時,會將檔案 rainbow.mp3
儲存在子目錄 somewhere/over/the/
中,而是將物件名稱設為 somewhere/over/the/rainbow.mp3
。
使用 listbucket
篩選功能時,請務必瞭解這個概念。
如果上述列出行為對您而言不是最佳做法,listbucket
提供可選的資料夾模擬模式。詳情請參閱 listbucket 一節。
後續步驟
- 參閱 API 參考資料說明文件。
- 瞭解如何設定 Cloud Storage。