Query Tasks
This request returns information about the tasks.
Optional site to retrieve the task from. Could be a remote site or the local one.
site2
If present, the returned tasks' IDs will be in the given list. Comma-separated task IDs are expected.
2bfb7696-3aa1-49d3-bb40-d9e97df1baba,107102e0-e03b-404e-8e17-0688c657a74b
If present, applies equals filtering by username. Available only to admins.
System
If present, applies equals filtering by state. Available values: [RUNNING, SUCCEEDED, FAILED]
RUNNING
If present, applies less-than filtering by startTime.
1499929548951
If present, applies greater-than filtering by startTime.
1499928548623
If present, applies less-than filtering by endTime.
1499929599999
If present, applies greater-than filtering by endTime.
1499929500000
If present, applies equals filtering by workflowinfo.type.
failover
If present, applies equals filtering by workflowinfo.resourceId.
H4-ec991bd5-af9d-446a-8599-5b693842c4a3
If present, applies equals filtering by workflowinfo.resourceName.
VM-001
If present, applies equals filtering by workflowinfo.resourceType.
replication
Optional list of comma-separated fields, used to sort the result. The default sorting direction is ascending. If one of the fields ends with a hyphen, the direction for this field will be descending. If this field is omitted, the result is sorted by start time in descending order.
startTime, state, endTime, user-
Query limit - maximum number of items this query should retrieve. If omitted or higher than the server's limits, defaults to 100.
10
Query offset - how much items to skip, before retrieving the actual items. If omitted, defaults to 0.
10
Operation ID for correlating logs across multiple services
OK
{
"items": [
{
"endTime": 1499929558827,
"error": {
"args": [],
"code": "Forbidden",
"msg": "Permission denied.",
"stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
},
"id": "f61d60d2-698a-46dc-a266-88df27644956",
"lastUpdated": 1499929558827,
"progress": 100,
"resultType": "string",
"site": "site2",
"startTime": 1499929548951,
"state": "string",
"user": "root",
"warnings": [],
"workflowInfo": {}
}
],
"limit": 100,
"offset": 0,
"total": 3
}
Maximum number of items that this query could retrieve.
How much items were skipped, before retrieving the actual items.
The total number of items.
The returned error codes include (but are not limited to): BadRequest, BadUserInput, UnsupportedSortingField
{
"args": [],
"code": "Forbidden",
"msg": "Permission denied.",
"stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
Positional arguments.
Specific error code.
Detailed error message.
Exception stacktrace.
The returned error codes include (but are not limited to): NotAuthenticated, RemoteAuthenticationFailure
{
"args": [],
"code": "Forbidden",
"msg": "Permission denied.",
"stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
Positional arguments.
Specific error code.
Detailed error message.
Exception stacktrace.
The returned error codes include (but are not limited to): SiteNotFound, TaskNotFound
{
"args": [],
"code": "Forbidden",
"msg": "Permission denied.",
"stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
Positional arguments.
Specific error code.
Detailed error message.
Exception stacktrace.
The returned error codes include (but are not limited to): GeneralServerFailure
{
"args": [],
"code": "Forbidden",
"msg": "Permission denied.",
"stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
Positional arguments.
Specific error code.
Detailed error message.
Exception stacktrace.