Schedule Agent For Upgrade V2

Schedule Agent For Upgrade V2

All the listed privileges are required -

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

Request

URI

POST

https://{api_host}/rest/inventory/v2/machines/action/schedule-agent-upgrade

COPY

Request Body

AgentUpgradeSpec of type(s) application/json

Required

{
    "agent_installer_package_id": "2b6eaeb8-2e91-11ed-a261-0242ac120002",
    "batch_size": 20,
    "custom_install_parameters": "ADDLOCAL=Core,USB",
    "end_time": 1652079610000,
    "failure_threshold": 10,
    "machine_or_rds_server_ids": [
        "0103796c-102b-4ed3-953f-3dfe3d23e0fe",
        "7cdd624f-37d1-46c1-ab96-695a5d13956f"
    ],
    "skip_for_logged_in_users": true,
    "start_time": 1652079610000
}

string

agent_installer_package_id

Required

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.

string

custom_install_parameters

Optional

Indicates any parameters to be used by the agent for silent install.

integer As int64 As int64

end_time

Required

Agent upgrade end time.

integer As int32 As int32

failure_threshold

Optional

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

array of string

machine_or_rds_server_ids

Required

Machines or RDS servers on which the upgrade is to be scheduled.

boolean

skip_for_logged_in_users

Optional

Indicates whether to skip agent upgrade for logged in users.

integer As int64 As int64

start_time

Required

Agent upgrade start time.

Authentication

This operation uses the following authentication methods.

Bearer

Responses

200

OK

Returns AgentUpgradeTaskResponseInfo of type(s) */*

{
    "details": [
        {
            "error_messages": [
                "Entity does not exist.",
                "Property is mandatory."
            ],
            "errors": [
                {
                    "error_key": "inventory.machine.not.found",
                    "error_message": "username cannot be empty"
                }
            ],
            "id": "6f85b3a5-e7d0-4ad6-a1e3-37168dd1ed51",
            "key": "user1",
            "status_code": 200,
            "timestamp": 1561939200000
        }
    ],
    "task_id": "7d01dc94-2e93-11ed-a261-0242ac120002"
}

array of BulkItemResponseInfo

details

Optional

List of BulkItemResponseInfo corresponding to each machine id in the action operation.

string

task_id

Optional

Unique ID representing the task.

400

Bad Request

Operation doesn't return any data structure

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

On This Page

Request

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 Desktop Pool

Create Desktop Pool V2

Create Desktop Pool V7

Create Global Application Entitlement

Create Global Application Entitlement V3

Create Global Desktop Entitlement

Create Global Desktop Entitlement V2

Create Global Desktop Entitlement V3

Create Persistent Disk

Create Policy Overrides For Users

Delete Application Icon

Delete Application Pool

Delete Application Pools

Delete Application Pools V5

Delete Desktop Pool

Delete Desktop Pool V7

Delete Global Application Entitlement

Delete Global Application Entitlement V3

Delete Global Desktop Entitlement

Delete Global Desktop Entitlement V3

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 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 Global Application Entitlement

Get Global Application Entitlement V2

Get Global Application Entitlement V3

Get Global Desktop Entitlement

Get Global Desktop Entitlement V2

Get Global Desktop Entitlement V3

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 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 Pool Tasks

List Global Application Entitlements

List Global Application Entitlements V2

List Global Application Entitlements V3

List Global Desktop Entitlements

List Global Desktop Entitlements V2

List Global Desktop Entitlements V3

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 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 Desktop Pool

Update Desktop Poolv7

Update Global Application Entitlement

Update Global Application Entitlement V3

Update Global Desktop Entitlement

Update Global Desktop Entitlement V3

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