Shutdown

Create Shutdown

Creates a new Shutdown Schedule.

POST/api/RDS/HostPool/Schedule/Shutdown

Body

application/json; api-version=1.0

The Schedule settings.

name*nullable string

Schedule name.

siteIdinteger (int32)

Site ID from which to retrieve the schedule.

enablednullable boolean

Whether to enable or disable the schedule.

descriptionnullable string

Schedule description.

typenullable integer (int32)

Schedule type

startDateTimestring (date-time)

Start time. Default: Now.

durationInSecsnullable number (double)

Duration in seconds.

repeatenum

Repeat Type

0 = Never,1 = EveryDay,2 = EveryWeek,3 = Every2Weeks,4 = EveryMonth,5 = EveryYear,6 = SpecificDays

specificDaysenum

Repeat Specific Days

0 = Never,1 = Sunday,2 = Monday,4 = Tuesday,8 = Wednesday,16 = Thursday,32 = Friday,64 = Saturday

completeInnullable integer (int32)

The duration of the scheduler task in minutes. Default: 15 minutes for disable task, 10 minutes for reboot task.

poolMembersTypenullable integer (int32)

Whether to select the percentage or specific number of members to be started

percentageMembersnullable integer (int32)

Percentage of members to be started

membersToStartnullable integer (int32)

Specific number of members to be started

powerOnAssignedPoolMembersnullable integer (int32)

Power On Assigned Pool Members

enableDrainModenullable boolean

Whether to enable Drain Mode

forceServerRebootAfternullable integer (int32)

Force server reboot after the specified time in seconds

enforceScheduleInactiveHostnullable boolean

Enforce schedule for currently inactive host

onDisablenullable boolean

What action to take on Disable

Response

200401409

Success

Body

application/json; api-version=1.0

idinteger (int32)

ID of the object.

adminCreatenullable string

User who created the object.

adminLastModnullable string

User who last modified the object.

timeCreatestring (date-time)

Time when the object was created.

timeLastModstring (date-time)

Time when the object was last modified.

siteIDinteger (int32)

Site ID

objTypeenum

Schedule Object Type

44 = RDS,92 = AVD,100 = VDI

actionenum

Schedule Action Type

0 = Disable,1 = Reboot,3 = Startup,4 = Shutdown,7 = Recreate

targetTypeenum

Scheduler Target Type

0 = Host,1 = HostPool

enabledboolean

Enabled

namenullable string

Name

descriptionnullable string

Description

typenullable integer (int32)

Type

targetIDsnullable array of integer (int32)

Target IDs

targetNativeHostsnullable array of object

Target Native Hosts

triggerobject

Trigger

optionsobject

Options

Request

JavaScriptCurlPythonHTTP

const response = await fetch('/api/RDS/HostPool/Schedule/Shutdown', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json; api-version=1.0"
    },
    body: JSON.stringify({
      "name": "text",
      "repeat": [
        "0 = Never",
        "1 = EveryDay",
        "2 = EveryWeek",
        "3 = Every2Weeks",
        "4 = EveryMonth",
        "5 = EveryYear",
        "6 = SpecificDays"
      ],
      "specificDays": [
        "0 = Never",
        "1 = Sunday",
        "2 = Monday",
        "4 = Tuesday",
        "8 = Wednesday",
        "16 = Thursday",
        "32 = Friday",
        "64 = Saturday"
      ]
    }),
});
const data = await response.json();

Response

200401409

{
  "id": 1,
  "adminCreate": "text",
  "adminLastMod": "text",
  "timeCreate": "2025-02-05T04:01:29.246Z",
  "timeLastMod": "2025-02-05T04:01:29.246Z",
  "siteID": 1,
  "objType": [
    "44 = RDS",
    "92 = AVD",
    "100 = VDI"
  ],
  "action": [
    "0 = Disable",
    "1 = Reboot",
    "3 = Startup",
    "4 = Shutdown",
    "7 = Recreate"
  ],
  "targetType": [
    "0 = Host",
    "1 = HostPool"
  ],
  "enabled": true,
  "name": "text",
  "description": "text",
  "type": 1,
  "targetIDs": [
    1
  ],
  "targetNativeHosts": [
    {
      "poolId": 1,
      "guid": "text",
      "guestName": "text",
      "hostAzureID": "text"
    }
  ],
  "trigger": {
    "startDateTime": "2025-02-05T04:01:29.246Z",
    "endDateTime": "2025-02-05T04:01:29.246Z",
    "repeat": [
      "0 = Never",
      "1 = EveryDay",
      "2 = EveryWeek",
      "3 = Every2Weeks",
      "4 = EveryMonth",
      "5 = EveryYear",
      "6 = SpecificDays"
    ],
    "specificDays": [
      "0 = Never",
      "1 = Sunday",
      "2 = Monday",
      "4 = Tuesday",
      "8 = Wednesday",
      "16 = Thursday",
      "32 = Friday",
      "64 = Saturday"
    ],
    "durationInSecs": 1,
    "completeIn": 1
  },
  "options": {
    "poolMembersType": 1,
    "percentageMembers": 1,
    "membersToStart": 1,
    "powerOnAssignedPoolMembers": 1,
    "messages": [
      {
        "id": 1,
        "enabled": true,
        "messageTitle": "text",
        "message": "text",
        "sendMsgSecs": 1,
        "sendMsgWhen": [
          "0 = Before",
          "1 = After"
        ]
      }
    ],
    "enableDrainMode": true,
    "forceServerRebootAfter": 1,
    "enforceScheduleInactiveHost": true,
    "onDisable": true
  }
}