Cloud Composer 1 | Cloud Composer 2 | Cloud Composer 3
En esta página, se explica cómo asignar etiquetas a tus entornos de Cloud Composer y, luego, desglosar los costos de facturación en función de estas etiquetas.
Información acerca de las etiquetas de entorno
Las etiquetas de entorno son pares clave-valor que puedes asignar a tus entornos. Por ejemplo, si owner:engineering-team
es una etiqueta personalizada, owner
es la clave y engineering-team
es el valor.
Cada entorno puede tener varias etiquetas, pero las claves de etiqueta de un entorno único deben ser únicas. Puedes asignar la misma clave y valor a varios entornos.
Etiquetas de entorno en informes de facturación
Las etiquetas de entorno que asignas a tus entornos son visibles en los informes de facturación, por lo que puedes desglosar los costos según las claves y los valores de las etiquetas.
Las etiquetas no se aplican de forma retroactiva. Por ejemplo, si asignas una etiqueta el 15 de mayo, los costos de facturación del 14 de mayo no contienen la etiqueta asignada.
Asigna etiquetas a entornos nuevos
Puedes asignar etiquetas cuando creas un entorno. Para obtener más información, consulta Crea entornos.
Asigna etiquetas a los entornos existentes
Console
Ve a la página Entornos en la consola de Google Cloud:
Selecciona tu entorno.
Ve a la pestaña Etiquetas.
Haz clic en Editar y, luego, en Agregar etiqueta.
Agrega un par clave-valor para la etiqueta y haz clic en Guardar.
Espera hasta que se actualice el entorno.
gcloud
Cuando actualizas un entorno con el comando gcloud composer
, los siguientes argumentos especifican etiquetas para el entorno:
--clear-labels
quita todas las etiquetas.--update-labels
actualiza las etiquetas especificadas. Crea etiquetas nuevas si aún no existen.--remove-labels
quita las etiquetas especificadas. Se ignoran las etiquetas especificadas que no existen.
Si usas varios de estos argumentos, se aplican en el siguiente orden: --clear-labels
, --update-labels
, --remove-labels
.
Actualiza o crea etiquetas
gcloud composer environments update ENVIRONMENT_NAME \
--location LOCATION \
--update-labels LABEL_KEY=LABEL_VALUE
Quita las etiquetas especificadas
gcloud composer environments update ENVIRONMENT_NAME \
--location LOCATION \
--remove-labels LABEL_KEY
Quita todas las etiquetas
gcloud composer environments update ENVIRONMENT_NAME \
--location LOCATION \
--clear-labels
Reemplaza lo siguiente:
ENVIRONMENT_NAME
por el nombre del entorno.LOCATION
por la región en la que se encuentra el entornoLABEL_KEY
por la clave de etiqueta de entorno que deseas crear, actualizar o quitar.LABEL_VALUE
por el valor de la etiqueta de entorno.
Ejemplo
En el siguiente ejemplo, se actualiza la etiqueta owner
, se crea la nueva etiqueta env
y se quita la etiqueta misc
:
gcloud composer environments update example-environment \
--location us-central1 \
--update-labels owner=engineering-team,env=production \
--remove-labels misc
API
Cuando actualizas un entorno, en el recurso Entorno, especifica etiquetas nuevas de tu entorno.
Reemplaza todas las etiquetas
Para reemplazar todas las etiquetas, incluye labels
en el parámetro de consulta updateMask
y proporciona un reemplazo en el cuerpo de la solicitud.
// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels
{
"labels":{
"LABEL_KEY": "LABEL_VALUE"
}
}
Reemplaza lo siguiente:
LABEL_KEY
por una clave de la etiqueta del entorno.LABEL_VALUE
por un valor nuevo para la etiqueta de entorno.
Ejemplo:
// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels
{
"labels": {
"owner": "engineering-team",
"env": "production"
}
}
Quita todas las etiquetas
Para quitar todas las etiquetas, incluye labels
en el parámetro de consulta updateMask
y no proporciones el valor de reemplazo.
Actualiza etiquetas individuales
Para actualizar una etiqueta o agregar una etiqueta nueva a las etiquetas existentes, incluye labels.LABEL_KEY
en el parámetro de consulta updateMask
y proporciona un reemplazo en el cuerpo de la solicitud.
// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask=labels.LABEL_KEY
{
"labels":{
"LABEL_KEY": "LABEL_VALUE"
}
}
Reemplaza lo siguiente:
LABEL_KEY
por una clave de la etiqueta del entorno.LABEL_VALUE
por un valor nuevo para la etiqueta de entorno.
Ejemplo:
// PATCH https://composer.googleapis.com/v1/
// ?name=projects/example-project/locations/
// us-central1/environments/example-environment
// &updateMask=labels.owner,labels.env
{
"labels": {
"owner": "engineering-team",
"env": "production"
}
}
Quita etiquetas individuales
Para quitar etiquetas, incluye labels.LABEL_KEY
en el parámetro de consulta updateMask
y no proporciones el valor de reemplazo.
Terraform
Para crear un entorno con parámetros predeterminados como una ubicación especificada, edita el bloque labels
en la configuración de Terraform y ejecuta terraform apply
.
resource "google_composer_environment" "example" {
name = "example-environment"
region = "us-central1"
labels = {
LABEL_KEY = "LABEL_VALUE"
}
}
Reemplaza lo siguiente:
LABEL_KEY
por la clave de la etiqueta de entorno que deseas crear o actualizar. Para quitar etiquetas, borra sus campos.LABEL_VALUE
por el valor de la etiqueta de entorno.
Ejemplo:
resource "google_composer_environment" "example" {
name = "example-environment"
region = "us-central1"
labels = {
owner = "engineering-team"
env = "production"
}
}
Visualiza etiquetas en los informes
Una vez que las etiquetas de tu entorno se propaguen a los informes de facturación, puedes desglosar los costos de facturación en función de las siguientes etiquetas:
Visualiza los informes de la Facturación de Cloud correspondientes a tu cuenta.
En la página Informes (Reports), haz lo siguiente:
- Haz clic en Mostrar filtros.
- En el cuadro de diálogo Filtros, expande la sección Etiquetas.
- Filtra los datos que se muestran según las claves y los valores de tus etiquetas de entorno.