Documentação do Oracle Cloud Infrastructure

Adicionando Tags na Criação de Recurso

No Compute Cloud@Customer, todos os padrões de tag definidos em um compartimento são adicionados automaticamente a todos os recursos criados nesse compartimento ou em qualquer compartimento filho desse compartimento, após a definição do padrão de tag. Um padrão de tag pode exigir que você informe um valor para a tag para criar o recurso.

Observação

As tags definidas e os namespaces de tag devem ser configurados na tenancy do OCI. Consulte Tags definidas.

    1. Na caixa de diálogo Criar do recurso, role até a seção Marcação com Tags.

    2. Selecione o Namespace de Tag ou selecione Nenhum (para aplicar uma tag de formato livre).

      • Se você selecionou um Namespace de Tag, selecione a Chave de Tag e digite um valor ou selecione um valor na lista.

      • Se você selecionou Nenhum (aplicar uma tag de formato livre), informe uma Chave de Tag e informe um valor.

    3. Para aplicar outra tag, selecione o botão Tag Adicional.

      Você não pode especificar mais de uma tag com o mesmo namespace de tag e a mesma chave de tag para uma tag definida ou mais de uma tag com a mesma chave de tag para uma tag de formato livre.

    4. Para revisar as tags no recurso, vá para a página de detalhes do novo recurso.

      Na página de detalhes do recurso, selecione a guia Tags para exibir as tags aplicadas a esse recurso.

  • Para adicionar uma tag a um recurso ao criá-lo, use o comando create ou launch do recurso.

    1. Obtenha as informações de cada tag que você deseja adicionar ao recurso.

      • Obtenha o namespace, a chave e o valor de cada tag definida que você deseja adicionar ao recurso.

        Crie um argumento para a opção --defined-tags. Especifique cada namespace de tag e par de chaves de tag apenas uma vez.

      • Obtenha a chave e o valor de cada tag de formato livre que você deseja adicionar ao recurso.

        Crie um argumento para a opção --freeform-tags. Especifique cada chave de tag apenas uma vez.

      O valor do argumento da opção --defined-tags e do argumento da opção --freeform-tags é uma definição JSON das tags. Essa definição JSON pode ser fornecida como uma string na linha de comando ou em um arquivo.

      Você pode gerar um modelo do JSON correto a ser fornecido usando a opção --generate-param-json-input com o comando base que você usará para marcar o recurso com tag. O argumento para a opção --generate-param-json-input é o nome da opção que você usa para especificar as tags (--defined-tags neste exemplo) sem o indicador de opção (--), conforme mostrado no exemplo a seguir:

      $ oci service resource create --generate-param-json-input defined-tags > defined_tags.json

      O conteúdo do arquivo defined_tags.json de saída é:

      {
  "tagNamespace1": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  },
  "tagNamespace2": {
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2"
  }
}

      Se você especificar freeform-tags em vez de defined-tags no comando anterior, obterá a seguinte saída:

      {
  "tagKey1": "tagValue1",
  "tagKey2": "tagValue2"
}

      Edite esses modelos para fornecer as tags apropriadas. Especifique o resultado no comando final, conforme mostrado na etapa a seguir.

    2. Execute o comando do recurso create ou launch.

      Para adicionar uma ou mais tags definidas, use a opção --defined-tags. Para adicionar uma ou mais tags de formato livre, use a opção --freeform-tags.

      sintaxe:

      oci <service> <resource> create --compartment-id <compartment_OCID> --defined-tags <defined_tags_json> --freeform-tags <freeform_tags_json> <other_resource_create_options>

      Por exemplo:

      No exemplo a seguir, uma ou mais tags definidas são adicionadas usando um arquivo e uma tag de formato livre é adicionada usando um argumento de string. Use a sintaxe file:// para especificar um arquivo como o argumento de opção.

      oci <service> <resource> create --compartment-id <compartment_OCID> --defined-tags file://defined_tags.json --freeform-tags '{"MyTag":"val-u"}' <other_resource_create_options>

      A saída do comando do recurso create ou launch é a mesma que a saída do comando do recurso get. A saída mostra as tags definidas e de formato livre.

    Para obter uma lista completa de comandos, flags e opções da CLI, consulte a Referência de Linha de Comando.

  • Para adicionar uma tag a um recurso ao criá-lo, use o comando create<resource> ou launch<resource>.

    Para obter informações sobre como usar a API e assinar solicitações, consulte APIs REST e Credenciais de Segurança. Para obter informações sobre SDKs, consulte Kits de Desenvolvimento de Software e Interface de Linha de Comando.