Get Agent Upgrade Task V2

Get Agent Upgrade Task V2

All the listed privileges are required -

Privileges	Description
MACHINE_VIEW	Caller should have permission to this privilege, to perform this operation.

Request

URI

GET

https://{api_host}/rest/inventory/v2/machines/agent-upgrade-tasks/{id}

COPY

Path Parameters

string

id

Required

id

Authentication

This operation uses the following authentication methods.

Bearer

Responses

200

OK

Returns AgentUpgradeTaskInfoV2 of type(s) */*

{
    "agent_installer_package_id": "2b6eaeb8-2e91-11ed-a261-0242ac120002",
    "batch_size": 20,
    "cancelled_machine_or_rds_server_ids": [
        "0103796c-102b-4ed3-953f-3dfe3d23e0fe",
        "7cdd624f-37d1-46c1-ab96-695a5d13956f"
    ],
    "end_time": 1652079610000,
    "failed_machine_or_rds_server_ids": [
        "0103796c-102b-4ed3-953f-3dfe3d23e0fe",
        "7cdd624f-37d1-46c1-ab96-695a5d13956f"
    ],
    "failure_threshold": 10,
    "id": "16c2faaa-2e8c-11ed-a261-0242ac120002",
    "in_progress_machine_or_rds_server_ids": [
        "0103796c-102b-4ed3-953f-3dfe3d23e0fe",
        "7cdd624f-37d1-46c1-ab96-695a5d13956f"
    ],
    "not_started_machine_or_rds_server_ids": [
        "0103796c-102b-4ed3-953f-3dfe3d23e0fe",
        "7cdd624f-37d1-46c1-ab96-695a5d13956f"
    ],
    "operation": "SCHEDULED",
    "skipped_machine_or_rds_server_ids": [
        "0103796c-102b-4ed3-953f-3dfe3d23e0fe",
        "7cdd624f-37d1-46c1-ab96-695a5d13956f"
    ],
    "start_time": 1652079610000,
    "state": "string",
    "succeeded_machine_or_rds_server_ids": [
        "0103796c-102b-4ed3-953f-3dfe3d23e0fe",
        "7cdd624f-37d1-46c1-ab96-695a5d13956f"
    ]
}

string

agent_installer_package_id

Optional

ID of the agent installer package.

integer As int32 As int32

batch_size

Optional

Indicates the size of the batch to be considered for agent upgrade, in percentage.

array of string

cancelled_machine_or_rds_server_ids

Optional

Machines or RDS servers for which upgrade has been cancelled.

integer As int64 As int64

end_time

Optional

Agent upgrade end time.

array of string

failed_machine_or_rds_server_ids

Optional

Machines or RDS servers for which upgrade has failed.

integer As int32 As int32

failure_threshold

Optional

Indicates the threshold for tolerating failures, beyond which upgrades will be skipped, in percentage.

string

id

Optional

Task ID of the agent upgrade.

array of string

in_progress_machine_or_rds_server_ids

Optional

Machines or RDS servers for which upgrade are in progress.

array of string

not_started_machine_or_rds_server_ids

Optional

Machines or RDS servers for which upgrade has not started.

string

operation

Optional

The current agent upgrade task operation.

array of string

skipped_machine_or_rds_server_ids

Optional

Machines or RDS servers for which upgrade has skipped.

integer As int64 As int64

start_time

Optional

Agent upgrade start time.

string

state

Optional

The state of an agent upgrade task.

array of string

succeeded_machine_or_rds_server_ids

Optional

Machines or RDS servers for which upgrade has succeeded.

401

User is not authenticated

Operation doesn't return any data structure

403

Access to the resource is forbidden

Operation doesn't return any data structure

404

Not Found

Operation doesn't return any data structure

On This Page

Request

Path Parameters

200 Response Body

Errors

Inventory Operations

Add Custom Icon

Add Local Application Pools To GAE

Add Local Desktop Pools To GDE

Add Machines By Name

Add Rds Servers

Application Icon Bulk Associate

Application Icon Bulk Remove Association

Archive Machines

Assign Machine Aliases

Attach Persistent Disk

Cancel Agent Upgrades

Cancel Desktop Pool Task

Cancel Rds Server Agent Upgrades

Cancel Scheduled Maintenance

Cancel Scheduled Push Image

Check Application Pool Name Availability

Check Desktop Pool Name Availability

Check Farm Name Availability

Check Machine Prefix Availability

Check RDS Server Prefix Availability

Create Application Icon

Create Application Pool

Create Application Pool V2

Create Application Pool V3

Create Application Pool V5

Create Application Pool V6

Create Desktop Pool

Create Desktop Pool V2

Create Desktop Pool V7

Create Desktop Pool V8

Create Global Application Entitlement

Create Global Application Entitlement V3

Create Global Application Entitlement V4

Create Global Desktop Entitlement

Create Global Desktop Entitlement V2

Create Global Desktop Entitlement V3

Create Global Desktop Entitlement V4

Create Persistent Disk

Create Policy Overrides For Users

Delete Application Icon

Delete Application Pool

Delete Application Pools

Delete Application Pools V5

Delete Application Pools V6

Delete Desktop Pool

Delete Desktop Pool V7

Delete Desktop Pool V8

Delete Global Application Entitlement

Delete Global Application Entitlement V3

Delete Global Application Entitlement V4

Delete Global Desktop Entitlement

Delete Global Desktop Entitlement V3

Delete Global Desktop Entitlement V4

Delete Machines

Delete Persistent Disk

Delete Physical Machine

Delete Policy Overrides For Users

Delete RDS Server

Delete RDS Server V2

Desktop Pool Apply Image

Desktop Pool Promote Pending Image

Detach Persistent Disk

Disable Application Pools

Disable Desktop Pools

Disable Provisioning For Desktop Pools

Disconnect Global Sessions

Disconnect Sessions

Enable Application Pools

Enable Desktop Pools

Enable Provisioning For Desktop Pools

Enter Maintenance

Exit Maintenance

Farm Apply Image

Farm Promote Pending Image

Get Agent Installer Package

Get Agent Upgrade Task

Get Agent Upgrade Task V2

Get Application Icon

Get Application Pool

Get Application Pool V2

Get Application Pool V3

Get Application Pool V4

Get Application Pool V5

Get Application Pool V6

Get Desktop Pool

Get Desktop Pool Task

Get Desktop Pool V2

Get Desktop Pool V3

Get Desktop Pool V4

Get Desktop Pool V5

Get Desktop Pool V6

Get Desktop Pool V7

Get Desktop Pool V8

Get Global Application Entitlement

Get Global Application Entitlement V2

Get Global Application Entitlement V3

Get Global Application Entitlement V4

Get Global Desktop Entitlement

Get Global Desktop Entitlement V2

Get Global Desktop Entitlement V3

Get Global Desktop Entitlement V4

Get Persistent Disk

Get Physical Machine

Get Physical Machine V2

Get Rds Server Agent Upgrade Task

Get RDS Server V2

Get Session Info

List Agent Installer Packages

List Agent Upgrade Tasks

List Agent Upgrade Tasks V2

List Application Icons

List Application Pools

List Application Pools V2

List Application Pools V3

List Application Pools V4

List Application Pools V5

List Application Pools V6

List App Volumes Applications On Farm

List Attachable Machines

List Category Folders

List Compatible Backup GA Es

List Compatible Backup GD Es

List Compatible Local Application Pools

List Compatible Local Desktop Pools

List Custom Application Icons

List Desktop Pools

List Desktop Pools V2

List Desktop Pools V3

List Desktop Pools V4

List Desktop Pools V5

List Desktop Pools V6

List Desktop Pools V7

List Desktop Pools V8

List Desktop Pool Tasks

List Global Application Entitlements

List Global Application Entitlements V2

List Global Application Entitlements V3

List Global Application Entitlements V4

List Global Desktop Entitlements

List Global Desktop Entitlements V2

List Global Desktop Entitlements V3

List Global Desktop Entitlements V4

List Installed Applications On Desktop Pool

List Installed Applications On Farm

List Local Application Pools

List Local Desktop Pools

List Machines V2

List Machines V3

List Machines V4

List Machines V5

List Persistent Disks

List Physical Machines

List Physical Machines V2

List Policies On Desktop Pool

List Rds Server Agent Upgrade Tasks

List RDS Servers

List RDS Servers V2

List Session Info

List Session Info V2

List Unentitled Machines

List User Policies Overrides

Log Off Global Sessions

Log Off Sessions

Pause Desktop Pool Task

Query Global Sessions

Rebuild Machines

Recover Machines

Recover RDS Servers

Recreate From Persistent Disk

Register Agent Installer Package

Register Physical Machine

Register RDS Server

Remove Custom Icon

Remove Local Application Pools From GAE

Remove Local Desktop Pools From GDE

Remove Machines

Remove Rds Servers

Reset Global Sessions

Restart Global Sessions

Restart Machines

Restart Sessions

Resume Desktop Pool Task

Schedule Agent For Upgrade

Schedule Agent For Upgrade Rds Server

Schedule Agent For Upgrade V2

Schedule Maintenance

Schedule Maintenance V2

Schedule Push Image

Schedule Push Image V2

Send Message To Global Sessions

Send Message To Sessions

Unassign Machine Aliases

Unregister Agent Installer Package

Update Application Pool

Update Application Pool V2

Update Application Pool V3

Update Application Pool V5

Update Application Pool V6

Update Desktop Pool

Update Desktop Poolv7

Update Desktop Poolv8

Update Global Application Entitlement

Update Global Application Entitlement V3

Update Global Application Entitlement V4

Update Global Desktop Entitlement

Update Global Desktop Entitlement V3

Update Global Desktop Entitlement V4

Update Persistent Disk

Update Policy Overrides For Users

Update RDS Server

Update RDS Server V2

Updates Policies On Desktop Pool

Validate Installed Applications On Desktop Pool

Validate Installed Applications On Farm

Validate Specified Names