-
Notifications
You must be signed in to change notification settings - Fork 4.9k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Updated Post APIs OperationId #29183
Conversation
Next Steps to Merge✅ All automated merging requirements have been met! To get your PR merged, see aka.ms/azsdk/specreview/merge. |
Swagger Validation Report
|
Compared specs (v0.10.8) | new version | base version |
---|---|---|
help.json | 2024-03-01-preview(c4dd5a4) | 2024-03-01-preview(main) |
Rule | Message |
---|---|
1008 - ModifiedOperationId |
The operation id has been changed from 'CheckNameAvailability_Post' to 'CheckNameAvailability_CheckAvailability'. This will impact generated code. New: Microsoft.Help/preview/2024-03-01-preview/help.json#L75:7 Old: Microsoft.Help/preview/2024-03-01-preview/help.json#L75:7 |
1008 - ModifiedOperationId |
The operation id has been changed from 'DiscoverySolutionNLPTenantScope_Post' to 'DiscoverySolutionNLP_DiscoverSolutions'. This will impact generated code. New: Microsoft.Help/preview/2024-03-01-preview/help.json#L815:7 Old: Microsoft.Help/preview/2024-03-01-preview/help.json#L815:7 |
1008 - ModifiedOperationId |
The operation id has been changed from 'DiscoverySolutionNLPSubscriptionScope_Post' to 'DiscoverySolutionNLP_DiscoverSolutionsBySubscription'. This will impact generated code. New: Microsoft.Help/preview/2024-03-01-preview/help.json#L856:7 Old: Microsoft.Help/preview/2024-03-01-preview/help.json#L856:7 |
️️✔️
Breaking Change(Cross-Version) succeeded [Detail] [Expand]
There are no breaking changes.
️️✔️
CredScan succeeded [Detail] [Expand]
There is no credential detected.
️⚠️
LintDiff: 1 Warnings warning [Detail]
Compared specs (v2.2.2) | new version | base version |
---|---|---|
package-2024-03-01-preview | package-2024-03-01-preview(c4dd5a4) | package-2024-03-01-preview(main) |
[must fix]The following errors/warnings are introduced by current PR:
Rule | Message | Related RPC [For API reviewers] |
---|---|---|
OperationId should contain the verb: 'checknameavailability' in:'CheckNameAvailability_CheckAvailability'. Consider updating the operationId Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L80 |
The following errors/warnings exist before current PR submission:
Only 30 items are listed, please refer to log for more details.
Rule | Message |
---|---|
XMSLongRunningOperationProperty |
If an operation's (PUT/POST/PATCH/DELETE) responses have Location or Azure-AsyncOperation headers then it MUST have the property x-ms-long-running-operation set to true Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L674 |
XMSLongRunningOperationProperty |
If an operation's (PUT/POST/PATCH/DELETE) responses have Location or Azure-AsyncOperation headers then it MUST have the property x-ms-long-running-operation set to true Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L715 |
XMSLongRunningOperationProperty |
If an operation's (PUT/POST/PATCH/DELETE) responses have Location or Azure-AsyncOperation headers then it MUST have the property x-ms-long-running-operation set to true Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L756 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L927 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L941 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L941 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L957 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L967 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L1259 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L1270 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L1288 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L1308 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L1739 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L1739 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L1753 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L1765 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L1955 |
AvoidAdditionalProperties |
Definitions must not have properties named additionalProperties except for user defined tags or predefined references. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L1969 |
Do not have duplicate name of x-ms-example, make sure every x-ms-example name unique. Duplicate x-ms-example: Solution_Create Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L466 |
|
Do not have duplicate name of x-ms-example, make sure every x-ms-example name unique. Duplicate x-ms-example: Solution_Get Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L503 |
|
Do not have duplicate name of x-ms-example, make sure every x-ms-example name unique. Duplicate x-ms-example: Solution_Get Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L807 |
|
Since operation response has model definition in array type, it should be of the form '_list'. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L815 |
|
Since operation response has model definition in array type, it should be of the form '_list'. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L856 |
|
Do not have duplicate name of x-ms-example, make sure every x-ms-example name unique. Duplicate x-ms-example: Discovery Solutions using issue summary and service id. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L892 |
|
Booleans properties are not descriptive in all cases and can make them to use, evaluate whether is makes sense to keep the property as boolean or turn it into an enum. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L905 |
|
The resource DiagnosticResource does not have a corresponding delete operation. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L936 |
|
The resource SolutionResource does not have a corresponding delete operation. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L1278 |
|
The resource SimplifiedSolutionsResource does not have a corresponding delete operation. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L1729 |
|
The resource TroubleshooterResource does not have a corresponding delete operation. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L1945 |
|
Booleans properties are not descriptive in all cases and can make them to use, evaluate whether is makes sense to keep the property as boolean or turn it into an enum. Location: Microsoft.Help/preview/2024-03-01-preview/help.json#L2080 |
️️✔️
Avocado succeeded [Detail] [Expand]
Validation passes for Avocado.
️️✔️
SwaggerAPIView succeeded [Detail] [Expand]
️️✔️
TypeSpecAPIView succeeded [Detail] [Expand]
️️✔️
ModelValidation succeeded [Detail] [Expand]
Validation passes for ModelValidation.
️️✔️
SemanticValidation succeeded [Detail] [Expand]
Validation passes for SemanticValidation.
️️✔️
PoliCheck succeeded [Detail] [Expand]
Validation passed for PoliCheck.
️️✔️
SpellCheck succeeded [Detail] [Expand]
Validation passes for SpellCheck.
️️✔️
Lint(RPaaS) succeeded [Detail] [Expand]
Validation passes for Lint(RPaaS).
️️✔️
PR Summary succeeded [Detail] [Expand]
Validation passes for Summary.
️️✔️
Automated merging requirements met succeeded [Detail] [Expand]
Swagger Generation Artifacts
|
Generated ApiView
|
@@ -77,7 +77,7 @@ | |||
"checkNameAvailability" | |||
], | |||
"description": "This API is used to check the uniqueness of a resource name used for a diagnostic, troubleshooter or solutions", | |||
"operationId": "CheckNameAvailability_Post", | |||
"operationId": "CheckNameAvailability_CheckAvailability", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
In stable it is Diagnostics_CheckNameAvailability
https://github.com/Azure/azure-rest-api-specs/blob/main/specification/help/resource-manager/Microsoft.Help/stable/2023-06-01/help.json#L80
SDK may have to do directive to rename it back, if this appear in next stable. #Resolved
@@ -858,7 +858,7 @@ | |||
"discoverSolutions" | |||
], | |||
"description": "Search for relevant Azure Diagnostics, Solutions and Troubleshooters using a natural language issue summary and subscription.", | |||
"operationId": "DiscoverySolutionNLPSubscriptionScope_Post", | |||
"operationId": "DiscoverySolutionNLPSubscriptionScope_DiscoverSolutions", |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The 2 DiscoverSolutions APIs (I assume they diff only on scope -- tenant vs. subscription?) may better be in same operation group, and diff by name, e.g. DiscoverSolutions
and DiscoverSolutionsBySubscription
#Resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Added this suggestion
/pr RequestMerge |
ARM (Control Plane) API Specification Update Pull Request
Tip
Overwhelmed by all this guidance? See the
Getting help
section at the bottom of this PR description.PR review workflow diagram
Please understand this diagram before proceeding. It explains how to get your PR approved & merged.
Purpose of this PR
What's the purpose of this PR? Check the specific option that applies. This is mandatory!
Due diligence checklist
To merge this PR, you must go through the following checklist and confirm you understood
and followed the instructions by checking all the boxes:
ARM resource provider contract and
REST guidelines (estimated time: 4 hours).
I understand this is required before I can proceed to the diagram Step 2, "ARM API changes review", for this PR.
Additional information
Viewing API changes
For convenient view of the API changes made by this PR, refer to the URLs provided in the table
in the
Generated ApiView
comment added to this PR. You can use ApiView to show API versions diff.Suppressing failures
If one or multiple validation error/warning suppression(s) is detected in your PR, please follow the
suppressions guide to get approval.
Getting help
Purpose of this PR
andDue diligence checklist
.Next Steps to Merge
comment. It will appear within few minutes of submitting this PR and will continue to be up-to-date with current PR state.and https://aka.ms/ci-fix.
queued
state, please add a comment with contents/azp run
.This should result in a new comment denoting a
PR validation pipeline
has started and the checks should be updated after few minutes.