Delete a Tag
delete
/paas/api/v1.1/tags/{identityDomainId}/tags/{tagKey}/{tagValue}
Deletes the tag that has the specified key and value. The value may be an empty string to match a tag that has an empty value.
Only a user-defined tag can be deleted.
Set the optional ?removeAssignments
query parameter to true
to remove the tag and any existing assignments that match the specified key and value.
Request
Path Parameters
-
identityDomainId: string
Identity domain ID for the Oracle Data Hub Cloud Service account.
-
tagKey: string
Tag key.
-
tagValue: string
Tag value.
Query Parameters
-
removeAssignments(optional): boolean
Flag that specifies whether to allow (
true
) or not allow (false
) deletion if there are tag assignments that match the specified key/value pair.
Response
204 Response
No Content.
Successfully deleted the tag. There is no response body.
400 Response
Bad request.
An attempt was made to delete a tag that cannot be removed (for example, a system-provided tag cannot be deleted).
404 Response
Not found.
No tag with the specified key/value was found.
409 Response
Conflict.
The tag is assigned to one or more resources, and the removeAssignments
query parameter was not set to true
.