| Requires any of the roles: | TenantReader, Admin, TenantAdmin |
| POST | /api/patching/windows | Creates a new patching window | |
|---|---|---|---|
| POST | /patching/windows | Creates a new patching window |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| TenantName | header | string | Yes | |
| MonthlyOccurence | body | MonthlyDayOccurence | Yes | Occurence of week day in the monthAllowable Values
|
| DayOfWeek | body | DayOfWeek | Yes | The day of the week, when patching will happenAllowable Values
|
| TimeOfDay | body | string | Yes | The time, when the patching window will start |
| Duration | body | string | No | The max duration (hours) of the window wherein patchings can be started |
| IsDefault | body | boolean | No | It's the default patching window for new resource groups |
| Name | Value | |
|---|---|---|
| First | 1 | |
| Second | 2 | |
| Third | 3 | |
| Fourth | 4 |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Id | form | Guid | No | |
| Name | form | string | Yes | |
| DayOfWeek | form | DayOfWeek | No | |
| MonthlyOccurence | form | MonthlyDayOccurence | No | |
| TimeOfDay | form | TimeOnly | No | |
| Duration | form | TimeSpan | No | |
| IsDefault | form | bool | No |
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
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}