借助标签,您可以整理 Google Cloud 项目并跟踪不同团队或环境的费用。如需管理项目标签,您可以使用Google Cloud 控制台、Google Cloud CLI 或 Cloud Resource Manager API。
标签仅适用于项目。文件夹和组织资源不支持标签,并且您附加到项目的标签不会自动传播到子资源。如需在特定服务资源(例如 Compute Engine 实例或 Cloud Storage 存储桶)上应用或更新标签,请参阅资源文档或支持标签的服务。例如,Pub/Sub 支持主题和订阅吞吐量结算的标签,但出站流量结算 SKU 不支持标签。
为项目创建标签
控制台
要为单个项目添加标签,请执行以下操作:
在 Google Cloud 控制台中打开标签页面。
从选择项目下拉列表中选择您的项目。
要添加新标签条目,请点击 + 添加标签并为要添加的每个标签输入标签键和值。
添加完标签后,点击保存。
要同时为多个项目添加标签,请执行以下操作:
在 Google Cloud 控制台中打开管理资源页面。
在管理资源页面中,选择要为其添加标签的项目。
在信息面板的标签标签页中,点击 + 添加标签并为要添加的每个标签输入标签键和值。
添加完标签后,点击保存。
添加了标签后,您可以对项目进行过滤,方法是在项目列表上方的过滤框中输入标签键或值。过滤框会建议键和值,以便您预览结果。
gcloud
如需使用 gcloud CLI 创建带有标签的新项目,请使用带有 --labels 标志的 gcloud projects create 命令:
gcloud projects create PROJECT_ID \
--labels=KEY1=VALUE1,KEY2=VALUE2
如需向现有项目添加标签,请使用带有 --update-labels 标志的 gcloud projects update 命令:
gcloud projects update PROJECT_ID \
--update-labels=KEY1=VALUE1,KEY2=VALUE2
其中:
PROJECT_ID是您要创建或更新的项目的 ID。KEY1=VALUE1是要添加的标签的键值对。
REST
如需创建带有标签的新项目,请在向 projects.create 方法发出 POST 请求时添加 labels 字段:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"projectId": "PROJECT_ID",
"displayName": "PROJECT_NAME",
"labels": {
"environment": "development"
}
}' \
"https://cloudresourcemanager.googleapis.com/v3/projects"
如需向现有项目添加标签,请使用 projects.patch 方法:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"labels": {
"environment": "development"
}
}' \
"https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"
更新项目的标签
控制台
如需更新单个项目的标签,请执行以下操作:在 Google Cloud 控制台中打开标签页面。
从选择项目下拉列表中选择您的项目。
更新项目的标签:
- 如需修改标签,请点击要修改的值,然后进行所需的更改。
- 要删除标签,请将指针悬停在键或值上,然后点击 。
更新完标签后,点击保存。
要同时为多个项目更新标签,请执行以下操作:
在 Google Cloud 控制台中打开管理资源页面。
在管理资源页面中,选择要为其更新标签的项目。
在信息面板中,点击标签标签页并更新所选项目的标签:
- 如需修改标签,请点击要修改的值,然后进行所需的更改。
- 要删除标签,请将指针悬停在键或值上,然后点击 。
更新完标签后,点击保存。
gcloud
如需使用 gcloud CLI 更新项目的标签,请使用 gcloud projects update 命令以及 --update-labels、--remove-labels 或 --clear-labels 标志。
如需添加或更新标签,请执行以下操作:
gcloud projects update PROJECT_ID \
--update-labels=KEY1=VALUE1,KEY2=VALUE2
如需移除特定标签,请执行以下操作:
gcloud projects update PROJECT_ID \
--remove-labels=KEY1,KEY2
如需从项目中移除所有标签,请执行以下操作:
gcloud projects update PROJECT_ID \
--clear-labels
REST
如需使用 API 更新项目的标签,请向 projects.patch 方法发送 PATCH 请求:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
"labels": {
"color": "red"
}
}' \
"https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID?updateMask=labels"
其中,PROJECT_ID 是您要更新的项目的 ID。