Get One
This request returns the current state of the specified task. The outcome, failure or success, is not available. Note: The specified task is filtered - tasks that belong to another user are not returned. Note: Different tasks have different result types. Note: During the task execution, warnings may occur. Those indicate a failure, which is not considered critical. The execution will continue as if nothing happened.
UUID of the task
f61d60d2-698a-46dc-a266-88df27644956
Optional site to retrieve the task from. Could be a remote site or the local one.
site1
Operation ID for correlating logs across multiple services
OK
{
"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": {}
}
Timestamp in msec of the completion time of the task. -1 means the task hasn't completed.
The unique identifier of the long-running task. It is unique and can be used for monitoring.
Timestamp in msec of the last task status update.
Percentage-based progress of the task.
The result of the task. Populated only if the execution was successful.
Indicates the type of the task result. Populated only if the execution was successful.
Site on which the task runs.
Timestamp in msec of the creation time of the task.
The user who started the task.
The returned error codes include (but are not limited to): BadUserInput
{
"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.