System Administration > Configuration > Fabric > Inventory > Virtual Machines

Perform action on specified virtual machine e.g. update tags

Perform action on a specific virtual machine. External id of the virtual machine needs to be
provided in the request body. Some of the actions that can be performed are update tags, add
tags, remove tags.
To add tags to existing list of tag, use action parameter add_tags.
To remove tags from existing list of tag, use action parameter remove_tags.
To replace existing tags with new tags, use action parameter update_tags.
To clear all tags, provide an empty list and action parameter as update_tags.
The vmw-async: True HTTP header cannot be used with this API.

Request:

Method:
POST
URI Path(s):
/api/v1/fabric/virtual-machines?action=remove_tags
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
VirtualMachineTagUpdate+

Example Request:

POST https://<nsx-mgr>/api/v1/fabric/virtual-machines?action=remove_tags { "external_id": "ID-0", "tags": [ {"scope": "os", "tag": "win32"}, {"scope": "security", "tag": "PCI"} ] }

Successful Response:

Response Code:
204 No Content
Response Headers:
n/a
Response Body:
n/a

Required Permissions:

crud

Feature:

vm_vm_tags

Additional Errors: