CoreService

<back to all web services

CreatePatchingWindow

Patching - CRUD

Create a new patching window

Requires Authentication
Requires any of the roles:TenantReader, Admin, TenantAdmin
The following routes are available for this service:
POST/api/patching/windowsCreates a new patching window
POST/patching/windowsCreates a new patching window
CreatePatchingWindow Parameters:
NameParameterData TypeRequiredDescription
TenantNameheaderstringYes
MonthlyOccurencebodyMonthlyDayOccurenceYesOccurence of week day in the month

Allowable Values

  • First
  • Second
  • Third
  • Fourth
DayOfWeekbodyDayOfWeekYesThe day of the week, when patching will happen

Allowable Values

  • Sunday
  • Monday
  • Tuesday
  • Wednesday
  • Thursday
  • Friday
  • Saturday
TimeOfDaybodystringYesThe time, when the patching window will start
DurationbodystringNoThe max duration (hours) of the window wherein patchings can be started
IsDefaultbodybooleanNoIt's the default patching window for new resource groups
MonthlyDayOccurence Enum:
NameValue
First1
Second2
Third3
Fourth4
PatchingWindowDto Parameters:
NameParameterData TypeRequiredDescription
IdformGuidNo
NameformstringYes
DayOfWeekformDayOfWeekNo
MonthlyOccurenceformMonthlyDayOccurenceNo
TimeOfDayformTimeOnlyNo
DurationformTimeSpanNo
IsDefaultformboolNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /api/patching/windows HTTP/1.1 
Host: core.starburst.svc 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"tenantName":"String","monthlyOccurence":"First","dayOfWeek":"Sunday","timeOfDay":"00:00:00","duration":"00:00:00","isDefault":false,"txId":"00000000-0000-0000-0000-000000000000"}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"id":"00000000-0000-0000-0000-000000000000","name":"String","dayOfWeek":"Sunday","monthlyOccurence":"First","timeOfDay":"00:00:00","duration":"00:00:00","isDefault":false}