En este documento, se proporcionan detalles sobre cómo crear y actualizar etiquetas para los proyectos que usan la API de Resource Manager y la consola de Google Cloud. Proporciona detalles sobre cómo comprender los costos con el uso de etiquetas y los servicios que admiten etiquetas.
Crea etiquetas para los proyectos
Console
Para agregar etiquetas a un solo proyecto, sigue estos pasos:
Abre la página Etiquetas en la consola de Google Cloud.
Selecciona tu proyecto del menú desplegable Seleccionar un proyecto.
Para agregar una nueva entrada de etiqueta, haz clic en + Agregar etiqueta y, luego, ingresa una clave y valor de etiqueta para cada etiqueta que desees agregar.
Cuando termines de agregar etiquetas, haz clic en Guardar.
Para agregar etiquetas a más de un proyecto al mismo tiempo, sigue estos pasos:
Abre la página Administrar recursos en la consola de Google Cloud.
En la página Administrar recursos, selecciona los proyectos de a las que quieres agregarles etiquetas.
En el panel de información, en la pestaña Etiquetas, haz clic en + Agregar etiqueta y, luego, ingresa una clave y un valor de etiqueta para cada etiqueta que desees agregar.
Cuando termines de agregar etiquetas, haz clic en Guardar.
Luego de agregar las etiquetas, puedes escribir una clave o valor de etiqueta en el cuadro de filtro sobre la lista de proyectos para filtrar proyectos. El cuadro de filtro sugerirá claves y valores para que puedas obtener una vista previa de los resultados.
REST
Para crear un proyecto nuevo con una etiqueta, establece el campo labels
cuando lo crees
el proyecto.
Solicitud:
POST https://cloudresourcemanager.googleapis.com/v3/projects { "labels": { "color": "red" }, "name": "myproject", "projectId": "our-project-123" }
Respuesta:
{ "projectNumber": "333197460082", "projectId": "our-project-123", "lifecycleState": "ACTIVE", "name": "myproject", "labels": { "color": "red" }, "createTime": "2016-01-12T22:18:28.633Z", }
Si deseas agregar etiquetas a proyectos existentes, haz lo siguiente:
- Obtén el proyecto mediante el método
projects.get()
. - Modifica el campo
labels
. - Actualiza el proyecto con el método
projects.patch()
.
Una vez que agregues etiquetas, podrás filtrar proyectos en función de ellas. Para obtener detalles sobre Si usas etiquetas para filtrar proyectos, consulta Crea una lista de proyectos.
Actualiza las etiquetas de los proyectos
Console
Para actualizar las etiquetas de un solo proyecto, haz lo siguiente:Abre la página Etiquetas en la consola de Google Cloud.
Selecciona tu proyecto del menú desplegable Seleccionar un proyecto.
Actualiza las etiquetas de tu proyecto:
- Para editar una etiqueta, haz clic en el valor que deseas editar y, luego, realizar los cambios que desees.
- Para borrar una etiqueta, mantén el puntero sobre la clave o el valor y, luego, haz clic en
Cuando termines de actualizar las etiquetas, haz clic en Guardar.
Para actualizar las etiquetas de más de un proyecto al mismo tiempo, sigue estos pasos:
Abre la página Administrar recursos en la consola de Google Cloud.
En la página Administrar recursos, selecciona los proyectos de en las que quieres actualizar las etiquetas.
En el panel de información, haz clic en la pestaña Etiquetas y actualiza las etiquetas de la proyectos seleccionados:
- Para editar una etiqueta, haz clic en el valor que deseas editar y, luego, realizar los cambios que desees.
- Para borrar una etiqueta, mantén el puntero sobre la clave o el valor y, luego, haz clic en
Cuando termines de actualizar las etiquetas, haz clic en Guardar.
REST
Para actualizar las etiquetas de un proyecto, haz lo siguiente:
Obtén el objeto
project
con elprojects.get()
.Modifica las etiquetas que deseas actualizar.
Llama al método
projects.patch
.
En el siguiente ejemplo, se actualiza la etiqueta color:blue
:
El siguiente fragmento de código cambia el valor de la etiqueta color
de blue
a red
.
Solicitud:
PATCH https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_NAME
{
updateMask=labels
}
En el ejemplo anterior, PROJECT_NAME
es el nombre del proyecto que deseas.
para actualizarlo.
Cuerpo JSON de la solicitud:
{
"labels":
{
"color": "red"
}
}
Respuesta:
{
"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"
},
}
]
}