REST API for Oracle Private Cloud Appliance Compute Enclave

Update a Tag Default

put

/20160918/tagDefaults/{tag_default_id}

Updates the specified tag default. 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.

Request

Supported Media Types

application/json

Path Parameters

tagDefaultId(required): string

The OCID of the tag default.

Query Parameters

isLockOverride: boolean

Whether to override locks (if any exist).

Default Value: false

Header Parameters

if-match: string

For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
opc-request-id: string

Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.

Request object for updating a tag default.

Root Schema : UpdateTagDefaultDetails

Type: object

Show Source

isRequired: 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. Example: false
value(required): string

The default value for the tag definition. This will be applied to all resources created in the Compartment.

{
    "required":[
        "value"
    ],
    "properties":{
        "value":{
            "type":"string",
            "description":"The default value for the tag definition. This will be applied to all resources created in the Compartment."
        },
        "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. Example: false "
        }
    },
    "x-example":"{     \"value\" : \"W123\",     \"isRequired\" : \"false\" } ",
    "type":"object"
}

Response

Supported Media Types

application/json

200 Response

The tag default was updated.

Headers

etag: string

For optimistic concurrency control. See `if-match`.
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.

Root Schema : TagDefault

Type: object

Tag defaults let you specify a default tag (tagnamespace.tag="value") to apply to all resource types in a specified compartment. The tag default is applied at the time the resource is created. Resources that exist in the compartment before you create the tag default are not tagged. The TagDefault object specifies the tag and compartment details. Tag defaults are inherited by child compartments. This means that if you set a tag default on the root compartment for a tenancy, all resources that are created in the tenancy are tagged. To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator.

Show Source

compartmentId(required): string

The OCID of the compartment. The tag default applies to all new resources that get created in the compartment. Resources that existed before the tag default was created are not tagged.
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. Example: false
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 resources created in the compartment.

{
    "description":"Tag defaults let you specify a default tag (tagnamespace.tag=\"value\") to apply to all resource types in a specified compartment. The tag default is applied at the time the resource is created. Resources that exist in the compartment before you create the tag default are not tagged. The TagDefault object specifies the tag and compartment details. Tag defaults are inherited by child compartments. This means that if you set a tag default on the root compartment for a tenancy, all resources that are created in the tenancy are tagged. To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator.",
    "x-obmcs-splat":{
        "resourceKind":"tag-default",
        "ocidEntityType":"tagdefault",
        "adLocality":"realm",
        "generateOcidVersion":"V2",
        "taggable":false,
        "activeLifecycleStates":[
            "active",
            "inactive"
        ],
        "deletedLifecycleStates":[
            "deleted"
        ],
        "getOperationId":"GetTagDefault",
        "listResourcesOperationId":"ListTagDefaults",
        "searchMetadata":{
            "resourceSchemaVersion":1,
            "resourceType":"TagDefault",
            "scope":"customer",
            "rvnFromHeader":true,
            "fieldNameMap":{
                "tagDefinitionName":"displayName"
            }
        }
    },
    "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 applies to all new resources that get created in the compartment. Resources that existed before the tag default was created are not tagged."
        },
        "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 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. Example: false "
        },
        "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\" : \"true\" } ",
    "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..aaaaaaaaexampleuniqueID",   "compartmentId" : "ocid1.compartment.oc1..aaaaaaaaexampleuniqueID",   "tagNamespaceId" : "ocid1.namespace.oc1..aaaaaaaasexampleuniqueID",   "tagDefinitionId" : "ocid1.tagdefinition.oc1..aaaaaaaasexampleuniqueID",   "tagDefinitionName" : "Finance",   "value" : "W123",   "timeCreated" : "2018-11-22T19: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.

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.

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.

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"
}

412 Response

Precondition Failed

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.

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.

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.

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.

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"
}