Esta página foi traduzida pela API Cloud Translation.

Organize recursos usando rótulos,Organize recursos usando rótulos
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Rótulos são pares de valores-chave que podem ser usados em Google Cloud para agrupar recursos relacionados ou associados. Por exemplo, no Compute Engine, você pode usar rótulos para agrupar VMs em categorias como produção, preparação ou desenvolvimento para poder pesquisar recursos que pertencem a cada estágio de desenvolvimento.

Depois de adicionar rótulos aos seus recursos, você pode aproveitar o recurso de filtragem aninhada para realizar pesquisas mais precisas nos seus recursos usando rótulos.

Antes de começar

Leia a documentação dos discos permanentes .
Leia a documentação das imagens .
Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. After installing the Google Cloud CLI, initialize it by running the following command:
  gcloud init
  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
  
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

O que são rótulos?

Um rótulo é um par de valores-chave que você pode atribuir a Google Cloud instâncias. Eles ajudam você a organizar esses recursos e a gerenciar seus custos em grande escala, com a granularidade necessária. Você pode anexar um rótulo a cada recurso e depois filtrar os recursos com base em seus rótulos. As informações sobre as etiquetas são encaminhadas para o sistema de faturamento, que permite dividir as cobranças faturadas por etiqueta. Com relatórios de faturamento integrados, você pode filtrar e agrupar custos por rótulos de recursos. Você também pode usar rótulos para consultar exportações de dados de faturamento .

Requisitos para rótulos

Os rótulos aplicados a um recurso devem atender aos seguintes requisitos:

Cada recurso pode ter até 64 rótulos.
Cada rótulo deve ser um par de valores-chave.
As chaves têm comprimento mínimo de 1 caractere e máximo de 63 caracteres e não podem ficar vazias. Os valores podem estar vazios e ter no máximo 63 caracteres.
Chaves e valores podem conter apenas letras minúsculas, caracteres numéricos, sublinhados e travessões. Todos os caracteres devem usar codificação UTF-8 e caracteres internacionais são permitidos. As chaves devem começar com uma letra minúscula ou caractere internacional.
A parte chave de um rótulo deve ser exclusiva em um único recurso. No entanto, você pode usar a mesma chave com vários recursos.

Esses limites se aplicam à chave e ao valor de cada rótulo e ao indivíduo Google Cloud recursos que possuem rótulos. Não há limite de quantos rótulos você pode aplicar em todos os recursos de um projeto.

Usos comuns de rótulos

Aqui estão alguns casos de uso comuns para rótulos:

Rótulos de equipe ou centro de custo : adicione rótulos com base na equipe ou centro de custo para distinguir instâncias pertencentes a equipes diferentes (por exemplo, team:research e team:analytics ). Você pode usar esse tipo de rótulo para contabilidade de custos ou orçamento.
Rótulos de componentes : por exemplo, component:redis , component:frontend , component:ingest e component:dashboard .
Rótulos de ambiente ou estágio : por exemplo, environment:production e environment:test .
Rótulos de estado : por exemplo, state:active , state:readytodelete e state:archive .
Rótulos de propriedade : Utilizados para identificar as equipes responsáveis pelas operações, por exemplo: team:shopping-cart .

Rótulos de máquina virtual : um rótulo pode ser anexado a uma máquina virtual. As tags de máquina virtual definidas anteriormente aparecem como um rótulo sem valor.

Não recomendamos a criação de um grande número de rótulos exclusivos, como carimbos de data/hora ou valores individuais para cada chamada de API. O problema com esta abordagem é que quando os valores mudam frequentemente ou com chaves que sobrecarregam o catálogo, isso torna difícil filtrar e reportar eficazmente os recursos.

Rótulos e tags

Os rótulos podem ser usados como anotações consultáveis para recursos, mas não podem ser usados para definir condições nas políticas. As tags fornecem uma maneira de permitir ou negar condicionalmente políticas com base no fato de um recurso ter uma tag específica, fornecendo controle refinado sobre as políticas. Para obter mais informações, consulte a Visão geral das tags .

Usar rótulos no Compute Engine

É possível aplicar rótulos aos seguintes recursos do Compute Engine:

Instâncias de máquinas virtuais (VM)
Imagens
Discos permanentes
Instantâneos de disco permanente

Você também pode usar rótulos em Google Cloud componentes como os seguintes:

Intervalos do Cloud Storage
Recursos de rede:
- Regras de encaminhamento
- Túneis VPN ( visualização )
- Endereços IP externos estáticos ( visualização )

