Azure / Azure/azure-rest-api-specs
[BUG]The description values of `AdvancedScheduleMonthlyOccurrence` are inconsistent with Azure Portal
- Dominant language
- TypeSpec
- Stars
- 3.1k
- Forks
- 5.9k
- Avg merge
- 2d 22h
- Merged PRs (30d)
- 444
Description
### API Spec link
https://github.com/Azure/azure-rest-api-specs/blob/20d333fa60a4a81acfd01a7bd56dd9c552301afe/specification/automation/resource-manager/Microsoft.Automation/stable/2019-06-01/softwareUpdateConfiguration.json#L644C6-L644C39
### API Spec version
2019-06-01
### Describe the bug
It was found that the possible values of [AdvancedScheduleMonthlyOccurrence ](https://github.com/Azure/azure-rest-api-specs/blob/20d333fa60a4a81acfd01a7bd56dd9c552301afe/specification/automation/resource-manager/Microsoft.Automation/stable/2019-06-01/softwareUpdateConfiguration.json#L644C6-L644C39)should be 1, 2,3,4,-1 ,corresponds to "First", "Second", "Third", "Fourth" and "Last" in the Azure Portal respectively. Details are as follows.

However, the description of `AdvancedScheduleMonthlyOccurrence` in swagger is "Occurrence of the week within the month. Must be between 1 and 5".
### Expected behavior
The possible values of `AdvancedScheduleMonthlyOccurrence` should be 1, 2,3,4,-1.
### Actual behavior
The description values of `AdvancedScheduleMonthlyOccurrence` between 1 and 5.
### Reproduction Steps
Create corresponding resources in the portal and view the values.
### Environment
_No response_
Contributor guide
Research direction
Open the stable/2019-06-01/softwareUpdateConfiguration.json specification at the referenced AdvancedScheduleMonthlyOccurrence definition. Compare its description with the Azure Portal values and update the documented occurrence values; done means the specification describes 1, 2, 3, 4, and -1 consistently with the portal.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- openapi
- Domain
- api
- Issue type
- Bug
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Stale
- Clarity
- Clearly specified
- Newbie friendliness
- 45/100