Azure / Azure/azure-rest-api-specs
`maintenance` - Wrong Enum Value of `rebootSetting`
- Dominant language
- TypeSpec
- Stars
- 3.1k
- Forks
- 5.9k
- Avg merge
- 2d 22h
- Merged PRs (30d)
- 444
Description
When specifying `rebootSetting` to `Never` as shown in the swagger below, service returned it as `NeverReboot`
https://github.com/Azure/azure-rest-api-specs/blob/8335066d60a43a53d23eb483bc283c8c4a1c730d/specification/maintenance/resource-manager/Microsoft.Maintenance/preview/2022-11-01-preview/Maintenance.json#L2106-L2112
```
PUT https://management.azure.com/subscriptions/***/resourceGroups/***/providers/Microsoft.Maintenance/maintenanceConfigurations/***?api-version=2022-11-01-preview
{
"location": "eastus",
"properties": {
"namespace": "Microsoft.Maintenance",
"extensionProperties": {
"InGuestPatchMode": "User"
},
"maintenanceScope": "InGuestPatch",
"maintenanceWindow": {
"startDateTime": "5555-12-31 00:00",
"expirationDateTime": "6666-12-31 00:00",
"duration": "02:00",
"timeZone": "Pacific Standard Time",
"recurEvery": "2Days"
},
"visibility": "Custom",
"installPatches": {
"rebootSetting": "Never",
"windowsParameters": {
"kbNumbersToExclude": [],
"kbNumbersToInclude": [],
"classificationsToInclude": [
"Critical",
"Security"
]
},
"linuxParameters": {
"classificationsToInclude": [
"Critical",
"Security"
]
}
},
"configurationType": "Regular"
}
}
GET https://management.azure.com/subscriptions/***/resourceGroups/***/providers/Microsoft.Maintenance/maintenanceConfigurations/***?api-version=2022-11-01-preview
Response:
{
...
"properties": {
...
"installPatches": {
...
"rebootSetting": "NeverReboot"
},
}
}
```
Contributor guide
Research direction
Start with specification/maintenance/resource-manager/Microsoft.Maintenance/preview/2022-11-01-preview/Maintenance.json around the rebootSetting definition linked in the issue. Compare the documented enum with the PUT and GET examples to determine the expected contract, then check nearby maintenance specifications for consistent naming. Done means the specification accurately reflects the service's rebootSetting value and its validation succeeds.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- openapi
- Domain
- api
- Issue type
- Bug
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100