Por exemplo, você pode adicionar os seguintes rótulos como pares de valores-chave aos seus recursos:

{
 "labels": {
    "vmrole": "webserver",
    "environment": "production",
    "location": "west",...
    }
 }

Crie recursos com rótulos

Ao criar um novo recurso, você pode aplicar rótulos ao recurso.

Console

Vá para a página de recursos que você deseja criar.
- Para instâncias de VM, acesse Criar uma instância .
- Para discos, vá para Criar um disco .
- Para instantâneos, vá para Criar um instantâneo .
- Para imagens, vá para Criar uma imagem .
Em Rótulos , clique em Adicionar rótulo .
Continue com o processo de criação.

gcloud

Para adicionar um rótulo, use o subcomando create com o sinalizador --labels . Você pode adicionar rótulos aos recursos do Compute Engine usando os seguintes comandos gcloud :

Para instâncias de VM, use o comando gcloud compute instances create .
Para snapshots, use o comando gcloud compute disks snapshot .
Para imagens, use o comando gcloud compute images create .
Para discos, use o comando gcloud compute disks create .

Exemplo

gcloud compute instances create ... \
    --labels webserver=backend,media=images

API

Na API, durante a solicitação POST para adicionar um novo recurso, adicione a propriedade labels no corpo da solicitação para aplicar rótulos ao novo recurso.

Para instâncias de VM, use o método instances.insert() .
Para instantâneos, use o método disks.createSnapshot() .
Para imagens, use o método images.insert() .
Para discos, use o método disks.insert() .

Por exemplo, o snippet a seguir faz uma solicitação POST para criar uma instância de VM com os rótulos webserver:backend e media:images :

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances

{
 "name": "myVM",
 "machineType": "zones/us-central1-f/machineTypes/custom-2-15360-ext",
  ...,
 "labels": {
   "webserver": "backend",
   "media": "images"
  }
}

Adicionar ou atualizar rótulos em recursos existentes

Você pode adicionar rótulos ou atualizar rótulos existentes em recursos usando o console do Google Cloud, a CLI gcloud ou a API Compute Engine. Para adicionar ou atualizar rótulos para regras de encaminhamento, use a CLI gcloud ou a API Compute Engine.

Console

Vá para a página de recursos à qual deseja adicionar rótulos.
- Para instâncias de VM, acesse Instâncias de VM .
- Para instantâneos, vá para Instantâneos .
- Para imagens, vá para Imagens .
- Para discos, vá para Discos .
- Para endereços IP externos estáticos, acesse Endereços IP externos .
- Para túneis VPN, acesse VPN .
Marque as caixas de seleção ao lado dos recursos que você deseja rotular.
Para expandir a coluna de rótulos, clique em Mostrar painel de informações .
No painel, selecione Rótulos .
Para adicionar rótulos, clique em Adicionar rótulo e adicione o par chave-valor.
Para atualizar rótulos, selecione os rótulos existentes e modifique seus valores.
Salve suas alterações.

gcloud

Para adicionar ou alterar um rótulo, use o subcomando update com o sinalizador --update-labels . É possível atualizar rótulos para os recursos do Compute Engine usando os seguintes comandos gcloud :

Para instâncias de VM, use o comando gcloud compute instances update .
Para snapshots, use o comando gcloud compute snapshots update .
Para imagens, use o comando gcloud compute images update .
Para discos, use o comando gcloud compute disks update .
Para regras de encaminhamento, use o comando gcloud compute forwarding-rules update .
Para endereços IP externos estáticos, use o comando gcloud beta compute addresses update .
Para túneis VPN, use o comando gcloud beta compute vpn-tunnels update .

Exemplo

gcloud compute disks update example-disk \
    --update-labels backend=webserver,media=images

Se você fornecer uma chave de rótulo que já existe, a CLI do Google Cloud atualizará a chave existente com o novo valor do rótulo. Se você fornecer uma nova chave, a ferramenta adicionará a nova chave à lista de rótulos.

API

Para adicionar ou atualizar rótulos, faça uma solicitação POST ao método setLabels do recurso com a impressão digital mais recente e uma lista completa de rótulos a serem aplicados:

Para instâncias de VM, use o método instances.setLabels() .
Para instantâneos, use o método snapshots.setLabels() .
Para imagens, use o método images.setLabels() .
Para discos, use o método disks.setLabels() .
Para regras de encaminhamento, use o método forwardingRules.setLabels() .
Para endereços IP externos estáticos regionais, use o método beta addresses.setLabels() .
Para endereços IP externos estáticos globais, use o método beta globalAddresses.setLabels() .
Para túneis VPN, use o método beta vpnTunnels.setLabels() .

