本頁說明如何新增、修改、移除及查看 Cloud Storage bucket 設定的標籤。
必要的角色
如要取得新增及管理值區標籤的必要權限,請要求管理員為您授予值區的「儲存空間管理員」(roles/storage.admin
) IAM 角色。
這個預先定義的角色具備新增及管理值區標籤所需的權限。如要查看確切的必要權限,請展開「必要權限」部分:
所需權限
storage.buckets.get
storage.buckets.list
- 如果您打算使用Google Cloud 控制台執行本頁的操作說明,才需要這項權限。
storage.buckets.update
您或許還可透過自訂角色取得這些權限。
如需如何授予值區角色的操作說明,請參閱「搭配值區使用 IAM」。
新增、修改或移除值區的標籤
控制台
- 在 Google Cloud 控制台,前往「Cloud Storage bucket」頁面。
在 bucket 清單中,點選要新增、修改或移除標籤的 bucket 名稱。
在「Bucket details」(值區詳細資料) 頁面中,按一下「Configuration」(設定) 分頁標籤。
按一下「標籤」的「編輯」圖示 (edit)。
標籤編輯器視窗隨即顯示。
如要新增標籤,請按一下「新增標籤」add_box按鈕,並為標籤指定
key
和value
。如要修改現有標籤,請按一下「值」,然後輸入新值。
如要移除標籤,請按一下與要移除的標籤相關聯的垃圾桶圖示。
按一下 [儲存]。
如要瞭解如何透過 Google Cloud 控制台取得 Cloud Storage 作業失敗的詳細錯誤資訊,請參閱「疑難排解」一文。
指令列
如要新增標籤或更新現有標籤,請將 gcloud storage buckets update
指令搭配 --update-labels
旗標使用。例如:
gcloud storage buckets update gs://BUCKET_NAME --update-labels=KEY_1=VALUE_1
地點
BUCKET_NAME
是要套用此標籤的值區名稱。例如:my-bucket
。KEY_1
是標籤的鍵名稱。例如:pet
。VALUE_1
是標籤的值。例如:dog
。
如要移除現有標籤,請使用 -remove-labels
旗標。例如:
gcloud storage buckets update gs://BUCKET_NAME --remove-labels=KEY_1
如要變更多個標籤,請在相關旗標中以逗號分隔的清單加入標籤,然後使用先前的指令。例如 --update-labels=blue-key=cyan,red-key=ruby
。
如要移除附加至值區的所有標籤,請使用下列指令:
gcloud storage buckets update gs://BUCKET_NAME --clear-labels
用戶端程式庫
C++
詳情請參閱 Cloud Storage C++ API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何將指定標籤新增至值區,或修改值區的現有標籤:
下例示範如何從值區移除指定標籤:
C#
詳情請參閱 Cloud Storage C# API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何將指定標籤新增至值區,或修改值區的現有標籤:
下例示範如何從值區移除指定標籤:
Go
詳情請參閱 Cloud Storage Go API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何將指定標籤新增至值區,或修改值區的現有標籤:
下例示範如何從值區移除指定標籤:
Java
詳情請參閱 Cloud Storage Java API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何將指定標籤新增至值區,或修改值區的現有標籤:
下例示範如何從值區移除指定標籤:
Node.js
詳情請參閱 Cloud Storage Node.js API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何將指定標籤新增至值區,或修改值區的現有標籤:
下例示範如何從值區移除指定標籤:
PHP
詳情請參閱 Cloud Storage PHP API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何將指定標籤新增至值區,或修改值區的現有標籤:
下例示範如何從值區移除指定標籤:
Python
詳情請參閱 Cloud Storage Python API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何將指定標籤新增至值區,或修改值區的現有標籤:
下例示範如何從值區移除指定標籤:
Ruby
詳情請參閱 Cloud Storage Ruby API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
下例示範如何將指定標籤新增至值區,或修改值區的現有標籤:
下例示範如何從值區移除指定標籤:
REST API
JSON API
安裝並初始化 gcloud CLI,以便為
Authorization
標頭產生存取權杖。建立包含下列資訊的 JSON 檔案:
{ "labels": { "KEY_1": "VALUE_1" } }
地點
KEY_1
是標籤的鍵名稱。例如:pet
。VALUE_1
是標籤的值。例如:dog
。如要移除金鑰,請使用null
取代"<var>VALUE_1</var>"
。
使用
cURL
透過PATCH
Bucket 要求呼叫 JSON API:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=labels"
其中:
JSON_FILE_NAME
是您在步驟 2 建立的 JSON 檔案路徑。BUCKET_NAME
是要套用此標籤的值區名稱。例如:my-bucket
。
您可以在要求中新增、編輯或移除多個 key:value
組合。
XML API
安裝並初始化 gcloud CLI,以便為
Authorization
標頭產生存取權杖。建立包含下列資訊的 XML 檔案:
<Tagging> <TagSet> <Tag> <Key>KEY_1</Key> <Value>VALUE_1</Value> </Tag> </TagSet> </Tagging>
其中:
KEY_1
是標籤的鍵名稱。例如:pet
。VALUE_1
是標籤的值。例如:dog
。
請注意,您可以在單一要求中新增多個
<Tag>
元素。如要移除值區的所有標籤,請在檔案中使用單一空白的<Tag>
元素:<Tagging> <TagSet> <Tag> </Tag> </TagSet> </Tagging>
使用
cURL
透過PUT
值區要求和tagging
查詢字串參數呼叫 XML API:curl -X PUT --data-binary @XML_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?tagging"
其中:
XML_FILE_NAME
是您在步驟 2 建立的 XML 檔案路徑。BUCKET_NAME
是要套用此標籤的值區名稱。例如:my-bucket
。
查看值區標籤
控制台
- 在 Google Cloud 控制台,前往「Cloud Storage bucket」頁面。
按一下要查看標籤的值區名稱。
按一下 [設定] 標籤。
Bucket 上設定的標籤會列在「標籤」欄位中。
如要瞭解如何透過 Google Cloud 控制台取得 Cloud Storage 作業失敗的詳細錯誤資訊,請參閱「疑難排解」一文。
指令列
使用加上 --format
旗標的 gcloud storage buckets describe
指令:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(labels)"
其中 BUCKET_NAME
是您要查看其標籤的值區名稱。例如:my-bucket
。
如果成功,且值區有標籤,回應會類似以下內容:
labels: red-key: ruby blue-key: cyan
如果成功,且值區沒有標籤,回應會類似下列內容:
null
用戶端程式庫
C++
詳情請參閱 Cloud Storage C++ API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
如要查看 bucket 的標籤,請按照顯示 bucket 中繼資料的操作說明進行,並在回應中尋找標籤欄位。C#
詳情請參閱 Cloud Storage C# API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
如要查看 bucket 的標籤,請按照顯示 bucket 中繼資料的操作說明進行,並在回應中尋找標籤欄位。Go
詳情請參閱 Cloud Storage Go API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
如要查看 bucket 的標籤,請按照顯示 bucket 中繼資料的操作說明進行,並在回應中尋找標籤欄位。Java
詳情請參閱 Cloud Storage Java API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
如要查看 bucket 的標籤,請按照顯示 bucket 中繼資料的操作說明進行,並在回應中尋找標籤欄位。Node.js
詳情請參閱 Cloud Storage Node.js API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
如要查看 bucket 的標籤,請按照顯示 bucket 中繼資料的操作說明進行,並在回應中尋找標籤欄位。PHP
詳情請參閱 Cloud Storage PHP API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
如要查看 bucket 的標籤,請按照顯示 bucket 中繼資料的操作說明進行,並在回應中尋找標籤欄位。Python
詳情請參閱 Cloud Storage Python API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
如要查看 bucket 的標籤,請按照顯示 bucket 中繼資料的操作說明進行,並在回應中尋找標籤欄位。Ruby
詳情請參閱 Cloud Storage Ruby API 參考說明文件。
如要驗證 Cloud Storage,請設定應用程式預設憑證。 詳情請參閱「設定用戶端程式庫的驗證機制」。
如要查看 bucket 的標籤,請按照顯示 bucket 中繼資料的操作說明進行,並在回應中尋找標籤欄位。REST API
JSON API
安裝並初始化 gcloud CLI,以便為
Authorization
標頭產生存取權杖。使用
cURL
透過包含fields=labels
查詢字串參數的GET
值區要求呼叫 JSON API:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=labels"
其中
BUCKET_NAME
是您要查看其標籤的值區名稱。例如:my-bucket
。
回應類似下列範例:
{ "labels" : { (your_label_key): your_label_value }, }
XML API
安裝並初始化 gcloud CLI,以便為
Authorization
標頭產生存取權杖。使用
cURL
透過GET
值區要求和tagging
查詢字串參數呼叫 XML API:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME?tagging"
其中
BUCKET_NAME
是您要查看其標籤的值區名稱。例如:my-bucket
。
回應類似下列範例:
<Tagging> <TagSet> <Tag> <Key>your_label_key</Key> <Value>your_label_value</Value> </Tag> </TagSet> </Tagging>
後續步驟
- 瞭解值區標記。
- 取得其他值區中繼資料。