Task

Task
Task

Represents a hierarchical task structure supporting nested sub-tasks and execution steps. For complete examples demonstrating the hierarchical task model with sub-tasks, steps, and various execution scenarios, see: classpath:sample-task-example.yaml

JSON Example
{
    "resourceId": "af6ef462-e192-4fe1-9522-67a50a2b3392",
    "updatedBy": "admin",
    "parentTaskId": "f81ec638-4452-4ae6-bffe-2ff284b43710",
    "subTasks": [
        null,
        null
    ],
    "description": {
        "args": {
            "cloudProxyFqdn": "cloudProxy1.vsphere.local"
        },
        "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
        "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
        "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
    },
    "updateTime": "2000-01-23T04:56:07.000Z",
    "type": "type",
    "additionalDetails": "{}",
    "cancellable": true,
    "taskSummary": {
        "totalSteps": 6,
        "totalSubTasks": 0
    },
    "result": {
        "precheckReport": {
            "description": {
                "args": {
                    "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                },
                "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
            },
            "reportUrl": "reportUrl"
        },
        "precheckGroups": [
            {
                "name": {
                    "args": {
                        "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                    },
                    "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                    "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                    "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                },
                "startTime": "2000-01-23T04:56:07.000Z",
                "prechecks": [
                    {
                        "resourceId": "resourceId",
                        "issue": {
                            "id": "VCF-ERROR-001",
                            "type": "WARN",
                            "message": {
                                "args": {
                                    "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                                },
                                "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                            },
                            "resolution": {
                                "args": {
                                    "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                                },
                                "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                            }
                        },
                        "name": {
                            "args": {
                                "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                            },
                            "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                            "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                            "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                        },
                        "resourceName": "resourceName",
                        "startTime": "2000-01-23T04:56:07.000Z",
                        "id": "SYSTEM_HEALTH_CHECK",
                        "endTime": "2000-01-23T04:56:07.000Z",
                        "status": null
                    },
                    {
                        "resourceId": "resourceId",
                        "issue": {
                            "id": "VCF-ERROR-001",
                            "type": "WARN",
                            "message": {
                                "args": {
                                    "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                                },
                                "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                            },
                            "resolution": {
                                "args": {
                                    "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                                },
                                "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                            }
                        },
                        "name": {
                            "args": {
                                "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                            },
                            "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                            "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                            "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                        },
                        "resourceName": "resourceName",
                        "startTime": "2000-01-23T04:56:07.000Z",
                        "id": "SYSTEM_HEALTH_CHECK",
                        "endTime": "2000-01-23T04:56:07.000Z",
                        "status": null
                    }
                ],
                "id": "SYSTEM_HEALTH_CHECK",
                "endTime": "2000-01-23T04:56:07.000Z",
                "status": null
            },
            {
                "name": {
                    "args": {
                        "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                    },
                    "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                    "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                    "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                },
                "startTime": "2000-01-23T04:56:07.000Z",
                "prechecks": [
                    {
                        "resourceId": "resourceId",
                        "issue": {
                            "id": "VCF-ERROR-001",
                            "type": "WARN",
                            "message": {
                                "args": {
                                    "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                                },
                                "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                            },
                            "resolution": {
                                "args": {
                                    "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                                },
                                "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                            }
                        },
                        "name": {
                            "args": {
                                "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                            },
                            "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                            "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                            "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                        },
                        "resourceName": "resourceName",
                        "startTime": "2000-01-23T04:56:07.000Z",
                        "id": "SYSTEM_HEALTH_CHECK",
                        "endTime": "2000-01-23T04:56:07.000Z",
                        "status": null
                    },
                    {
                        "resourceId": "resourceId",
                        "issue": {
                            "id": "VCF-ERROR-001",
                            "type": "WARN",
                            "message": {
                                "args": {
                                    "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                                },
                                "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                            },
                            "resolution": {
                                "args": {
                                    "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                                },
                                "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                                "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                            }
                        },
                        "name": {
                            "args": {
                                "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                            },
                            "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                            "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                            "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                        },
                        "resourceName": "resourceName",
                        "startTime": "2000-01-23T04:56:07.000Z",
                        "id": "SYSTEM_HEALTH_CHECK",
                        "endTime": "2000-01-23T04:56:07.000Z",
                        "status": null
                    }
                ],
                "id": "SYSTEM_HEALTH_CHECK",
                "endTime": "2000-01-23T04:56:07.000Z",
                "status": null
            }
        ],
        "type": "type",
        "status": "PENDING"
    },
    "retriable": true,
    "createdBy": "admin",
    "createTime": "2000-01-23T04:56:07.000Z",
    "name": "vcfa_90_to_91_upgrade",
    "stages": [
        {
            "name": "package-deploy",
            "description": {
                "args": {
                    "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                },
                "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
            },
            "messages": [
                {
                    "level": "INFO",
                    "message": {
                        "args": {
                            "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                        },
                        "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                        "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                        "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                    },
                    "timestamp": "2000-01-23T04:56:07.000Z",
                    "stageId": "stage-upgrade-binary"
                },
                {
                    "level": "INFO",
                    "message": {
                        "args": {
                            "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                        },
                        "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                        "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                        "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                    },
                    "timestamp": "2000-01-23T04:56:07.000Z",
                    "stageId": "stage-upgrade-binary"
                }
            ],
            "updateTime": "2000-01-23T04:56:07.000Z",
            "startTime": "2000-01-23T04:56:07.000Z",
            "id": "id",
            "endTime": "2000-01-23T04:56:07.000Z",
            "status": "PENDING"
        },
        {
            "name": "package-deploy",
            "description": {
                "args": {
                    "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                },
                "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
            },
            "messages": [
                {
                    "level": "INFO",
                    "message": {
                        "args": {
                            "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                        },
                        "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                        "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                        "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                    },
                    "timestamp": "2000-01-23T04:56:07.000Z",
                    "stageId": "stage-upgrade-binary"
                },
                {
                    "level": "INFO",
                    "message": {
                        "args": {
                            "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                        },
                        "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                        "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                        "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
                    },
                    "timestamp": "2000-01-23T04:56:07.000Z",
                    "stageId": "stage-upgrade-binary"
                }
            ],
            "updateTime": "2000-01-23T04:56:07.000Z",
            "startTime": "2000-01-23T04:56:07.000Z",
            "id": "id",
            "endTime": "2000-01-23T04:56:07.000Z",
            "status": "PENDING"
        }
    ],
    "messages": [
        {
            "level": "INFO",
            "message": {
                "args": {
                    "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                },
                "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
            },
            "timestamp": "2000-01-23T04:56:07.000Z"
        },
        {
            "level": "INFO",
            "message": {
                "args": {
                    "cloudProxyFqdn": "cloudProxy1.vsphere.local"
                },
                "localizedMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                "defaultMessage": "Started upgrade for Cloud Proxy `cloudProxy1.vsphere.local`",
                "id": "com.broadcom.lcm.ops.cloudproxy.upgrade.started"
            },
            "timestamp": "2000-01-23T04:56:07.000Z"
        }
    ],
    "startTime": "2000-01-23T04:56:07.000Z",
    "correlationId": "39ab89c8-a945-4290-9327-13c5bd3f595c",
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "endTime": "2000-01-23T04:56:07.000Z",
    "status": "PENDING",
    "resourceType": "COMPONENT"
}
string
id
Required

Unique identifier for the task (UUID format)

string
name
Optional

Unique name of the task

description
Optional

description

status
Optional

A common status object to define the lifecycle state of an operation

Possible values are : PENDING, SCHEDULED, RUNNING, SUCCEEDED, FAILED, CANCELED,
string
type
Optional

Type of the task, example precheck, apply, validate, etc.

string
createdBy
Optional

username or service account that triggered the task.

string
updatedBy
Optional

username or service account that updated the task.

string
resourceId
Optional

ID of resource on which the task is triggered

string
resourceType
Optional

Type of resource on which the task is triggered

string As date-time As date-time
createTime
Optional

ISO 8601 timestamp when this Task was created

string As date-time As date-time
startTime
Optional

ISO 8601 timestamp when this Task was started

string As date-time As date-time
updateTime
Optional

ISO 8601 timestamp when this Task was updated

string As date-time As date-time
endTime
Optional

ISO 8601 timestamp when this Task was completed

string
correlationId
Optional

ID used to correlate the task with other systems

string
parentTaskId
Optional

ID of parent task

boolean
retriable
Optional

Indicates if this task is in a state that can be retried

boolean
cancellable
Optional

Indicates if this task is in a state that can be cancelled

taskSummary
Optional

Summary information about sub tasks. See sample-task-example.yaml for examples of how this summary is calculated.

array of TaskStage
stages
Optional

list of steps being executed in the Task workflow.

array of Task
subTasks
Optional

list of sub tasks within this parent task. Each sub task can have its own steps and can be executed independently. See classpath:sample-task-example.yaml for comprehensive examples of hierarchical task structures.

array of TaskMessage
messages
Optional

list of messages at task level

result
Optional

result

object
additionalDetails
Optional

A map of task-specific details. This can be used to store any additional information about the task that is relevant to a specific task.