pem.getRequestStatus
This method is supported by POA starting from version 2.6.2
This method allows to obtain the information on the result of any request previously issued to POA via Public API.
There are the following use cases of this method:
- Retrieving the overall status of tasks that are scheduled after the pem.batchRequest method execution.
- Retrieving the overall status of tasks that are scheduled after that transaction is committed.
The method has the following input parameters:
Name
|
Type
|
Short Description
|
request_id
|
string
|
The identifier of request (that was previously set by the pem.batchRequest or the txn.Begin methods).
|
Output parameters:
Name
|
Type
|
Short Description
|
request_status
|
int
|
The status of the request.
- 0 - Succeeded. This value is returned in the following cases:
- Tasks are executed.
- Tasks do not scheduled.
- 1 - Running. This value is returned in the following cases:
- There are tasks having Rescheduled Status.
- There are tasks having Unprocessed Status.
- There are tasks having Running Status.
- 2 - Failed.
- There are tasks having Failed Status.
- There are tasks having Canceled Status.
|
status_messages
|
array of strings
|
The reason of failure.
|
See also:
Using Transactions diagram