本頁面顯示跨源資源共享 (CORS) 的設定範例。 在值區中設定 CORS 設定後,您就能允許不同來源的資源進行互動,但通常為防止惡意行為而遭到禁止。
基本 CORS 設定
假設您有一個動態網站,使用者可透過 your-example-website.appspot.com
存取。您在名為 your-example-bucket
的 Cloud Storage bucket 中代管圖片檔案。您想在網站上使用該圖片,因此必須在 your-example-bucket
上套用 CORS 設定,讓使用者的瀏覽器可以從該 bucket 要求資源。根據下列設定,預檢要求有效時間為 1 小時,且成功的瀏覽器要求會在回應中傳回資源的 Content-Type
。
指令列
gcloud 指令範例
gcloud storage buckets update gs://example_bucket --cors-file=example_cors_file.json
包含 CORS 設定的 JSON 檔案範例
[ { "origin": ["https://your-example-website.appspot.com"], "method": ["GET"], "responseHeader": ["Content-Type"], "maxAgeSeconds": 3600 } ]
如要進一步瞭解如何使用 Google Cloud CLI 設定 CORS 設定,請參閱 gcloud storage buckets update
參考說明文件。
REST API
JSON API
{ "cors": [ { "origin": ["https://your-example-website.appspot.com"], "method": ["GET"], "responseHeader": ["Content-Type"], "maxAgeSeconds": 3600 } ] }
如需 CORS 設定檔的通用格式,請參閱 JSON 適用的值區資源表示法。
XML API
<?xml version="1.0" encoding="UTF-8"?> <CorsConfig> <Cors> <Origins> <Origin>https://your-example-website.appspot.com</Origin> </Origins> <Methods> <Method>GET</Method> </Methods> <ResponseHeaders> <ResponseHeader>Content-Type</ResponseHeader> </ResponseHeaders> <MaxAgeSec>3600</MaxAgeSec> </Cors> </CorsConfig>
如需 CORS 設定檔的通用格式,請參閱 XML 適用的 CORS 設定格式。
從值區移除 CORS 設定
如要從值區中移除 CORS 設定,請提供空白的 CORS 設定檔。
指令列
使用 gcloud storage buckets update
指令並加上 --clear-cors
標記,即可從值區中移除 CORS 設定:
gcloud storage buckets update gs://BUCKET_NAME --clear-cors
其中 BUCKET_NAME 是要移除 CORS 設定的值區名稱。
用戶端程式庫
C++
詳情請參閱 Cloud Storage C++ API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何從值區移除所有現有的 CORS 設定:
C#
詳情請參閱 Cloud Storage C# API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何從值區移除所有現有的 CORS 設定:
Go
詳情請參閱 Cloud Storage Go API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何從值區移除所有現有的 CORS 設定:
Java
詳情請參閱 Cloud Storage Java API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何從值區移除所有現有的 CORS 設定:
Node.js
詳情請參閱 Cloud Storage Node.js API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何從值區移除所有現有的 CORS 設定:
PHP
詳情請參閱 Cloud Storage PHP API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何從值區移除所有現有的 CORS 設定:
Python
詳情請參閱 Cloud Storage Python API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何從值區移除所有現有的 CORS 設定:
Ruby
詳情請參閱 Cloud Storage Ruby API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何從值區移除所有現有的 CORS 設定:
REST API
JSON API
在值區上設定時,下列設定會從值區中移除所有 CORS 設定:
{ "cors": [] }
如需 CORS 設定檔的通用格式,請參閱 JSON 適用的值區資源表示法。
XML API
在值區上設定時,下列設定會從值區中移除所有 CORS 設定:
<CorsConfig></CorsConfig>
如需 CORS 設定檔的通用格式,請參閱 XML 適用的 CORS 設定格式。
後續步驟
- 進一步瞭解跨源資源共享 (CORS)。
- 設定及查看值區的 CORS 設定。