Documentação do Oracle Cloud Infrastructure

Tags de Recursos

Quando você tem muitos recursos (por exemplo, instâncias, VCNs, balanceadores de carga e volumes em blocos) em vários compartimentos na sua tenancy, pode ser difícil rastrear recursos usados para fins específicos ou agregá-los, reportá-los ou executar ações em massa neles. Tag permite que você defina chaves e valores e os associe aos recursos. Você poderá, então, usar as tags para ajudá-lo a organizar e listar recursos com base nas necessidades do seu negócio.

Existem dois tipos de tags:

AsTags definidas são configuradas na sua tenancy por um administrador. Somente usuários com permissão para trabalhar com as tags definidas podem aplicá-las aos recursos.

Tags de formato livre podem ser aplicadas por qualquer usuário com permissões do recurso.

Para obter informações mais detalhadas sobre tags e suas funcionalidades, consulte Visão Geral do Serviço Tagging.

Dica

Assista a um vídeo que apresentará a você os conceitos e recursos de tags: Introdução às Tags.
Cuidado

Evite inserir informações confidenciais ao designar descrições, tags ou nomes amigáveis aos recursos na nuvem por meio da Console, API ou CLI do Oracle Cloud Infrastructure.

Como Trabalhar com Tags de Recursos

Para adicionar tags definidas em massa

Como adicionar várias tags definidas a recursos existentes. Para aplicar tags definidas, você deve ter permissão para usar o namespace.

  1. Abra o menu de navegação e clique em Governança e Administração. Em Administração, clique em Tenancy Explorer.

  2. Selecione os recursos aos quais você deseja adicionar tags. Opcionalmente, use o menu drop-down Filtrar por tipo de recurso para restringir a lista de recursos.

  3. No menu Ações, clique em Gerenciar Tags.

    A página Gerenciar Tags será aberta. A primeira tabela exibe as tags atualmente aplicadas aos recursos selecionados. A segunda tabela exibe os recursos selecionados.

  4. Na lista de tags existentes, clique em + Adicionar Nova.
    1. Selecione o Namespace de Tag.
    2. Selecione a Chave de Tag.
    3. Para Valor, informe um valor.
  5. Para aplicar outra tag, repita a etapa anterior. Para remover uma linha, clique no botão Remover (x).

  6. Quando tiver adicionado todas as tags desejadas, clique em Próximo.

    Uma página de confirmação é aberta, que lista as ações a serem executadas e os recursos aos quais as ações se aplicam.

  7. Clique em Enviar.

A página Solicitação de Serviço é iniciada para mostrar o status da solicitação de serviço para adicionar tags aos recursos.

Para adicionar tags definidas a um recurso existente

Para aplicar uma tag definida, você deve ter permissão para usar o namespace.

  1. Abra a Console e vá para a página de detalhes do recurso que você deseja marcar com tag.

    Por exemplo, para identificar uma instância de computação: Abra o menu de navegação e clique no serviço Compute. No serviço Compute, clique em Instâncias. Uma lista das instâncias em seu compartimento atual será exibida. Localize a instância que você deseja marcar e clique no nome dela para exibir sua página de detalhes.

  2. Clique em Aplicar Tags. Dependendo do recurso, essa opção pode aparecer no menu Mais Ações.

  3. Na caixa de diálogo Aplicar Tags ao Recurso:

    1. Selecione o Namespace de Tag.
    2. Selecione a Chave de Tag.
    3. Em Valor, informe um valor ou selecione um na lista.
    4. Para aplicar outra tag, clique em + Tag Adicional.
    5. Quando terminar de adicionar as tags, clique em Aplicar Tag(s).
Para adicionar uma tag de formato livre a um recurso existente

  1. Abra a Console e vá para a página de detalhes do recurso que você deseja marcar com tag.

    Por exemplo, para identificar uma instância de computação: Abra o menu de navegação e clique no serviço Compute. No serviço Compute, clique em Instâncias. Uma lista das instâncias em seu compartimento atual será exibida. Localize a instância que você deseja marcar e clique no nome dela para exibir sua página de detalhes.

  2. Clique em Aplicar Tags. Dependendo do recurso, essa opção pode aparecer no menu Mais Ações.

  3. Na caixa de diálogo Aplicar Tags ao Recurso:

    1. Selecione Nenhum (aplicar uma tag de formato livre).
    2. Informe a Chave e Tag.
    3. Informe um Valor.
    4. Para aplicar outra tag, clique em + Tag Adicional.
    5. Quando terminar de adicionar as tags, clique em Aplicar Tag(s).
Para adicionar uma tag durante a criação do recurso

Você pode aplicar tags durante a criação do recurso. A localização da opção Aplicar Tag(s) na caixa de diálogo varia por de acordo com o recurso. As etapas gerais são:

  1. Na caixa de diálogo de criação do recurso, clique em Aplicar Tags.

    Em alguns recursos, clique em Mostrar Opções Avançadas para aplicar uma tag.

  2. Na caixa de diálogo Aplicar Tags ao Recurso:

    1. Selecione o Namespace de Tag ou selecione Nenhum para aplicar uma tag de formato livre.
    2. Selecione ou informe a Chave de Tag.
    3. Em Valor, informe um valor ou selecione um na lista.
    4. Para aplicar outra tag, clique em + Tag Adicional.
    5. Clique em Aplicar Tag(s).
Para filtrar uma lista de recursos por uma tag

Abra a Console, clique no nome do serviço e, em seguida, clique no recurso que você deseja exibir. O lado esquerdo da página mostra todos os filtros aplicados no momento à lista.

Por exemplo, para exibir instâncias de computação: Clique em Compute e depois clique em Instâncias, para ver a lista de instâncias no seu compartimento atual.

