Etiquete recursos do Cloud Workstations

Esta página descreve como usar etiquetas com recursos do Cloud Workstations.

O que são etiquetas?

Uma etiqueta é um par de chave-valor que pode atribuir a Google Cloud instâncias. Ajudam a organizar estes recursos e a gerir os custos em grande escala, com a granularidade de que precisa. Pode anexar uma etiqueta a cada recurso e, em seguida, filtrar os recursos com base nas respetivas etiquetas. As informações sobre as etiquetas são encaminhadas para o sistema de faturação que lhe permite discriminar os custos faturados por etiqueta. Com os relatórios de faturação integrados, pode filtrar e agrupar os custos por etiquetas de recursos. Também pode usar etiquetas para consultar exportações de dados de faturação.

Requisitos para etiquetas

As etiquetas aplicadas a um recurso têm de cumprir os seguintes requisitos:

• Cada recurso pode ter até 64 etiquetas.
• Cada etiqueta tem de ser um par chave-valor.
• As chaves têm um comprimento mínimo de 1 caráter e um comprimento máximo de 63 carateres, e não podem estar vazias. Os valores podem estar vazios e ter um comprimento máximo de 63 carateres.
• As chaves e os valores só podem conter letras minúsculas, carateres numéricos, sublinhados e travessões. Todos os carateres têm de usar a codificação UTF-8, e são permitidos carateres internacionais. As chaves têm de começar com uma letra minúscula ou um caráter internacional.
• A parte da chave de uma etiqueta tem de ser exclusiva num único recurso. No entanto, pode usar a mesma chave com vários recursos.

Estes limites aplicam-se à chave e ao valor de cada etiqueta, bem como aos recursos Google Cloud individuais que têm etiquetas. Não existe um limite para o número de etiquetas que pode aplicar a todos os recursos num projeto.

Utilizações comuns das etiquetas

Seguem-se alguns exemplos de utilização comuns das etiquetas:

• Etiquetas de equipa ou centro de custos: adicione etiquetas com base na equipa ou no centro de custos para distinguir instâncias pertencentes a diferentes equipas (por exemplo, team:research e team:analytics). Pode usar este tipo de etiqueta para contabilidade de custos ou orçamentação.

• Etiquetas de componentes: por exemplo, component:redis, component:frontend, component:ingest e component:dashboard.

• Etiquetas de ambiente ou fase: por exemplo, environment:production e environment:test.

• Etiquetas de estado: por exemplo, state:active,state:readytodelete e state:archive.

• Etiquetas de propriedade: usadas para identificar as equipas responsáveis pelas operações, por exemplo: team:shopping-cart.

+ Etiquetas de máquinas virtuais: pode anexar uma etiqueta a uma máquina virtual. As etiquetas de máquinas virtuais que definiu no passado aparecem como uma etiqueta sem valor.

Nota: não inclua informações sensíveis em etiquetas, incluindo informações de identificação pessoal, como o nome ou o título de um indivíduo. As etiquetas não foram concebidas para processar informações confidenciais.

Não recomendamos a criação de um grande número de etiquetas únicas, como para carimbos de data/hora ou valores individuais para cada chamada da API. O problema desta abordagem é que, quando os valores mudam frequentemente ou com chaves que desorganizam o catálogo, torna-se difícil filtrar e gerar relatórios sobre os recursos de forma eficaz.

Etiquetas e marcadores

As etiquetas podem ser usadas como anotações consultáveis para recursos, mas não podem ser usadas para definir condições nas políticas. As etiquetas oferecem uma forma de permitir ou negar condicionalmente políticas com base no facto de um recurso ter uma etiqueta específica, oferecendo um controlo detalhado sobre as políticas. Para mais informações, consulte a Vista geral das etiquetas.

Para mais informações sobre Google Cloud etiquetas, consulte o artigo Organize os recursos com etiquetas.

Para mais informações sobre a etiquetagem de recursos do Cloud Workstations, consulte o artigo Etiquete recursos do Cloud Workstations.

Etiquetas de recursos do Cloud Workstations

As estações de trabalho na nuvem aplicam automaticamente as seguintes etiquetas a todos os recursos:

• workstation_cluster_id
• workstation_config_id
• workstation_id
• workstation_location
• goog-drz-workstation-location
• goog-drz-workstation-uuid
• goog-workstations

Etiquetas personalizadas do Cloud Workstations

Também pode adicionar as suas etiquetas personalizadas a clusters de estações de trabalho, configurações de estações de trabalho e estações de trabalho, o que as aplica recursivamente a todos os recursos subjacentes do Compute Engine, embora não aos recursos subjacentes da API Cloud Workstations. Para etiquetar recursos do Compute Engine para estações de trabalho individuais, certifique-se de que adiciona etiquetas para cada estação de trabalho individual.

Use o campo labels quando chamar a API Cloud Workstations.

Por exemplo, no ficheiro config.json de amostra que se segue, webserver é uma chave e backend é o valor correspondente. Da mesma forma, media é uma chave e images é o valor correspondente.

    {
      "idleTimeout": "7200s",
      "host": {
        "gce_instance": {
          "machine_type": "e2-standard-8",
          "pool_size": 1
        }
      },
      "persistentDirectories": [
        {
        "mountPath": "/home",
        "gcePd": {
          "sizeGb": 200,
          "fsType": "ext4"
        }
      }
      ],
      "labels": {
        "webserver": "backend",
        "media": "images"
      }
    }