Developer Documentation
Detach Tag Association
Detaches the tag from the given object. If the tag is already removed from the object, then this operation is a no-op and an error will not be thrown. To invoke this operation, you need the attach tag privilege on the tag and the read privilege on the object.
Request
URLURL
https://{api_host}/rest/com/vmware/cis/tagging/tag-association/id:{tag_id}?~action=detach
Path Parameters
Path Parameters
| Required | Parameter Name | Type | Description |
|---|---|---|---|
| required |
|
string | The identifier of the input tag. The parameter must be an identifier for the resource type: com.vmware.cis.tagging.Tag. |
Request Body
Request Body
Contains
DetachRequestBody
of type application/json
(required)
{}| Required | Property Name | Type | Description |
|---|---|---|---|
| required | object_id | Std_DynamicID |
The identifier of the input object. |
Errors
| Code | Returns | Description |
|---|---|---|
| 404 | Error | com.vmware.vapi.std.errors.not_found : if the tag for the given tagId does not exist in the system. |
| default | Error | Not available |
| 401 | Error | com.vmware.vapi.std.errors.unauthorized : if you do not have the privilege to detach the tag or do not have the privilege to read the given object. | com.vmware.vapi.std.errors.unauthenticated : if the user can not be authenticated. |