Semelhante aos metadados e tags, se o recurso tiver rótulos existentes que você deseja manter, você deverá incluir esses rótulos na solicitação, juntamente com quaisquer novos rótulos que você deseja adicionar.

Por exemplo, o snippet a seguir faz uma solicitação POST a uma instância de VM para definir os rótulos environment:test e an-existing-tag:yes :

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance/setLabels

{
 "labels": {
  "environment": "test",
  "an-existing-tag": "yes"
 },
 "labelFingerprint": "42WmSpB8rSM="
}

Ver rótulos

É possível visualizar rótulos de recursos usando o console do Google Cloud, a CLI gcloud ou a API Compute Engine. Para visualizar rótulos de regras de encaminhamento, use a CLI gcloud ou a API Compute Engine.

Console

Vá para a página de recursos.
- Para instâncias de VM, acesse Instâncias de VM .
- Para instantâneos, vá para Instantâneos .
- Para imagens, vá para Imagens .
- Para discos, vá para Discos .
- Para endereços IP externos estáticos, acesse Endereços IP externos .
- Para túneis VPN, acesse VPN .
Clique no recurso para visualizar seus detalhes.
Localize os rótulos .

gcloud

Para visualizar rótulos, use o subcomando describe . É possível visualizar rótulos dos recursos do Compute Engine usando os seguintes comandos gcloud :

Para instâncias de VM, use o comando gcloud compute instances describe .
Para snapshots, use o gcloud compute snapshots describe .
Para imagens, use o gcloud compute images describe .
Para discos, use o comando gcloud compute disks describe .
Para regras de encaminhamento, use o gcloud compute forwarding-rules describe .
Para endereços IP externos estáticos, use o comando gcloud beta compute addresses describe .
Para túneis VPN. use o comando gcloud beta compute vpn-gateways describe .

Exemplo

gcloud compute disks describe example-disk

A saída contém os rótulos:

...
id: '5047929990219134234'
kind: compute#disk
labelFingerprint: GHZ1Un209U=0
labels:
  environment: dev
  department: finance
...

API

Para recuperar rótulos, faça uma solicitação GET ao seguinte recurso:

Para instâncias de VM, use o método instances.get() .
Para instantâneos, use o método snapshots.get() .
Para imagens, use o método images.get() .
Para discos, use o método disks.get() .
Para regras de encaminhamento, use o método forwardingRules.get() .
Para endereços IP externos estáticos regionais, use o método beta addresses.get() .
Para endereços IP externos estáticos globais, use o método beta globalAddresses.get() .
Para túneis VPN, use o método beta vpnTunnels.get() .

Por exemplo, o snippet a seguir faz uma solicitação GET para recuperar rótulos de uma instância de VM:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

Substitua o seguinte:

PROJECT_ID : o ID do projeto
ZONE : a zona da VM
VM_NAME : o nome da VM

Obtenha uma impressão digital de rótulo para solicitações de API

Ao atualizar ou adicionar rótulos na API, você precisa fornecer a impressão digital dos rótulos mais recentes com sua solicitação, para evitar conflitos com outras solicitações. Uma impressão digital só é necessária para solicitações de API; o console do Google Cloud e a ferramenta Google Cloud CLI não exigem impressão digital.

Para obter os labelsFingerprint mais recentes, faça uma solicitação GET para os seguintes recursos:

Para instâncias de VM, use o método instances.get() .
Para instantâneos, use o método snapshots.get() .
Para imagens, use o método images.get() .
Para discos, use o método disks.get() .
Para regras de encaminhamento, use o método forwardingRules.get() .
Para endereços IP externos estáticos regionais, use o método beta addresses.get() .
Para endereços IP externos estáticos globais, use o método beta globalAddresses.get() .
Para túneis VPN, use o método beta vpnTunnels.get() .

Por exemplo, o snippet a seguir obtém um labelsFingerprint para uma instância de VM:

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance

A resposta contém a propriedade labelFingerprint :

200 OK

{
 "kind": "compute#instance",
 "id": "4392196237934605253",
 "creationTimestamp": "2015-09-15T14:05:16.475-07:00",
 "zone": "https://content.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f",
 "status": "RUNNING",
 ...
 "labels": {
  "environment": "test"
 },
 "labelFingerprint": "p1ty_9HoBk0="
}

Remover um rótulo

É possível remover rótulos de recursos usando o console do Google Cloud, a CLI gcloud ou a API Compute Engine. Para remover rótulos de regras de encaminhamento, use a CLI gcloud ou a API Compute Engine.

