Jump to

• Request
• Response

Assemble Effective Tag Set

get

/20160918/tagDefaults/actions/assembleEffectiveTagSet

Assemble tag defaults in the specified compartment and any parent compartments to determine the tags to apply. Tag defaults from parent compartments do not override tag defaults referencing the same tag in a compartment lower down the hierarchy. This set of tag defaults includes all tag defaults from the current compartment back to the root compartment.

Request

Supported Media Types

• application/json

Query Parameters

• compartmentId(required): string
  Minimum Length: 1

  Maximum Length: 255

  The OCID of the compartment.
• lifecycleState: string
  A filter to only return resources that match the given lifecycle state. The state value is case-insensitive.

Back to Top

Response

Supported Media Types

• application/json

200 Response

The list of tag defaults.

Headers

• opc-next-page: string
  For pagination of a list of tag default values. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items.
• opc-request-id: string
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : schema

Type: array

Show Source

• Array of: object TagDefaultSummary
  Summary information for the specified tag default.

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/TagDefaultSummary"
    }
}

Nested Schema : TagDefaultSummary

Type: object

Summary information for the specified tag default.

Show Source

• compartmentId(required): string
  The OCID of the compartment. The tag default will apply to all new resources that are created in the compartment.
• id(required): string
  The OCID of the tag default.
• isRequired(required): boolean
  If you specify that a value is required, a value is set during resource creation (either by the user creating the resource or another tag defualt). If no value is set, resource creation is blocked. If the isRequired flag is set to true, the value is set during resource creation. If the isRequired flag is set to false, the value you enter is set during resource creation.
• lifecycleState: string
  Allowed Values: [ "ACTIVE" ]

  The tag default's current state. After creating a TagDefault, make sure its lifecycleState is ACTIVE before using it.
• locks: array locks
  Locks associated with this resource.
• tagDefinitionId(required): string
  The OCID of the tag definition. The tag default will always assign a default value for this tag definition.
• tagDefinitionName(required): string
  The name used in the tag definition. This field is informational in the context of the tag default.
• tagNamespaceId(required): string
  The OCID of the tag namespace that contains the tag definition.
• timeCreated(required): string(date-time)
  Date and time the TagDefault object was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
• value(required): string
  The default value for the tag definition. This will be applied to all new resources created in the compartment.

{
    "description":"Summary information for the specified tag default.",
    "required":[
        "id",
        "compartmentId",
        "tagNamespaceId",
        "tagDefinitionId",
        "tagDefinitionName",
        "value",
        "timeCreated",
        "isRequired"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"The OCID of the tag default."
        },
        "compartmentId":{
            "type":"string",
            "description":"The OCID of the compartment. The tag default will apply to all new resources that are created in the compartment."
        },
        "tagNamespaceId":{
            "type":"string",
            "description":"The OCID of the tag namespace that contains the tag definition."
        },
        "tagDefinitionId":{
            "type":"string",
            "description":"The OCID of the tag definition. The tag default will always assign a default value for this tag definition."
        },
        "tagDefinitionName":{
            "type":"string",
            "description":"The name used in the tag definition. This field is informational in the context of the tag default."
        },
        "value":{
            "type":"string",
            "description":"The default value for the tag definition. This will be applied to all new resources created in the compartment."
        },
        "timeCreated":{
            "type":"string",
            "format":"date-time",
            "description":"Date and time the TagDefault object was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z "
        },
        "lifecycleState":{
            "type":"string",
            "enum":[
                "ACTIVE"
            ],
            "description":"The tag default's current state. After creating a TagDefault, make sure its lifecycleState is ACTIVE before using it."
        },
        "isRequired":{
            "type":"boolean",
            "description":"If you specify that a value is required, a value is set during resource creation (either by the user creating the resource or another tag defualt). If no value is set, resource creation is blocked. If the isRequired flag is set to true, the value is set during resource creation. If the isRequired flag is set to false, the value you enter is set during resource creation."
        },
        "locks":{
            "description":"Locks associated with this resource.",
            "type":"array",
            "items":{
                "$ref":"#/definitions/ResourceLock"
            }
        }
    },
    "x-example":"{   \"id\" : \"ocid1.tagdefault.oc1..<var>&lt;unique_ID&gt;</var>\",   \"compartmentId\" : \"ocid1.compartment.oc1..<var>&lt;unique_ID&gt;</var>\",   \"tagNamespaceId\" : \"ocid1.namespace.oc1..<var>&lt;unique_ID&gt;</var>\",   \"tagDefinitionId\" : \"ocid1.tagdefinition.oc1..<var>&lt;unique_ID&gt;</var>\",   \"tagDefinitionName\" : \"Finance\",   \"value\" : \"W123\",   \"timeCreated\" : \"2018-11-22T19:00:00.000Z\",   \"lifecycleState\" : \"ACTIVE\",   \"isRequired\" : \"false\" } ",
    "type":"object"
}

