» Tagging OCI Resources

When you have many resources (for example, instances, VCNs, load balancers, and block volumes) across multiple compartments in your tenancy, it can become difficult to track resources used for specific purposes, or to aggregate them, report on them, or take bulk actions on them. Tagging allows you to define keys and values and associate them with resources. You can then use the tags to help you organize and list resources based on your business needs. See Tagging Overview to familiarize yourself with concept of tagging and features available.

» Managing Tags and Tag Namespaces

  • See tag_namespaces for guidance on managing lifecycle of tag namespaces.
  • See tags for guidance on managing lifecycle of tags.

» How To Manage Tags on OCI Resources

  • Freeform tags: Freeform tags are simple key value map
  • Defined tags: Defined tags provide a key/value map and are organized by combining the tag namespaces with tag keys using dot notation. For example, a tag namespace called HumanResources could have a key named CostCenter. You then associate the namespace and key HumanResource.CostCenter and then assign the desired tag, as shown in the following example.

» Examples:

» Example 1:

//Hand curated way
resource "oci_core_instance" "t" {

    freeform_tags =  {
           Environment = "Prod"
           Department = "Ops"
    defined_tags = {
        HumanResources.CostCenter = "42"
        Operations.Project = "Beta"
        HumanResources.Environment = "Production"

» Example 2:

//Using Locals(available in terraform 0.10.3 or later) & interpolation

locals {
  //Put all common tags here
  common_tags = "${map(
                        "HumanResources.Environment", "Production",
                        "Operations.Project", "Beta"

resource "oci_core_instance" t {

    freeform_tags = "${map("key${count.index}", "value${count.index}",
        "domain", "${lookup(data.oci_identity_availability_domains.ADs.availability_domains[var.AD - 1],"name")}"

    defined_tags = "${merge(
                            "${oci_identity_tag_namespace.tag_namespace1.name}.${oci_identity_tag.tag2.name}", "awesome-tag-example"