Console

Vá para a página do recurso da qual deseja remover os rótulos.
- Para instâncias de VM, acesse Instâncias de VM .
- Para instantâneos, vá para Instantâneos .
- Para imagens, vá para Imagens .
- Para discos, vá para Discos .
- Para endereços IP externos estáticos, acesse Endereços IP externos .
- Para túneis VPN, acesse VPN .
Marque as caixas de seleção ao lado dos recursos dos quais você deseja remover rótulos.
Para expandir a coluna de rótulos, clique em Mostrar painel de informações .
Para excluir um rótulo, clique em Excluir .
Salve suas alterações.

gcloud

Para adicionar ou alterar um rótulo, use o subcomando update com o sinalizador --remove-labels . Você pode remover rótulos dos recursos do Compute Engine usando os seguintes comandos gcloud :

Para instâncias de VM, use o comando gcloud compute instances update .
Para snapshots, use o comando gcloud compute snapshots update .
Para imagens, use o comando gcloud compute images update .
Para discos, use o comando gcloud compute disks update .
Para regras de encaminhamento, use o comando gcloud compute forwarding-rules update .
Para endereços IP externos estáticos, use o comando gcloud beta compute addresses update .
Para túneis VPN, use o comando gcloud beta compute vpn-tunnels update .

Exemplo

gcloud compute disks update example-disk \
    --remove-labels backend,media

API

Para remover rótulos, faça uma solicitação POST ao método setLabels do seguinte recurso com a impressão digital mais recente e uma lista completa de rótulos a serem aplicados:

Para instâncias de VM, use o método instances.setLabels() .
Para instantâneos, use o método snapshots.setLabels() .
Para imagens, use o método images.setLabels() .
Para discos, use o método disks.setLabels() .
Para regras de encaminhamento, use o método forwardingRules.setLabels() .
Para endereços IP externos estáticos regionais, use o método beta addresses.setLabels() .
Para endereços IP externos estáticos globais, use o método beta globalAddresses.setLabels() .
Para túneis VPN, use o método beta vpnTunnels.setLabels() .

Forneça os labelsFingerprint atuaisImpressão digital e uma lista vazia de rótulos para remover todos os rótulos ou forneça uma lista de rótulos que deseja manter (omitindo os rótulos que deseja remover). Por exemplo, o seguinte snippet remove todos os rótulos da VM:

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance/setLabels

{
 "labels": { },
 "labelFingerprint": "42WmSpB8rSM="
}

Filtrar pesquisas usando rótulos

Você pode pesquisar seus recursos e filtrar resultados por rótulos usando o console do Google Cloud, a CLI gcloud ou a API Compute Engine. Para filtrar regras de encaminhamento por rótulos, use a CLI gcloud ou a API Compute Engine.

Console

Vá para a página de recursos para a qual deseja obter uma lista filtrada de recursos.
- Para instâncias de VM, acesse Instâncias de VM .
- Para instantâneos, vá para Instantâneos .
- Para imagens, vá para Imagens .
- Para discos, vá para Discos .
- Para endereços IP externos estáticos, acesse Endereços IP externos .
- Para túneis VPN, acesse VPN .
Se solicitado, selecione seu projeto e clique em Continuar .
Na barra de pesquisa, insira sua chave, valor ou par de valores-chave. Seus resultados incluem quaisquer correspondências parciais.
Por exemplo, para mostrar apenas recursos com o rótulo env:dev , você pode inserir qualquer um dos seguintes:
- Digite a chave: env
- Insira o valor: dev
- Insira o par de valores-chave: env:dev

gcloud

Para filtrar com base em rótulos, use o subcomando list dos seguintes recursos com o sinalizador --filter :

Para instâncias de VM, use o comando gcloud compute instances list .
Para snapshots, use o comando gcloud compute snapshots list .
Para imagens, use o comando gcloud compute images list .
Para discos, use o comando gcloud compute disks list .
Para regras de encaminhamento, use o comando gcloud compute forwarding-rules list .
Para endereços IP externos estáticos, use o comando gcloud beta compute addresses list .
Para túneis VPN, use o comando gcloud beta compute vpn-tunnels list .

O valor do sinalizador --filter deve estar nos labels. KEY = VALUE . Por exemplo, se você quiser filtrar um rótulo com env como chave e dev como valor, você pode executar este comando:

gcloud compute instances list \
    --filter labels.env=dev

