Developer Documentation
Attach Multiple Tags To Object Tag Association
Released in v6.5Attaches the given tags to the input object. If a tag is already attached to the object, then the individual operation is a no-op and an error will not be added to TagAssociation.BatchResult.error-messages. To invoke this operation, you need the read privilege on the object and the attach tag privilege on each tag.
Request
URLURL
https://{api_host}/rest/com/vmware/cis/tagging/tag_association?~action=attach-multiple-tags-to-object
Request Body
Request Body
Contains
AttachMultipleTagsToObjectRequestBody
of type application/json
(required)
{
"tag_ids": [
"string"
]
}| Required | Property Name | Type | Description |
|---|---|---|---|
| required | object_id | Std_DynamicID |
The identifier of the input object. |
| required | tag_ids | array of string |
The identifiers of the input tags. The parameter must contain identifiers for the resource type: com.vmware.cis.tagging.Tag. |
Response
Response
Response BodyResponse Body
200 OK returns
AttachMultipleTagsToObjectResponseBody
of type application/json
This structure was autogenerated to hold a response body. It contains: The outcome of the batch operation and the list of error messages (TagAssociation.BatchResult.error-messages) describing attachment failures.
{
"value": {
"success": false
}
}| Property Name | Type | Description |
|---|---|---|
| value | TagAssociationBatchResult |
The outcome of the batch operation and the list of error messages (TagAssociation.BatchResult.error-messages) describing attachment failures. |
Errors
| Code | Returns | Description |
|---|---|---|
| default | Error | Not available |
| 401 | Error | com.vmware.vapi.std.errors.unauthorized : if you do not have the privilege to read the object. | com.vmware.vapi.std.errors.unauthenticated : if the user can not be authenticated. |
