Cloud Composer 3 | Cloud Composer 2 | Cloud Composer 1
Esta página explica como atribuir etiquetas aos seus ambientes do Cloud Composer e, em seguida, discriminar os custos de faturação com base nestas etiquetas.
Acerca das etiquetas de ambiente
As etiquetas de ambiente são pares de chave-valor que pode atribuir aos seus ambientes. Por exemplo, se owner:engineering-team for uma etiqueta personalizada, então
owner é a chave e engineering-team é o valor.
Cada ambiente pode ter várias etiquetas, mas as chaves de etiquetas de um único ambiente têm de ser únicas. Pode atribuir a mesma chave e valor a vários ambientes.
Etiquetas de ambiente nos relatórios de custos
As etiquetas de ambiente que atribui aos seus ambientes são visíveis nos relatórios de faturação, para que possa discriminar os custos com base nas chaves e nos valores das etiquetas.
As etiquetas não se aplicam retroativamente. Por exemplo, se atribuir uma etiqueta a 15 de maio, os custos de faturação de 14 de maio não contêm a etiqueta atribuída.
Atribua etiquetas a novos ambientes
Pode atribuir etiquetas quando cria um ambiente. Para mais informações, consulte o artigo Criar ambientes.
Atribua etiquetas a ambientes existentes
Consola
Aceda à página Ambientes na Google Cloud consola:
Selecione o seu ambiente.
Aceda ao separador Etiquetas.
Clique em Editar e, de seguida, em Adicionar etiqueta.
Adicione um par de chave-valor para a etiqueta e, de seguida, clique em Guardar.
Aguarde até que o ambiente seja atualizado.
gcloud
Quando atualiza um ambiente com o comando gcloud composer, os seguintes argumentos especificam etiquetas para o ambiente:
--clear-labelsremove todas as etiquetas.--update-labelsatualiza as etiquetas especificadas; cria novas etiquetas se ainda não existirem.--remove-labelsremove as etiquetas especificadas; as etiquetas especificadas que não existam são ignoradas.
Se usar vários destes argumentos, são aplicados pela seguinte ordem: --clear-labels, --update-labels e --remove-labels.
Atualize ou crie etiquetas
gcloud composer environments update ENVIRONMENT_NAME \
--location LOCATION \
--update-labels LABEL_KEY=LABEL_VALUE
Remova etiquetas específicas
gcloud composer environments update ENVIRONMENT_NAME \
--location LOCATION \
--remove-labels LABEL_KEY
Remova todas as etiquetas
gcloud composer environments update ENVIRONMENT_NAME \
--location LOCATION \
--clear-labels
Substituição:
ENVIRONMENT_NAMEcom o nome do ambiente.LOCATIONcom a região onde o ambiente está localizado.LABEL_KEYcom a chave da etiqueta de ambiente que quer criar, atualizar ou remover.LABEL_VALUEcom o valor da etiqueta do ambiente.
Exemplo
O exemplo seguinte atualiza a etiqueta owner, cria a nova etiqueta env
e remove a etiqueta misc:
gcloud composer environments update example-environment \
--location us-central1 \
--update-labels owner=engineering-team,env=production \
--remove-labels misc
API
Quando atualiza um ambiente, no recurso Environment, especifique novas etiquetas do seu ambiente.
Substitua todas as etiquetas
Para substituir todas as etiquetas, inclua labels no parâmetro de consulta updateMask e forneça uma substituição no corpo do pedido.
// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels
{
"labels":{
"LABEL_KEY": "LABEL_VALUE"
}
}
Substituição:
LABEL_KEYcom uma chave da etiqueta de ambiente.LABEL_VALUEcom um novo valor para a etiqueta de ambiente.
Exemplo:
// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask.fieldPaths=labels
{
"labels": {
"owner": "engineering-team",
"env": "production"
}
}
Remova todas as etiquetas
Para remover todas as etiquetas, inclua labels no parâmetro de consulta updateMask e não faculte o valor de substituição.
Atualize etiquetas individuais
Para atualizar uma etiqueta ou adicionar uma nova etiqueta às etiquetas existentes, inclua labels.LABEL_KEY no parâmetro de consulta updateMask e forneça uma substituição no corpo do pedido.
// PATCH https://composer.googleapis.com/v1/
// ?{name=projects/*/locations/*/environments/*}
// &updateMask=labels.LABEL_KEY
{
"labels":{
"LABEL_KEY": "LABEL_VALUE"
}
}
Substituição:
LABEL_KEYcom uma chave da etiqueta de ambiente.LABEL_VALUEcom um novo valor para a etiqueta de ambiente.
Exemplo:
// 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"
}
}
Remova etiquetas individuais
Para remover etiquetas, inclua labels.LABEL_KEY no parâmetro de consulta updateMask e não faculte o valor de substituição.
Terraform
Para criar um ambiente com parâmetros predefinidos numa localização especificada,
edite o bloco labels na sua configuração do Terraform e execute terraform apply.
resource "google_composer_environment" "example" {
name = "example-environment"
region = "us-central1"
labels = {
LABEL_KEY = "LABEL_VALUE"
}
}
Substituição:
LABEL_KEYcom a chave da etiqueta do ambiente que quer criar ou atualizar. Para remover etiquetas, elimine os respetivos campos.LABEL_VALUEcom o valor da etiqueta do ambiente.
Exemplo:
resource "google_composer_environment" "example" {
name = "example-environment"
region = "us-central1"
labels = {
owner = "engineering-team"
env = "production"
}
}
Veja etiquetas nos relatórios
Depois de as etiquetas do seu ambiente serem propagadas aos relatórios de faturação, pode discriminar os custos de faturação com base nestas etiquetas:
Ver relatórios do Cloud Billing para a sua conta do Cloud Billing.
Na página Relatórios:
- Clique em Mostrar filtros.
- Na caixa de diálogo Filtros, expanda a secção Etiquetas.
- Filtre os dados apresentados com base nas chaves e nos valores das etiquetas do ambiente.