Jump to

• Request
• Response

Delete Multiple Tags

put

/paas/api/v1.1/tags/{identityDomainId}/tags

Deletes one or more tags.

Set the optional ?force query parameter to true to allow tags to be deleted even if they are assigned to resources.

Request

Supported Media Types

• application/json

Path Parameters

• identityDomainId: string
  Identity domain ID for the Oracle Data Hub Cloud Service account.

Query Parameters

• force(optional): boolean
  Flag that specifies whether to allow (true) or not allow (false) tags to be deleted if the tags are assigned to resources. Default is false (do not delete if the specified tags are assigned to resources). Set to true to allow tags to be deleted even if there are tag assignments.

  Also, the request will fail (false) or not fail (true) if any of the specified tags are not found.

Body ()

The request body defines the tags to delete.

Root Schema : deletetags-request

Type: object

Show Source

• tagsToDelete: array tagsToDelete
  Groups information about the tags to delete. Each tag object is a key/value pair.

{
    "properties":{
        "tagsToDelete":{
            "type":"array",
            "description":"Groups information about the tags to delete. Each tag object is a key/value pair.",
            "items":{
                "$ref":"#/definitions/tagsdelete-request"
            }
        }
    },
    "required":[
        "tagsToDelete"
    ]
}

Nested Schema : tagsToDelete

Type: array

Groups information about the tags to delete. Each tag object is a key/value pair.

Show Source

• [0]: object tagsdelete-request

{
    "type":"array",
    "description":"Groups information about the tags to delete. Each tag object is a key/value pair.",
    "items":{
        "$ref":"#/definitions/tagsdelete-request"
    }
}

Nested Schema : tagsdelete-request

Type: object

Show Source

• key: string
  Key for this tag.
• value: string
  Value for this tag.

  Default value is an empty string (if you do not provide a specific value).

{
    "properties":{
        "key":{
            "type":"string",
            "description":"Key for this tag."
        },
        "value":{
            "type":"string",
            "description":"Value for this tag.<p>Default value is an empty string (if you do not provide a specific value)."
        }
    },
    "required":[
        "key"
    ]
}

Response

Supported Media Types

• application/json

204 Response

No content.

Successfully deleted one or more tags. 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 tags with the specified key/value pair were found, and the force query parameter was not set to true.