Visão Geral do Serviço Tagging

O serviço Tagging oferece duas formas de adicionar tags aos recursos.

Cada abordagem oferece um tipo distinto de tag para você trabalhar:

• Tags definidas - os administradores de tags gerenciam metadados de recursos.
• Tags de formato livre - metadados não gerenciados aplicados a recursos por usuários.

Uma abordagem envolve um administrador de tags que cria e gerencia todas as tags que os usuários aplicam aos recursos. Use a política do Serviço IAM para selecionar administradores de tags, que podem criar tags. Conceda a todos os outros na tenancy apenas a capacidade de aplicar tags. O benefício dessa abordagem é que você pode criar e gerenciar as chaves e os valores usados para marcar recursos. Você pode evitar erros de digitação que enfraquecem a automação com base em tags e fornecer melhores relatórios com base em tags.

A outra abordagem é permitir que os usuários adicionem tags aos recursos. Cada tag é editada ou aplicada ao recurso por você ou por um usuário que cria ou modifica um recurso. Você pode usar ambos os tipos de tags em toda a sua tenancy.

A maioria dos recursos do Serviço Tagging requer tags definidas. O termo "Tag" é usado genericamente para fazer referência a tags definidas. Para criar metadados confiáveis para gerenciar recursos e coletar dados, use tags definidas. Com tags definidas, os seguintes cenários se tornam possíveis: 

• Crie tags padrão que são aplicadas a todos os recursos nos compartimentos. Consulte Gerenciando Padrões de Tag.
• Especificar que os usuários devem aplicar tags a recursos para criar recursos com sucesso em compartimentos.
• Se você cometer um erro de digitação usando tags definidas, corrija-o editando ou até mesmo excluindo a tag. Quando você exclui uma tag definida, o sistema Oracle remove a chave e qualquer valor dessa tag de todos os recursos. Consulte Excluindo Definições de Chave de Tag e Namespaces de Tag.
• Associar uma lista de valores predefinidos a uma tag definida. Consulte Usando Valores Predefinidos.
• Usar variáveis do sistema para gerar valores para tags definidas ou padrões de tags automaticamente. Consulte Usando Variáveis de Tag.
• Rastrear custos com base em tags. O uso de tags definidas é recomendado para este caso de uso.
• Definir orçamentos usando tags de rastreamento de custos para ser alertado quando seus gastos atingirem os níveis especificados. Consulte Usando Tags de Rastreamento de Custos.

Descreve os conceitos básicos de tags.

Veja aqui uma lista dos conceitos básicos de tags:

NAMESPACE DE TAG

Você pode pensar em um namespace de tag como um contêiner para suas chaves de tag. Ele consiste em um nome e em zero ou mais definições de chave de tag. Os namespaces de tag não fazem distinção entre maiúsculas e minúsculas e devem ser exclusivos na tenancy. O namespace também é um grupamento natural ao qual os administradores podem aplicar uma política. Uma política no namespace de tag se aplica a todas as definições de tag contidas nesse namespace.

Observação

• Você não pode usar o OCID para nomear o namespace de tag, pois os OCIDs não seguem o formato necessário para nomear namespaces de tag.
• Você não pode alterar o nome do seu namespace de tag. No entanto, você pode retirá-lo.

CHAVE DE TAG

O nome que você usa para se referir à tag. As chaves de tag não fazem distinção entre maiúsculas e minúsculas. Por exemplo, mytagkey é o mesmo que MyTagKey. Você deve criar chaves de tag para tags definidas em um namespace. Cada chave de tag deve ser exclusiva dentro de um namespace.

TIPO DE VALOR DE TAG

O tipo de valor da tag especifica o tipo de dados permitido para o valor. No momento, dois tipos de dados são suportados: string e uma lista de strings.

DEFINIÇÃO DE CHAVE

Uma definição de chave define o esquema de uma tag e inclui um namespace, a chave da tag e o tipo de valor da tag.

Observação

Você não pode alterar o nome da sua definição de chave de tag. No entanto, você pode baixá-lo

VALOR DE TAG

O valor da tag é o valor que o usuário que aplica a tag adiciona à chave da tag. Os valores de tag suportam dois tipos de dados: strings e listas de strings. Você pode definir uma lista de valores para o usuário selecionar quando definir a chave da tag ou permitir que o usuário informe qualquer valor quando a tag for aplicada ao recurso. Se você selecionar um valor de tag de string ao criar a chave, o usuário poderá deixar o valor em branco quando aplicar a chave.