Para obter mais informações sobre a sintaxe do filtro na CLI gcloud, consulte a documentação gcloud topic filters .

API

Para filtrar recursos, faça uma solicitação GET ao método list dos seguintes recursos e inclua o campo filter:

Para instâncias de VM, use o método instances.list() .
Para instantâneos, use o método snapshots.list() .
Para imagens, use o método images.list() .
Para discos, use o método disks.list() .
Para regras de encaminhamento, use o método forwardingRules.list() .
Para endereços IP externos estáticos regionais, use o método beta addresses.list() .
Para endereços IP externos estáticos globais, use o método beta globalAddresses.list() .
Para túneis VPN, use o método beta vpnTunnels.list() .

Por exemplo, para listar todas as VMs no projeto myproject e na zona us-central1-a com um rótulo que tem um par de valores-chave de env:dev , defina o campo de filtro como labels.env:dev em sua solicitação list . Se você incluir o campo de filtro como um parâmetro de string de consulta, use um valor de parâmetro codificado em URL, filter=labels.env%3Adev :

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances?filter=labels.env%3Adev

Para mais informações, leia a documentação filter na referência da API Compute Engine.

Relacionamento entre rótulos de VM e tags de rede

No passado, rótulos e tags estavam relacionados. Por exemplo, se você adicionou um rótulo webserver:test a uma VM, o Compute Engine adicionou automaticamente uma tag webserver à VM.

Agora, rótulos e tags estão separados. Se você criar um rótulo em uma VM, o Compute Engine não criará uma tag para a VM. Se precisar criar uma tag em uma VM, você deverá criar a tag manualmente.

Para saber como criar tags, consulte Tags de rede .

O que vem a seguir

Saiba como adicionar tags de rede .
Aprenda sobre filtragem .

Depois de adicionar rótulos aos seus recursos, você pode aproveitar o recurso de filtragem aninhada para realizar pesquisas mais precisas nos seus recursos usando rótulos.

Antes de começar

Leia a documentação dos discos permanentes .
Leia a documentação das imagens .
Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:

Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. After installing the Google Cloud CLI, initialize it by running the following command:
  gcloud init
  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
  
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

O que são rótulos?

Requisitos para rótulos

Os rótulos aplicados a um recurso devem atender aos seguintes requisitos:

Cada recurso pode ter até 64 rótulos.
Cada rótulo deve ser um par de valores-chave.
As chaves têm comprimento mínimo de 1 caractere e máximo de 63 caracteres e não podem ficar vazias. Os valores podem estar vazios e ter no máximo 63 caracteres.
Chaves e valores podem conter apenas letras minúsculas, caracteres numéricos, sublinhados e travessões. Todos os caracteres devem usar codificação UTF-8 e caracteres internacionais são permitidos. As chaves devem começar com uma letra minúscula ou caractere internacional.
A parte chave de um rótulo deve ser exclusiva em um único recurso. No entanto, você pode usar a mesma chave com vários recursos.

Usos comuns de rótulos

Aqui estão alguns casos de uso comuns para rótulos:

Rótulos de equipe ou centro de custo : adicione rótulos com base na equipe ou centro de custo para distinguir instâncias pertencentes a equipes diferentes (por exemplo, team:research e team:analytics ). Você pode usar esse tipo de rótulo para contabilidade de custos ou orçamento.
Rótulos de componentes : por exemplo, component:redis , component:frontend , component:ingest e component:dashboard .
Rótulos de ambiente ou estágio : por exemplo, environment:production e environment:test .
Rótulos de estado : por exemplo, state:active , state:readytodelete e state:archive .
Rótulos de propriedade : Utilizados para identificar as equipes responsáveis pelas operações, por exemplo: team:shopping-cart .

Rótulos de máquina virtual : um rótulo pode ser anexado a uma máquina virtual. As tags de máquina virtual definidas anteriormente aparecem como um rótulo sem valor.

Rótulos e tags

Usar rótulos no Compute Engine

É possível aplicar rótulos aos seguintes recursos do Compute Engine:

Instâncias de máquinas virtuais (VM)
Imagens
Discos permanentes
Instantâneos de disco permanente

Você também pode usar rótulos em Google Cloud componentes como os seguintes:

Intervalos do Cloud Storage
Recursos de rede:
- Regras de encaminhamento
- Túneis VPN ( visualização )
- Endereços IP externos estáticos ( visualização )

Por exemplo, você pode adicionar os seguintes rótulos como pares de valores-chave aos seus recursos:

{
 "labels": {
    "vmrole": "webserver",
    "environment": "production",
    "location": "west",...
    }
 }

