Bulk Poll

Bulk Poll

This request returns the tasks that are specified in the body. Use this API for efficient task polling. Note: The specified tasks are filtered - which is not considered critical. The task execution continues as normal.

Request
URI
POST
https://{api_host}//tasks/poll
COPY
Query Parameters
string
site
Optional

Optional site to retrieve the task from. Could be a remote site or the local one.

site example
site1
Header Parameters
string
operationID
Optional

Operation ID for correlating logs across multiple services


Request Body

List of task UUIDs

Array of string of type(s) application/json
Optional
[
    {}
]
Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns TasksPollResponse of type(s) application/json;charset=UTF-8
{
    "propertyNames": [
        "string"
    ],
    "values": [
        [
            {}
        ]
    ]
}
array of string
propertyNames
Optional

propertyNames

array
values
Optional

values


400

The returned error codes include (but are not limited to):

  • BadUserInput
Returns ApiError of type(s) application/json;charset=UTF-8
{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
array of string
args
Optional

Positional arguments.

string
code
Optional

Specific error code.

string
msg
Optional

Detailed error message.

string
stacktrace
Optional

Exception stacktrace.


401

The returned error codes include (but are not limited to):

  • NotAuthenticated
  • RemoteAuthenticationFailure
Returns ApiError of type(s) application/json;charset=UTF-8
{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
array of string
args
Optional

Positional arguments.

string
code
Optional

Specific error code.

string
msg
Optional

Detailed error message.

string
stacktrace
Optional

Exception stacktrace.


404

The returned error codes include (but are not limited to):

  • SiteNotFound
  • TaskNotFound
Returns ApiError of type(s) application/json;charset=UTF-8
{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
array of string
args
Optional

Positional arguments.

string
code
Optional

Specific error code.

string
msg
Optional

Detailed error message.

string
stacktrace
Optional

Exception stacktrace.


500

The returned error codes include (but are not limited to):

  • GeneralServerFailure
Returns ApiError of type(s) application/json;charset=UTF-8
{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
array of string
args
Optional

Positional arguments.

string
code
Optional

Specific error code.

string
msg
Optional

Detailed error message.

string
stacktrace
Optional

Exception stacktrace.