Task Get Info

Detailed information about this task.

Request

URI

GET

https://{vcenter-host}/sdk/vim25/{release}/Task/{moId}/info

COPY

Path Parameters

string

moId

Required

The unique identifier for the managed object to which the property attaches; the serialized managed object reference for a request has the form moType/moId, in this case Task/{moId}.

string

release

Required

The vSphere release schema. The current specification covers vSphere 8.0.2.0 APIs.

Authentication

This operation uses the following authentication methods.

Session

Responses

200

Returns TaskInfo of type(s) application/json

This response body class contains all of the following: DataObject

{
    "_typeName": "string",
    "key": "string",
    "task": {
        "_typeName": "string",
        "type": "string",
        "value": "string"
    },
    "description": {
        "_typeName": "string",
        "key": "string",
        "arg": [
            {
                "_typeName": "string",
                "key": "string",
                "value": {
                    "_typeName": "string"
                }
            }
        ],
        "message": "string"
    },
    "name": "string",
    "descriptionId": "string",
    "entity": {
        "_typeName": "string",
        "type": "string",
        "value": "string"
    },
    "entityName": "string",
    "locked": [
        {
            "_typeName": "string",
            "type": "string",
            "value": "string"
        }
    ],
    "state": "string",
    "cancelled": false,
    "cancelable": false,
    "error": {
        "_typeName": "string",
        "faultCause": "MethodFault Object",
        "faultMessage": [
            {
                "_typeName": "string",
                "key": "string",
                "arg": [
                    {
                        "_typeName": "string",
                        "key": "string",
                        "value": {
                            "_typeName": "string"
                        }
                    }
                ],
                "message": "string"
            }
        ]
    },
    "result": {
        "_typeName": "string"
    },
    "progress": 0,
    "progressDetails": [
        {
            "_typeName": "string",
            "key": "string",
            "value": {
                "_typeName": "string"
            }
        }
    ],
    "reason": {
        "_typeName": "string"
    },
    "queueTime": "string",
    "startTime": "string",
    "completeTime": "string",
    "eventChainId": 0,
    "changeTag": "string",
    "parentTaskKey": "string",
    "rootTaskKey": "string",
    "activationId": "string"
}

string

key

Required

The unique key for the task.

MoRefTask

task

Required

Reference to an instance of the Task managed object.

LocalizableMessage

description

Optional

Message data which is intended to be displayed according to the locale of a client.

A LocalizableMessage contains both a formatted, localized version of the text and the data needed to perform localization in conjunction with localization catalogs.

Clients of the VIM API may use vim.SessionManager.setLocale() to cause the server to emit a localized message, or may perform client-side localization based on message catalogs provided by the server.

If the substition variable is a string, no further lookup is required.
- arg = [("address" = "127.0.0.1")]
- CATALOG(locmsg, key) = "IP address is {address}"
- ==> message = "IP address is 127.0.0.1"
If the substitution variable is an integer, value is a lookup key.
- arg = [("1" = "button.cancel"), ("2" = "msg.revert")]
- CATALOG(locmsg, key) = "Select '{1}' to {2}"
- CATALOG(locmsg, button.cancel) = "Cancel"
- CATALOG(locmsg, msg.revert) = "revert"
- ==> message = "Select 'Cancel' to revert"
If the variable contains '@', value is a label lookup in another catalog, where {[email protected]} looks up prefix.arg[name].label in CATALOG.
- arg = [("field" = "queued")]
- CATALOG(locmsg, key) = "State is {[email protected]}"
- CATALOG(enum, TaskInfo.State.queued.label) is "Queued"
- ==> message = "State is Queued"

string

name

Optional

The name of the operation that created the task.

This is not set for internal tasks.

string

descriptionId

Required

An identifier for this operation.

This includes publicly visible internal tasks and is a lookup in the TaskDescription methodInfo data object.

MoRefManagedEntity

entity

Optional

Reference to an instance of the ManagedEntity managed object.

string

entityName

Optional

The name of the managed entity, locale-specific, retained for the history collector database.

array of MoRefManagedEntity

locked

Optional

If the state of the task is "running", then this property is a list of managed entities that the operation has locked, with a shared lock.

TaskInfoState_enum

state

Required

List of possible states of a task.

Possible values:

queued: When there are too many tasks for threads to handle.
running: When the busy thread is freed from its current task by finishing the task, it picks a queued task to run.

Then the queued tasks are marked as running.
success: When a running task has completed.
error: When a running task has encountered an error.