Crie recursos com rótulos

Ao criar um novo recurso, você pode aplicar rótulos ao recurso.

Console

Vá para a página de recursos que você deseja criar.
- Para instâncias de VM, acesse Criar uma instância .
- Para discos, vá para Criar um disco .
- Para instantâneos, vá para Criar um instantâneo .
- Para imagens, vá para Criar uma imagem .
Em Rótulos , clique em Adicionar rótulo .
Continue com o processo de criação.

gcloud

Para adicionar um rótulo, use o subcomando create com o sinalizador --labels . Você pode adicionar rótulos aos recursos do Compute Engine usando os seguintes comandos gcloud :

Para instâncias de VM, use o comando gcloud compute instances create .
Para snapshots, use o comando gcloud compute disks snapshot .
Para imagens, use o comando gcloud compute images create .
Para discos, use o comando gcloud compute disks create .

Exemplo

gcloud compute instances create ... \
    --labels webserver=backend,media=images

API

Na API, durante a solicitação POST para adicionar um novo recurso, adicione a propriedade labels no corpo da solicitação para aplicar rótulos ao novo recurso.

Para instâncias de VM, use o método instances.insert() .
Para instantâneos, use o método disks.createSnapshot() .
Para imagens, use o método images.insert() .
Para discos, use o método disks.insert() .

Por exemplo, o snippet a seguir faz uma solicitação POST para criar uma instância de VM com os rótulos webserver:backend e media:images :

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances

{
 "name": "myVM",
 "machineType": "zones/us-central1-f/machineTypes/custom-2-15360-ext",
  ...,
 "labels": {
   "webserver": "backend",
   "media": "images"
  }
}

Adicionar ou atualizar rótulos em recursos existentes

Console

Vá para a página de recursos à qual deseja adicionar rótulos.
- Para instâncias de VM, acesse Instâncias de VM .
- Para instantâneos, vá para Instantâneos .
- Para imagens, vá para Imagens .
- Para discos, vá para Discos .
- Para endereços IP externos estáticos, acesse Endereços IP externos .
- Para túneis VPN, acesse VPN .
Marque as caixas de seleção ao lado dos recursos que você deseja rotular.
Para expandir a coluna de rótulos, clique em Mostrar painel de informações .
No painel, selecione Rótulos .
Para adicionar rótulos, clique em Adicionar rótulo e adicione o par chave-valor.
Para atualizar rótulos, selecione os rótulos existentes e modifique seus valores.
Salve suas alterações.

gcloud

Para instâncias de VM, use o comando gcloud compute instances update .
Para snapshots, use o comando gcloud compute snapshots update .
Para imagens, use o comando gcloud compute images update .
Para discos, use o comando gcloud compute disks update .
Para regras de encaminhamento, use o comando gcloud compute forwarding-rules update .
Para endereços IP externos estáticos, use o comando gcloud beta compute addresses update .
Para túneis VPN, use o comando gcloud beta compute vpn-tunnels update .

Exemplo

gcloud compute disks update example-disk \
    --update-labels backend=webserver,media=images

API

Para adicionar ou atualizar rótulos, faça uma solicitação POST ao método setLabels do recurso com a impressão digital mais recente e uma lista completa de rótulos a serem aplicados:

Para instâncias de VM, use o método instances.setLabels() .
Para instantâneos, use o método snapshots.setLabels() .
Para imagens, use o método images.setLabels() .
Para discos, use o método disks.setLabels() .
Para regras de encaminhamento, use o método forwardingRules.setLabels() .
Para endereços IP externos estáticos regionais, use o método beta addresses.setLabels() .
Para endereços IP externos estáticos globais, use o método beta globalAddresses.setLabels() .
Para túneis VPN, use o método beta vpnTunnels.setLabels() .

Por exemplo, o snippet a seguir faz uma solicitação POST a uma instância de VM para definir os rótulos environment:test e an-existing-tag:yes :

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance/setLabels

{
 "labels": {
  "environment": "test",
  "an-existing-tag": "yes"
 },
 "labelFingerprint": "42WmSpB8rSM="
}

Ver rótulos

Console

Vá para a página de recursos.
- Para instâncias de VM, acesse Instâncias de VM .
- Para instantâneos, vá para Instantâneos .
- Para imagens, vá para Imagens .
- Para discos, vá para Discos .
- Para endereços IP externos estáticos, acesse Endereços IP externos .
- Para túneis VPN, acesse VPN .
Clique no recurso para visualizar seus detalhes.
Localize os rótulos .

gcloud

