UpdateTag

PUT {{baseUrl}}/tagNamespaces/:tagNamespaceId/tags/:tagName

Updates the specified tag definition.

Setting validator determines the value type. Tags can use either a static value or a list of possible values. Static values are entered by a user applying the tag to a resource. Lists are created by you and the user must apply a value from the list. On update, any values in a list that were previously set do not change, but new values must pass validation. Values already applied to a resource do not change.

You cannot remove list values that appear in a TagDefault. To remove a list value that appears in a TagDefault, first update the TagDefault to use a different value.

Request Body

{"description"=>"Lorem anim", "isCostTracking"=>true, "isRetired"=>false, "validator"=>{"validatorType"=>"ENUM"}}

HEADERS

KeyDatatypeRequiredDescription
if-matchstringFor 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.
Content-Typestring
Datestring(Required) Current Date
Authorizationstring(Required) Signature Authentication on Authorization header
x-content-sha256string(Required) Content sha256 for POST, PUT and PATCH operations

RESPONSES

status: OK

{"compartmentId":"fugiat incididunt dolor","tagNamespaceId":"mollit","tagNamespaceName":"cillum officia","id":"in tempor ","name":"eiusmod ad in elit","description":"deserunt","isRetired":false,"timeCreated":"1965-11-30T05:55:07.213Z","definedTags":{},"freeformTags":{},"isCostTracking":false,"lifecycleState":"INACTIVE","validator":{"validatorType":"ENUM"}}