No exemplo:

Operations.CostCenter="42"

Operations corresponde ao namespace, CostCenter corresponde à chave da tag e 42 é o valor da tag.

TAG (OU TAG DEFINIDA)

Uma tag é a instância de uma definição de chave que é aplicada a um recurso. Ela consiste em um namespace, uma chave e um valor. O termo "Tag" é usado genericamente para fazer referência a tags definidas.

TAG DE FORMATO LIVRE

Uma associação de metadados básica que consiste somente em uma chave e um valor. Tags de formato livre possuem funcionalidade limitada. Consulte Noções Básicas sobre Tags de Formato Livre.

RASTREAMENTO DE CUSTOS

O rastreamento de custos é um recurso disponível com tags definidas. Esse recurso está passando por remoção gradual e atualmente só é relevante para uso com Orçamentos. Para entender quando você precisa designar uma tag como uma Tag de rastreamento de custos, consulte Usando Tags de Rastreamento de Custos.

PADRÃO DE TAG

Os padrões de tag permitem que você especifique tags que são aplicadas automaticamente a todos os recursos, em um compartimento específico, no momento da criação, independentemente das permissões do usuário que cria o recurso. Consulte Gerenciando Padrões de Tag.

RETIRAR

Você pode retirar uma definição de chave de tag ou um namespace de tag. Definições de chave e de namespaces de tag retiradas não podem mais ser aplicadas aos recursos. No entanto, as tags retiradas não são removidas dos recursos aos quais já foram aplicadas. Ainda é possível especificar tags retiradas ao pesquisar, filtrar, reportar etc.

REATIVAR

Você pode reativar um namespace de tag ou uma definição de chave de tag que foi retirada para reintegrar seu uso em sua tenancy.

VARIÁVEL DA TAG

Você pode usar uma variável para definir o valor de uma tag. Quando você adiciona ou atualiza uma tag em um recurso, a variável é resolvida para os dados que ela representa. Consulte Usando Variáveis de Tag.

VALORES PREDEFINIDOS

Você pode usar uma variável para definir o valor de uma tag. Quando você adiciona ou atualiza uma tag em um recurso, a variável é resolvida para os dados que ela representa. Consulte Usando Valores Predefinidos.

EXEMPLO DE TAG

{
  "compartmentId": "ocid.compartment.oc1..exampleuniquecompartmentID",
  "namespace": "ansh8lvru1zp",
  "objectEventsEnabled": true,
  "name": "my-test-1",
  "freeformTags": {"Department": "Finance"},
  "definedTags":
  {
    "MyTags":
    {
      "CostCenter": "42",
      "Project": "Stealth",
      "CreatedBy": "BillSmith",
      "CreatedDate": "9/21/2017T14:00"
    },
    "Audit":
    {
      "DataSensitivity": "PII",
      "CageSecurity": "High",
      "Simplicity": "complex"
    }
  }
}

Para administradores: Use os tópicos a seguir para localizar um exemplo de política do serviço IAM para o serviço Tagging: 

• Permissões Obrigatórias para Trabalhar com Tags Definidas
• Permissões Obrigatórias para Trabalhar com Padrões de Tag
• Permissões Obrigatórias para Trabalhar com Tags de Formato Livre

No momento, o serviço Tagging está disponível em todas as regiões.

Saiba mais sobre limites por recurso em tags e quais caracteres são suportados em strings de tag.

• Tags por tenancy: ilimitado
• Tags por recurso: 10 tags de formato livre e 64 tags definidas
• Tags ativadas para rastreamento de custos: 10 por tenancy (inclui tags ativas e retiradas)
• Tamanho total dos dados da tag: 5 K (JSON). O tamanho total dos dados da tag inclui todos os dados da tag para um único recurso (todas as tags aplicadas e valores de tags). O dimensionamento é por UTF-8.
• Número de valores predefinidos para uma chave de tag: 100 por lista

Fornece a lista de recursos suportados por tags.

A tabela a seguir lista os recursos que suportam tags. Esta tabela será atualizada à medida que o suporte à tags for adicionado para mais recursos.