Attach Multiple Tags To Object Tag Association
If vSphere APIs begin with /rest (vs /api), any maps are consumed/returned instead as arrays of objects, each containing a key and a value property field.
Attaches 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
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, obtained by first calling Create Session API
Example: b00db39f948d13ea1e59b4d6fce56389
Request Body
Request Body
TaggingTagAssociationAttachMultipleTagsToObjectRequestBody of type application/json (required){
"tag_ids": [
"string"
]
}
Std_DynamicID
object_id
Required
The identifier of the input object.
array of
string
tag_ids
Required
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
TaggingTagAssociationAttachMultipleTagsToObjectResponseBody
of type application/json
The outcome of the batch operation and the list of error messages (TagAssociation.BatchResult.error-messages) describing attachment failures.
{
"value": {
"success": false
}
}
value
Optional
The outcome of the batch operation and the list of error messages (TagAssociation.BatchResult.error-messages) describing attachment failures.
cURL Command
curl -X POST -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" -H "Content-Type: application/json" -d '{"tag_ids":["string"]}' https://{api_host}/rest/com/vmware/cis/tagging/tag_association?~action=attach-multiple-tags-to-object
Errors
401
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.
