本文档详细介绍了如何使用 Resource Manager API 和 Google Cloud 控制台为项目创建和更新标签。其中详细介绍了如何使用标签了解费用,以及支持标签的服务。
为项目创建标签
控制台
要为单个项目添加标签,请执行以下操作:
在 Google Cloud 控制台中打开标签页面。
从选择项目下拉列表中选择您的项目。
要添加新标签条目,请点击 + 添加标签并为要添加的每个标签输入标签键和值。
添加完标签后,点击保存。
要同时为多个项目添加标签,请执行以下操作:
在 Google Cloud 控制台中打开管理资源页面。
在管理资源页面中,选择要为其添加标签的项目。
在信息面板的标签标签页中,点击 + 添加标签并为要添加的每个标签输入标签键和值。
添加完标签后,点击保存。
添加了标签后,您可以对项目进行过滤,方法是在项目列表上方的过滤框中输入标签键或值。过滤框会建议键和值,以便您预览结果。
REST
要创建带有标签的新项目,请在创建项目时设置 labels
字段。
请求:
POST https://cloudresourcemanager.googleapis.com/v3/projects { "labels": { "color": "red" }, "name": "myproject", "projectId": "our-project-123" }
响应:
{ "projectNumber": "333197460082", "projectId": "our-project-123", "lifecycleState": "ACTIVE", "name": "myproject", "labels": { "color": "red" }, "createTime": "2016-01-12T22:18:28.633Z", }
要为现有项目添加标签,请执行以下操作:
- 使用
projects.get()
方法获取项目。 - 修改
labels
字段。 - 使用
projects.patch()
方法更新项目。
添加标签后,您可以根据标签过滤项目。如需详细了解如何使用标签过滤项目,请参阅列出项目。
更新项目的标签
控制台
如需更新单个项目的标签,请执行以下操作:在 Google Cloud 控制台中打开标签页面。
从选择项目下拉列表中选择您的项目。
更新项目的标签:
- 如需修改标签,请点击要修改的值,然后进行所需的更改。
- 要删除标签,请将指针悬停在键或值上,然后点击 。
更新完标签后,点击保存。
要同时为多个项目更新标签,请执行以下操作:
在 Google Cloud 控制台中打开管理资源页面。
在管理资源页面中,选择要为其更新标签的项目。
在信息面板中,点击标签标签页并更新所选项目的标签:
- 如需修改标签,请点击要修改的值,然后进行所需的更改。
- 要删除标签,请将指针悬停在键或值上,然后点击 。
更新完标签后,点击保存。
REST
要更新项目的标签,请执行以下操作:
使用
projects.get()
方法获取project
对象。修改要更新的标签。
调用
projects.patch
方法。
以下示例会更新标签 color:blue
:
以下代码段会将 color
标签的值从 blue
更改为 red
。
请求:
PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NAME
{
updateMask=labels
}
其中,PROJECT_NAME
是要更新的项目的名称。
请求 JSON 正文:
{
"labels":
{
"color": "red"
}
}
回答:
{
"projects": [
{
"name": "projects/123456789012",
"parent": "folders/123456789012",
"projectId": "my-project",
"state": "ACTIVE",
"displayName": "PROJECT_NAME"
"createTime": "2013-11-13T20:31:53.308Z"
"updateTime": "2013-11-13T20:35:42.308Z"
"etag": "BwWUlZ6XEfY="
"labels": {
"color": "red"
},
}
]
}