Policy >
Infra
>
Tags
Get status of tag bulk operation
Get status of tag bulk operation with details of tag operation on each virtual machine.
Request:
Method:
GET
URI Path(s):
/policy/api/v1/infra/tags/tag-operations/<operation-id>/status
/policy/api/v1/global-infra/tags/tag-operations/<operation-id>/status
Request Headers:
n/a
Query Parameters:
n/a
Request Body:
n/a
Example Request:
GET https://<policy-mgr>/policy/api/v1/infra/tags/tag-operations/win-vm-update/status
Successful Response:
Response Code:
200 OK
Response Headers:
Content-type: application/json
Response Body:
TagBulkOperationStatus
+
TagBulkOperationStatus
(
schema
)
Name
Description
Type
Notes
apply_to
Tag apply operation status per resource type
Tag apply operation status per resource type.
array of
ResourceTypeTagStatus
path
Intent path corresponding to tag operation
string
Required
remove_from
Tag remove operation status per resource type
Tag remove operation status per resource type
array of
ResourceTypeTagStatus
status
Overall status
string
Required
Enum: Success, Running, Error, Pending
tag
Tag
Tag
Required
Example Response:
{ "tag": { "scope": "os", "tag": "windows" }, "status": "Error", "apply_to": [ { "resource_type": "VirtualMachine", "resource_tag_status": [ { "resource_id": "e98a906-7b84-42ae-9413-d812cdb64543", "tag_status": "Success" } ] } ], "remove_from":[ { "resource_type": "VirtualMachine", "resource_tag_status": [ { "resource_id": "564d8b81-983d-b8ef-686b-161205939c58", "tag_status": "Error", "details": "VM with external id not found" } ] } ], }
Required Permissions:
crud
Feature:
policy_vm_vm_tags
Additional Errors:
301 Moved Permanently
307 Temporary Redirect
400 Bad Request
403 Forbidden
409 Conflict
500 Internal Server Error
503 Service Unavailable