Para visualizar rótulos, use o subcomando describe . É possível visualizar rótulos dos recursos do Compute Engine usando os seguintes comandos gcloud :

Para instâncias de VM, use o comando gcloud compute instances describe .
Para snapshots, use o gcloud compute snapshots describe .
Para imagens, use o gcloud compute images describe .
Para discos, use o comando gcloud compute disks describe .
Para regras de encaminhamento, use o gcloud compute forwarding-rules describe .
Para endereços IP externos estáticos, use o comando gcloud beta compute addresses describe .
Para túneis VPN. use o comando gcloud beta compute vpn-gateways describe .

Exemplo

gcloud compute disks describe example-disk

A saída contém os rótulos:

...
id: '5047929990219134234'
kind: compute#disk
labelFingerprint: GHZ1Un209U=0
labels:
  environment: dev
  department: finance
...

API

Para recuperar rótulos, faça uma solicitação GET ao seguinte recurso:

Para instâncias de VM, use o método instances.get() .
Para instantâneos, use o método snapshots.get() .
Para imagens, use o método images.get() .
Para discos, use o método disks.get() .
Para regras de encaminhamento, use o método forwardingRules.get() .
Para endereços IP externos estáticos regionais, use o método beta addresses.get() .
Para endereços IP externos estáticos globais, use o método beta globalAddresses.get() .
Para túneis VPN, use o método beta vpnTunnels.get() .

Por exemplo, o snippet a seguir faz uma solicitação GET para recuperar rótulos de uma instância de VM:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

Substitua o seguinte:

PROJECT_ID : o ID do projeto
ZONE : a zona da VM
VM_NAME : o nome da VM

Obtenha uma impressão digital de rótulo para solicitações de API

Para obter os labelsFingerprint mais recentes, faça uma solicitação GET para os seguintes recursos:

Para instâncias de VM, use o método instances.get() .
Para instantâneos, use o método snapshots.get() .
Para imagens, use o método images.get() .
Para discos, use o método disks.get() .
Para regras de encaminhamento, use o método forwardingRules.get() .
Para endereços IP externos estáticos regionais, use o método beta addresses.get() .
Para endereços IP externos estáticos globais, use o método beta globalAddresses.get() .
Para túneis VPN, use o método beta vpnTunnels.get() .

Por exemplo, o snippet a seguir obtém um labelsFingerprint para uma instância de VM:

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance

A resposta contém a propriedade labelFingerprint :

200 OK

{
 "kind": "compute#instance",
 "id": "4392196237934605253",
 "creationTimestamp": "2015-09-15T14:05:16.475-07:00",
 "zone": "https://content.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f",
 "status": "RUNNING",
 ...
 "labels": {
  "environment": "test"
 },
 "labelFingerprint": "p1ty_9HoBk0="
}

Remover um rótulo

Console

Vá para a página do recurso da qual deseja remover os rótulos.
- Para instâncias de VM, acesse Instâncias de VM .
- Para instantâneos, vá para Instantâneos .
- Para imagens, vá para Imagens .
- Para discos, vá para Discos .
- Para endereços IP externos estáticos, acesse Endereços IP externos .
- Para túneis VPN, acesse VPN .
Marque as caixas de seleção ao lado dos recursos dos quais você deseja remover rótulos.
Para expandir a coluna de rótulos, clique em Mostrar painel de informações .
Para excluir um rótulo, clique em Excluir .
Salve suas alterações.

gcloud

Para instâncias de VM, use o comando gcloud compute instances update .
Para snapshots, use o comando gcloud compute snapshots update .
Para imagens, use o comando gcloud compute images update .
Para discos, use o comando gcloud compute disks update .
Para regras de encaminhamento, use o comando gcloud compute forwarding-rules update .
Para endereços IP externos estáticos, use o comando gcloud beta compute addresses update .
Para túneis VPN, use o comando gcloud beta compute vpn-tunnels update .

Exemplo

gcloud compute disks update example-disk \
    --remove-labels backend,media

API

Para remover rótulos, faça uma solicitação POST ao método setLabels do seguinte recurso com a impressão digital mais recente e uma lista completa de rótulos a serem aplicados:

Para instâncias de VM, use o método instances.setLabels() .
Para instantâneos, use o método snapshots.setLabels() .
Para imagens, use o método images.setLabels() .
Para discos, use o método disks.setLabels() .
Para regras de encaminhamento, use o método forwardingRules.setLabels() .
Para endereços IP externos estáticos regionais, use o método beta addresses.setLabels() .
Para endereços IP externos estáticos globais, use o método beta globalAddresses.setLabels() .
Para túneis VPN, use o método beta vpnTunnels.setLabels() .