Nested Schema : locks

Type: array

Locks associated with this resource.

Show Source

• Array of: object ResourceLock
  Resource locks are used to prevent certain APIs from being called for the resource. A full lock prevents both updating the resource and deleting the resource. A delete lock prevents deleting the resource.

{
    "description":"Locks associated with this resource.",
    "type":"array",
    "items":{
        "$ref":"#/definitions/ResourceLock"
    }
}

Nested Schema : ResourceLock

Type: object

Resource locks are used to prevent certain APIs from being called for the resource. A full lock prevents both updating the resource and deleting the resource. A delete lock prevents deleting the resource.

Show Source

• message: string
  A message added by the creator of the lock. This is typically used to give an indication of why the resource is locked.
• relatedResourceId: string
  The OCID of the resource that is locking this resource. Indicates that deleting this resource will remove the lock.
• timeCreated: string(date-time)
  Indicates when the lock was created, in the format defined by RFC 3339.
• type(required): string
  Allowed Values: [ "FULL", "DELETE" ]

  Lock type.

{
    "description":"Resource locks are used to prevent certain APIs from being called for the resource. A full lock prevents both updating the resource and deleting the resource. A delete lock prevents deleting the resource.",
    "type":"object",
    "required":[
        "type"
    ],
    "properties":{
        "type":{
            "description":"Lock type.",
            "enum":[
                "FULL",
                "DELETE"
            ],
            "type":"string"
        },
        "relatedResourceId":{
            "description":"The OCID of the resource that is locking this resource. Indicates that deleting this resource will remove the lock.",
            "type":"string"
        },
        "message":{
            "description":"A message added by the creator of the lock. This is typically used to give an indication of why the resource is locked.",
            "type":"string"
        },
        "timeCreated":{
            "format":"date-time",
            "type":"string",
            "description":"Indicates when the lock was created, in the format defined by RFC 3339."
        }
    }
}

Example Response (application-json)

[   {     "id" : "ocid1.tagdefault.oc1..aaaaaaaasexampleuniqueID",     "compartmentId" : "ocid1.compartment.oc1..aaaaaaaaexampleuniqueID",     "tagNamespaceId" : "ocid1.namespace.oc1..aaaaaaaaexampleuniqueID",     "tagDefinitionId" : "ocid1.tagdefinition.oc1..aaaaaaaaexampleuniqueID",     "tagDefinitionName" : "Finance",     "value" : "W123",     "timeCreated" : "2018-11-22T19:00:00.000Z",     "lifecycleState" : "ACTIVE",     "isRequired" : "true"   },   {     "id" : "ocid1.tagdefault.oc1..aaaaaaaasexampleuniqueID",     "compartmentId" : "ocid1.compartment.oc1..aaaaaaaaexampleuniqueID",     "tagNamespaceId" : "ocid1.namespace.oc1..aaaaaaaaexampleuniqueID",     "tagDefinitionId" : "ocid1.tagdefinition.oc1..aaaaaaaasexampleuniqueID",     "tagDefinitionName" : "Operations",     "value" : "Dept42",     "timeCreated" : "2018-11-22T20:00:00.000Z",     "lifecycleState" : "ACTIVE",     "isRequired" : "false"   } ] 

400 Response

Bad Request

Headers

• opc-request-id: string
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

The properties that define an error.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
• message(required): string
  A human-readable error string.

{
    "description":"The properties that define an error.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm)."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "type":"object"
}

401 Response

Unauthorized

Headers

• opc-request-id: string
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

The properties that define an error.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
• message(required): string
  A human-readable error string.

{
    "description":"The properties that define an error.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm)."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "type":"object"
}

404 Response

Not Found

Headers

• opc-request-id: string
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

The properties that define an error.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
• message(required): string
  A human-readable error string.

{
    "description":"The properties that define an error.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm)."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "type":"object"
}

429 Response

Too Many Requests

Headers

• opc-request-id: string
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

The properties that define an error.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
• message(required): string
  A human-readable error string.

{
    "description":"The properties that define an error.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm)."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "type":"object"
}

500 Response

Internal Server Error

Headers

• opc-request-id: string
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

The properties that define an error.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
• message(required): string
  A human-readable error string.

{
    "description":"The properties that define an error.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm)."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "type":"object"
}

Default Response

An error has occurred.

Headers

• opc-request-id: string
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

The properties that define an error.

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
• message(required): string
  A human-readable error string.

{
    "description":"The properties that define an error.",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm)."
        },
        "message":{
            "type":"string",
            "description":"A human-readable error string."
        }
    },
    "type":"object"
}

Back to Top