Azure / Azure/azure-rest-api-specs

`maintenance` - Wrong Enum Value of `rebootSetting`

Open
#22,872 14 comments 2 reactions 0 assignees View on GitHub
bug customer-reported Maintenance needs-team-attention Service Attention
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.