POST https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-f/instances/example-instance/setLabels

{
 "labels": { },
 "labelFingerprint": "42WmSpB8rSM="
}

Filtrar pesquisas usando rótulos

Console

Vá para a página de recursos para a qual deseja obter uma lista filtrada de recursos.
- Para instâncias de VM, acesse Instâncias de VM .
- Para instantâneos, vá para Instantâneos .
- Para imagens, vá para Imagens .
- Para discos, vá para Discos .
- Para endereços IP externos estáticos, acesse Endereços IP externos .
- Para túneis VPN, acesse VPN .
Se solicitado, selecione seu projeto e clique em Continuar .
Na barra de pesquisa, insira sua chave, valor ou par de valores-chave. Seus resultados incluem quaisquer correspondências parciais.
Por exemplo, para mostrar apenas recursos com o rótulo env:dev , você pode inserir qualquer um dos seguintes:
- Digite a chave: env
- Insira o valor: dev
- Insira o par de valores-chave: env:dev

gcloud

Para filtrar com base em rótulos, use o subcomando list dos seguintes recursos com o sinalizador --filter :

Para instâncias de VM, use o comando gcloud compute instances list .
Para snapshots, use o comando gcloud compute snapshots list .
Para imagens, use o comando gcloud compute images list .
Para discos, use o comando gcloud compute disks list .
Para regras de encaminhamento, use o comando gcloud compute forwarding-rules list .
Para endereços IP externos estáticos, use o comando gcloud beta compute addresses list .
Para túneis VPN, use o comando gcloud beta compute vpn-tunnels list .

O valor do sinalizador --filter deve estar nos labels. KEY = VALUE . Por exemplo, se você quiser filtrar um rótulo com env como chave e dev como valor, você pode executar este comando:

gcloud compute instances list \
    --filter labels.env=dev

Para obter mais informações sobre a sintaxe do filtro na CLI gcloud, consulte a documentação gcloud topic filters .

API

Para filtrar recursos, faça uma solicitação GET ao método list dos seguintes recursos e inclua o campo filter:

Para instâncias de VM, use o método instances.list() .
Para instantâneos, use o método snapshots.list() .
Para imagens, use o método images.list() .
Para discos, use o método disks.list() .
Para regras de encaminhamento, use o método forwardingRules.list() .
Para endereços IP externos estáticos regionais, use o método beta addresses.list() .
Para endereços IP externos estáticos globais, use o método beta globalAddresses.list() .
Para túneis VPN, use o método beta vpnTunnels.list() .

GET https://compute.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances?filter=labels.env%3Adev

Para mais informações, leia a documentação filter na referência da API Compute Engine.

Relacionamento entre rótulos de VM e tags de rede

No passado, rótulos e tags estavam relacionados. Por exemplo, se você adicionou um rótulo webserver:test a uma VM, o Compute Engine adicionou automaticamente uma tag webserver à VM.

Para saber como criar tags, consulte Tags de rede .

O que vem a seguir

Saiba como adicionar tags de rede .
Aprenda sobre filtragem .

Organize recursos usando rótulos,Organize recursos usando rótulos Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Console

gcloud

REST

O que são rótulos?

Requisitos para rótulos

Usos comuns de rótulos

Rótulos e tags

Usar rótulos no Compute Engine

Crie recursos com rótulos

Console

gcloud

API

Adicionar ou atualizar rótulos em recursos existentes

Console

gcloud

API

Ver rótulos

Console

gcloud

API

Obtenha uma impressão digital de rótulo para solicitações de API

Remover um rótulo

Console

gcloud

API

Filtrar pesquisas usando rótulos

Console

gcloud

API

Relacionamento entre rótulos de VM e tags de rede

O que vem a seguir

Antes de começar

Console

gcloud

REST

O que são rótulos?

Requisitos para rótulos

Usos comuns de rótulos

Rótulos e tags

Usar rótulos no Compute Engine

Crie recursos com rótulos

Console

gcloud

API

Adicionar ou atualizar rótulos em recursos existentes

Console

gcloud

API

Ver rótulos

Console

gcloud

API

Obtenha uma impressão digital de rótulo para solicitações de API

Remover um rótulo

Console

gcloud

API

Filtrar pesquisas usando rótulos

Console

gcloud

API

Relacionamento entre rótulos de VM e tags de rede

O que vem a seguir

Organize recursos usando rótulos,Organize recursos usando rótulos
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.