Azure / Azure/azure-rest-api-specs

[BUG]The description values of `AdvancedScheduleMonthlyOccurrence` are inconsistent with Azure Portal

Open
#28,901 0 comments 0 reactions 0 assignees View on GitHub
Automation bug customer-reported Mgmt question Service Attention
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.
![image](https://github.com/Azure/azure-rest-api-specs/assets/39109137/db8d0de8-cf02-430f-a17d-a9590b67fac0)

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

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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.