IRPCBackgroundOperationsAdmin.GetAsyncTasks
Administration API / specialized admin session idempotent
Gets the vault's asynchronous tasks, newest first.
| Service | Background operations MFiles.IRPCBackgroundOperationsAdmin |
|---|---|
| gRPC method | /MFiles.IRPCBackgroundOperationsAdmin/GetAsyncTasks |
| HTTP (mf-http-grpc) | POST /grpc/v1/get-async-tasks |
| Request | GetAsyncTasksRequest |
| Response | GetAsyncTasksResponse |
| Book and level | Administration API, specialized |
| Kind | admin |
| Session | Required: the session ID from LogIn in the mfiles-session-id-bin metadata. |
| Idempotent | yes |
| Returns metadata structure version | no |
| Streaming | none (unary) |
Remarks
- Requires a vault session and the vault right
change_metadata_structure. - Can return a very large list (up to 2,000,000 tasks). Prefer GetAsyncTasksRange, which pages and filters.
Request: GetAsyncTasksRequest
No fields.
Response: GetAsyncTasksResponse
Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.
| Field | Type | Description |
|---|---|---|
async_tasks[] | repeated AsyncTask | The tasks, newest first. |
async_tasks[].id | int64 | Task ID. |
async_tasks[].type | string | Task type name. |
async_tasks[].definition | string | The display string of the task definition. |
async_tasks[].is_running | bool | True if the task is currently running. |
async_tasks[].last_run_started_utc | google.protobuf.Timestamp | The last time the task ran started. Zero to indicate that the task has never run (or is still running for the first time). |
async_tasks[].last_run_ended_utc | google.protobuf.Timestamp | The last time the task ran ended. Zero to indicate that the task has never run (or is still running for the first time). |
async_tasks[].last_run_succeeded | bool | True if the last run was successful, false otherwise. |
async_tasks[].last_run_errors | string | Error string from the last run (if any). |
async_tasks[].canceled | bool | True if the task is canceled. |
async_tasks[].progress_info | string | The progress info string of the task. |
async_tasks[].output_info | string | The output info string of the task. |
Related methods
- GetAsyncTasksRange -- Gets a page of asynchronous tasks, oldest or newest first, optionally only tasks in given states.