Para filtrar uma lista de recursos por uma tag definida
  1. Ao lado de Filtros de tag, clique em Adicionar.
  2. Na caixa de diálogo Adicionar um filtro de tag, informe o seguinte:
    1. Tag namespace: Selecione o namespace da tag.
    2. Chave de tag: selecione a chave.
    3. Valor da tag: Selecione uma das seguintes opções:
      • Corresponder qualquer valor - retorna todos os recursos marcados com o namespace e a chave selecionados, independentemente do valor da tag.
      • Especificar valores correspondentes - retorna recursos com o valor de tag informado na caixa de texto. Informe um único valor na caixa de texto. Para especificar vários valores para o mesmo namespace e chave, clique em + para exibir outra caixa de texto. Informe um valor por caixa de texto.
    4. Clique em Aplicar filtro.
Para filtrar uma lista de recursos por uma tag de formato livre
  1. Ao lado de Filtros de tag, clique em Adicionar.
  2. Na caixa de diálogo Adicionar um filtro de tag, informe o seguinte:
    1. Namespace de tag: Selecione Nenhum (tag de formato livre).
    2. Tag key: Informe a chave.
    3. Valor da tag: Selecione uma das seguintes opções:
      • Corresponder qualquer valor - retorna todos os recursos marcados com o namespace e a chave selecionados, independentemente do valor da tag.
      • Especificar valores correspondentes - retorna recursos com o valor de tag informado na caixa de texto. Informe um único valor na caixa de texto. Para especificar vários valores para o mesmo namespace e chave, clique em + para exibir outra caixa de texto. Informe um valor por caixa de texto.
    4. Clique em Aplicar filtro.
Para atualizar em massa tags definidas

Como atualizar tags definidas aplicadas a um ou mais recursos.

  1. Abra o menu de navegação e clique em Governança e Administração. Em Administração, clique em Tenancy Explorer.

  2. Selecione os recursos cujas tags você deseja atualizar. Opcionalmente, use o menu drop-down Filtrar por tipo de recurso para restringir a lista de recursos.

  3. No menu Ações, clique em Gerenciar Tags.

    A página Gerenciar Tags será aberta. A primeira tabela exibe as tags atualmente aplicadas aos recursos selecionados. A segunda tabela exibe os recursos selecionados.

  4. Na lista de tags, localize a tag que você deseja atualizar e informe um novo valor. Para reverter a alteração, clique no botão Desfazer.
  5. Para Ação, selecione Aplicar tag a todos os recursos selecionados.

  6. Se desejado, atualize mais valores de tag. Em seguida, clique em Próximo.

    Uma página de confirmação é aberta, que lista as ações a serem executadas e os recursos aos quais as ações se aplicam.

  7. Clique em Enviar.

A página Solicitação de Serviço é iniciada para mostrar o status da solicitação de serviço para atualizar as tags nos recursos.

Para atualizar uma tag aplicada a um recurso

  1. Abra a Console, clique no nome do serviço e, em seguida, clique no recurso que você deseja exibir.

    Por exemplo, para exibir instâncias de computação: abra o menu de navegação e clique no serviço Compute. No serviço Compute, clique em Instâncias. Uma lista das instâncias em seu compartimento atual será exibida. Localize a instância que você deseja atualizar e clique no nome dela para exibir sua página de detalhes.

  2. Clique em Tags.

    A lista de tags aplicadas ao recurso será exibida.

  3. Localize a tag que você deseja atualizar e clique no ícone de lápis ao lado dela.
  4. Informe ou selecione um novo valor.
  5. Clique em Salvar.
Para remover tags definidas em massa

Como remover várias tags definidas de recursos.

  1. Abra o menu de navegação e clique em Governança e Administração. Em Administração, clique em Tenancy Explorer.

  2. Selecione os recursos dos quais você deseja remover tags. Opcionalmente, use o menu drop-down Filtrar por tipo de recurso para restringir a lista de recursos.

  3. No menu Ações, clique em Gerenciar Tags.

    A página Gerenciar Tags será aberta. A primeira tabela exibe as tags atualmente aplicadas aos recursos selecionados. A segunda tabela exibe os recursos selecionados.

  4. Na lista de tags, localize a tag que deseja remover. Para Ação, selecione Remover tag de todos os recursos selecionados.
  5. Para remover outra tag, repita a etapa anterior.

  6. Clique em Próximo.

    Uma página de confirmação é aberta, que lista as ações a serem executadas e os recursos aos quais as ações se aplicam.

  7. Clique em Enviar.

A página Solicitação de Serviço é iniciada para mostrar o status da solicitação de serviço para remover tags dos recursos.

Para remover uma tag de um só recurso

  1. Abra a Console, clique no nome do serviço e, em seguida, clique no recurso que você deseja exibir.

    Por exemplo, para exibir uma instância de computação: abra o menu de navegação e clique no serviço Compute. No serviço Compute, clique em Instâncias. Uma lista das instâncias em seu compartimento atual será exibida. Localize a instância da qual você deseja remover a tag e clique em seu nome para exibir a página de detalhes.

  2. Clique em Tags.

    A lista de tags aplicadas ao recurso será exibida.

  3. Localize a tag que você deseja remover e clique no ícone de lápis ao lado dela.
  4. Clique em Remover Tag.

Usando a API

Para obter informações sobre como usar a API e assinar solicitações, consulte a documentação da API REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte SDKs e a CLI.

  • Para aplicar uma tag a um recurso individual usando a API, use a operação create ou update do recurso apropriado.
  • BulkEditTags - adiciona, atualiza e remove várias definições de chave de tag nos recursos selecionados
  • ListBulkEditTagsResourceTypes - lista os tipos de recursos que suportam a edição de tags em massa