Skip to content
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

[Hub Generated] Review request for Microsoft.Security to add version stable/2024-01-01 #24625

Merged
merged 71 commits into from
Dec 13, 2023

Conversation

bamus1166
Copy link
Contributor

@bamus1166 bamus1166 commented Jun 28, 2023

This is a PR generated at OpenAPI Hub. You can view your work branch via this link.

ARM (Control Plane) API Specification Update Pull Request

Purpose of this PR

What's the purpose of this PR? Check all that apply. This is mandatory!

  • New API version. (Such PR should have been generated with OpenAPI Hub, per this wiki doc.)
  • Update existing version for a new feature. (This is applicable only when you are revising a private preview API version.)
  • Update existing version to fix swagger quality issues in S360.
  • Other, please clarify:
    • edit this with your clarification

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 API changes review

  • If you want for the ARM team to review this PR, you must add the ARMReview label.
  • The automation may automatically add the ARMReview label, if appropriate.
    If this happens, proceed according to guidance given in GitHub comments also added by the automation.

Breaking change review

If you have any breaking changes as defined in the Breaking Change Policy,
follow the process outlined in the High-level Breaking Change Process doc.

Getting help

@openapi-pipeline-app
Copy link

openapi-pipeline-app bot commented Jun 28, 2023

Swagger Validation Report

️️✔️BreakingChange succeeded [Detail] [Expand]
There are no breaking changes.
compared swaggers (via Oad v0.10.4)] new version base version
types.json 1.0(3d1d070) 1.0(main)
️❌Breaking Change(Cross-Version): 3 Errors, 7 Warnings failed [Detail]
compared swaggers (via Oad v0.10.4)] new version base version
pricings.json 2024-01-01(3d1d070) 2023-01-01(main)
pricings.json 2024-01-01(3d1d070) 2017-08-01-preview(main)

The following breaking changes are detected by comparison with the latest stable version:

Rule Message
1005 - RemovedPath The new version is missing a path that was found in the old version. Was path '/subscriptions/{subscriptionId}/providers/Microsoft.Security/pricings' removed or restructured?
Old: Microsoft.Security/stable/2023-01-01/pricings.json#L37:5
1005 - RemovedPath The new version is missing a path that was found in the old version. Was path '/subscriptions/{subscriptionId}/providers/Microsoft.Security/pricings/{pricingName}' removed or restructured?
Old: Microsoft.Security/stable/2023-01-01/pricings.json#L73:5
1007 - RemovedClientParameter The new version is missing a client parameter that was found in the old version. Was 'SubscriptionId' removed or renamed?
New: Microsoft.Security/stable/2024-01-01/pricings.json#L488:3
Old: Microsoft.Security/stable/2023-01-01/pricings.json#L348:3


The following breaking changes are detected by comparison with the latest preview version:

Rule Message
⚠️ 1005 - RemovedPath The new version is missing a path that was found in the old version. Was path '/subscriptions/{subscriptionId}/providers/Microsoft.Security/pricings' removed or restructured?
Old: Microsoft.Security/preview/2017-08-01-preview/pricings.json#L37:5
⚠️ 1005 - RemovedPath The new version is missing a path that was found in the old version. Was path '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/pricings' removed or restructured?
Old: Microsoft.Security/preview/2017-08-01-preview/pricings.json#L76:5
⚠️ 1005 - RemovedPath The new version is missing a path that was found in the old version. Was path '/subscriptions/{subscriptionId}/providers/Microsoft.Security/pricings/{pricingName}' removed or restructured?
Old: Microsoft.Security/preview/2017-08-01-preview/pricings.json#L118:5
⚠️ 1005 - RemovedPath The new version is missing a path that was found in the old version. Was path '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/pricings/{pricingName}' removed or restructured?
Old: Microsoft.Security/preview/2017-08-01-preview/pricings.json#L197:5
⚠️ 1007 - RemovedClientParameter The new version is missing a client parameter that was found in the old version. Was 'ResourceGroupName' removed or renamed?
New: Microsoft.Security/stable/2024-01-01/pricings.json#L488:3
Old: Microsoft.Security/preview/2017-08-01-preview/pricings.json#L352:3
⚠️ 1007 - RemovedClientParameter The new version is missing a client parameter that was found in the old version. Was 'SubscriptionId' removed or renamed?
New: Microsoft.Security/stable/2024-01-01/pricings.json#L488:3
Old: Microsoft.Security/preview/2017-08-01-preview/pricings.json#L352:3
⚠️ 1033 - RemovedProperty The new version is missing a property found in the old version. Was 'nextLink' renamed or removed?
New: Microsoft.Security/stable/2024-01-01/pricings.json#L236:7
Old: Microsoft.Security/preview/2017-08-01-preview/pricings.json#L289:7
️️✔️CredScan succeeded [Detail] [Expand]
There is no credential detected.
️❌LintDiff: 4 Errors, 8 Warnings failed [Detail]
compared tags (via openapi-validator v2.1.6) new version base version
package-composite-v3 package-composite-v3(3d1d070) package-composite-v3(main)

[must fix]The following errors/warnings are introduced by current PR:

Rule Message Related RPC [For API reviewers]
ResourceNameRestriction The resource name parameter 'pricingName' should be defined with a 'pattern' restriction.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L37
RPC-Uri-V1-05
RequestBodyMustExistForPutPatch The put or patch operation does not have a request body defined. This is not allowed. Please specify a request body for this operation.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L110
RPC-Put-V1-28, RPC-Patch-V1-12
XmsPageableForListCalls x-ms-pageable extension must be specified for LIST APIs.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L184
RPC-Get-V1-13
GetCollectionOnlyHasValueAndNextLink Get endpoints for collections of resources must only have the value and nextLink properties in their model.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L215
⚠️ RequiredReadOnlySystemData The response of operation:'Pricings_Get' is defined without 'systemData'. Consider adding the systemData to the response.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L38
⚠️ ParameterNotDefinedInGlobalParameters Parameter 'api-version' is referenced but not defined in the global parameters section of Service Definition
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L64
⚠️ RequiredReadOnlySystemData The response of operation:'Pricings_Update' is defined without 'systemData'. Consider adding the systemData to the response.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L90
⚠️ PutInOperationName 'PUT' operation 'Pricings_Update' should use method name 'Create'. Note: If you have already shipped an SDK on top of this spec, fixing this warning may introduce a breaking change.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L109
⚠️ ParameterNotDefinedInGlobalParameters Parameter 'api-version' is referenced but not defined in the global parameters section of Service Definition
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L110
⚠️ ParameterNotDefinedInGlobalParameters Parameter 'api-version' is referenced but not defined in the global parameters section of Service Definition
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L156
⚠️ PageableOperation Based on the response model schema, operation 'Pricings_List' might be pageable. Consider adding the x-ms-pageable extension.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L184
⚠️ ParameterNotDefinedInGlobalParameters Parameter 'api-version' is referenced but not defined in the global parameters section of Service Definition
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L201


The following errors/warnings exist before current PR submission:

Rule Message
AvoidAdditionalProperties Definitions must not have properties named additionalProperties except for user defined tags or predefined references.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L240
PropertiesTypeObjectNoDefinition Properties with type:object that don't reference a model definition are not allowed. ARM doesn't allow generic type definitions as this leads to bad customer experience.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L240
AvoidAdditionalProperties Definitions must not have properties named additionalProperties except for user defined tags or predefined references.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L250
PropertiesTypeObjectNoDefinition Properties with type:object that don't reference a model definition are not allowed. ARM doesn't allow generic type definitions as this leads to bad customer experience.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L250
AvoidAdditionalProperties Definitions must not have properties named additionalProperties except for user defined tags or predefined references.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L384
PropertiesTypeObjectNoDefinition Properties with type:object that don't reference a model definition are not allowed. ARM doesn't allow generic type definitions as this leads to bad customer experience.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L384
AvoidAdditionalProperties Definitions must not have properties named additionalProperties except for user defined tags or predefined references.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L438
PropertiesTypeObjectNoDefinition Properties with type:object that don't reference a model definition are not allowed. ARM doesn't allow generic type definitions as this leads to bad customer experience.
Location: Microsoft.Security/stable/2024-01-01/pricings.json#L438
⚠️ EnumInsteadOfBoolean 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.Security/stable/2024-01-01/pricings.json#L390
️⚠️Avocado: 1 Warnings warning [Detail]
Rule Message
⚠️ MULTIPLE_API_VERSION The default tag contains multiple API versions swaggers.
readme: specification/security/resource-manager/readme.md
tag: specification/security/resource-manager/readme.md#tag-package-composite-v3
️❌SwaggerAPIView: 0 Errors, 0 Warnings failed [Detail]
️️✔️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]
Posted by Swagger Pipeline | How to fix these errors?

@openapi-workflow-bot
Copy link

Hi, @bamus1166 Thanks for your PR. I am workflow bot for review process. Here are some small tips.

  • Please ensure to do self-check against checklists in first PR comment.
  • PR assignee is the person auto-assigned and responsible for your current PR reviewing and merging.
  • For specs comparison cross API versions, Use API Specs Comparison Report Generator
  • If there is CI failure(s), to fix CI error(s) is mandatory for PR merging; or you need to provide justification in PR comment for explanation. How to fix?

  • Any feedback about review process or workflow bot, pls contact swagger and tools team. vscswagger@microsoft.com

    @openapi-pipeline-app
    Copy link

    openapi-pipeline-app bot commented Jun 28, 2023

    Swagger Generation Artifacts

    ️️✔️ApiDocPreview succeeded [Detail] [Expand]

    Only 0 items are rendered, please refer to log for more details.

    ️❌SDK Breaking Change Tracking failed [Detail]

    Only 0 items are rendered, please refer to log for more details.

    ️❌ azure-sdk-for-net-track2 failed [Detail]

    Only 0 items are rendered, please refer to log for more details.

    ️❌ azure-sdk-for-go failed [Detail]

    Only 0 items are rendered, please refer to log for more details.

    ️⚠️ azure-sdk-for-python-track2 warning [Detail]

    Only 0 items are rendered, please refer to log for more details.

    ️🔄 azure-sdk-for-js inProgress [Detail]
    ️⚠️ azure-sdk-for-java warning [Detail]

    Only 0 items are rendered, please refer to log for more details.

    ️❌ azure-resource-manager-schemas failed [Detail]

    Only 0 items are rendered, please refer to log for more details.

    ️❌ azure-powershell failed [Detail]

    Only 0 items are rendered, please refer to log for more details.

    Posted by Swagger Pipeline | How to fix these errors?

    @openapi-pipeline-app
    Copy link

    openapi-pipeline-app bot commented Jun 28, 2023

    PR validation pipeline restarted successfully. If there is ApiView generated, it will be updated in this comment.

    @bamus1166
    Copy link
    Contributor Author

    /azp run unifiedPipeline

    @azure-pipelines
    Copy link

    No pipelines are associated with this pull request.

    @bamus1166
    Copy link
    Contributor Author

    /azp run unifiedPipeline

    @azure-pipelines
    Copy link

    No pipelines are associated with this pull request.

    @bamus1166
    Copy link
    Contributor Author

    /azp run unifiedPipeline

    @azure-pipelines
    Copy link

    No pipelines are associated with this pull request.

    @bamus1166
    Copy link
    Contributor Author

    /azp run unifiedPipeline

    @azure-pipelines
    Copy link

    No pipelines are associated with this pull request.

    @bamus1166
    Copy link
    Contributor Author

    /azp run unifiedPipeline

    @azure-pipelines
    Copy link

    No pipelines are associated with this pull request.

    @AzureRestAPISpecReview AzureRestAPISpecReview added the BreakingChangeReviewRequired <valid label in PR review process>add this label when breaking change review is required label Jun 28, 2023
    @openapi-workflow-bot
    Copy link

    Hi @bamus1166! The automation detected breaking changes in this pull request. As a result, it added the BreakingChangeReviewRequired label.

    You cannot proceed with merging this PR until you complete one of the following action items:

    ACTION ITEM ALTERNATIVE A: Fix the breaking change.
    Please consult the documentation provided in the relevant validation failures.

    ACTION ITEM ALTERNATIVE B: Request approval.
    Alternatively, if you cannot fix the breaking changes, then you can request an approval for them. Please follow the process described in the High-level Breaking Change Process doc.

    ACTION ITEM ALTERNATIVE C: Report false positive.
    If you think there are no breaking changes, i.e. the validation should pass yet it fails, then please explain why in a PR comment and @ the PR assignee.

    @bamus1166 bamus1166 changed the title [Hub Generated] Review request for Microsoft.Security to add version preview/2023-08-01-preview [Hub Generated] Review request for Microsoft.Security to add version preview/2024-01-01 Dec 5, 2023
    @bamus1166 bamus1166 removed the ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review label Dec 5, 2023
    @AzureRestAPISpecReview AzureRestAPISpecReview added the WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required label Dec 6, 2023
    @bamus1166 bamus1166 changed the title [Hub Generated] Review request for Microsoft.Security to add version preview/2024-01-01 [Hub Generated] Review request for Microsoft.Security to add version stable/2024-01-01 Dec 6, 2023
    @visingla-ms
    Copy link
    Contributor

    /azp run

    Copy link

    Azure Pipelines successfully started running 3 pipeline(s).

    @visingla-ms visingla-ms added Approved-LintDiff ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review labels Dec 6, 2023
    @openapi-workflow-bot openapi-workflow-bot bot removed the WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required label Dec 6, 2023
    …into bamus1166-security-Microsoft.Security-2023-08-01-preview
    @ms-zhenhua
    Copy link
    Contributor

    ms-zhenhua commented Dec 12, 2023

    please fix errors in https://github.com/Azure/azure-rest-api-specs/pull/24625/checks?check_run_id=19520849172, then re-add the MergeRequested label. Thanks.

    @raych1
    Copy link
    Member

    raych1 commented Dec 13, 2023

    @lirenhe can you force merge this PR as the Go failure is a known issue in m4?

    @lirenhe lirenhe merged commit b52464f into main Dec 13, 2023
    23 of 30 checks passed
    @lirenhe lirenhe deleted the bamus1166-security-Microsoft.Security-2023-08-01-preview branch December 13, 2023 03:43
    @lirenhe
    Copy link
    Member

    lirenhe commented Dec 13, 2023

    OK, merged.

    arifibrahim4 pushed a commit that referenced this pull request Feb 26, 2024
    …stable/2024-01-01 (#24625)
    
    * Adds base for updating Microsoft.Security from version stable/2023-01-01 to version 2023-08-01-preview
    
    * Updates readme
    
    * Updates API version in new specs and examples
    
    * Granular Pricing 2023-08-01-preview first commit
    
    * ....
    
    * Fixed errors 1
    
    * fixed errors 2
    
    * ......
    
    * fixed errors 3
    
    * fixed errors 4
    
    * Fixed errors 5
    
    * ........
    
    * Fixed comments 1
    
    * .......
    
    * Fixing errors 7
    
    * ....................
    
    * .............
    
    * fixing errors 8
    
    * ..........
    
    * Fixed pr comments
    
    * ..........
    
    * ......
    
    * .........
    
    * .....
    
    * ..........
    
    * Fixed comments on PR
    
    * .........
    
    * updated enums and field names
    
    * fixed errors
    
    * Updated field names...
    
    * updated field names
    
    * .....
    
    * Added next token
    
    * updated descriptions
    
    * Aligned LIST API
    
    * ......
    
    * ....
    
    * removed list flag and added resourcesCoverageStatus
    
    * updated resourcesCoverageStatus description
    
    * .....
    
    * .................
    
    * .............
    
    * .....................
    
    * ...........
    
    * .........
    
    * ..........
    
    * ...............
    
    * fixing errors
    
    * ..........
    
    * Added suppressions
    
    * ............
    
    * ...........................
    
    * suppressing TopLevelResourcesListBySubscription
    
    * ...........
    
    * ..........
    
    * Updated Examples
    
    * fixed some text issues
    
    * Re-added ARC support
    
    * ...
    
    * ran prettifier
    
    * Moved the whole folder to stable/2024-01-01
    
    * Fixed file paths
    
    * Aligned examples
    
    * ...
    
    * ......
    
    * Fixed prittier issue
    
    * ...
    Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
    Labels
    Approved-Avocado Approved-BreakingChange DO NOT USE! OBSOLETE label. See https://github.com/Azure/azure-sdk-tools/issues/6374 Approved-LintDiff Approved-SdkBreakingChange-Go Approve the breaking change tracking for azure-sdk-for-go Approved-SdkBreakingChange-JavaScript Approved-SdkBreakingChange-Python Approved-Suppression ARMReview ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review BreakingChangeReviewRequired <valid label in PR review process>add this label when breaking change review is required CI-BreakingChange-Go CI-BreakingChange-JavaScript CI-FixRequiredOnFailure new-api-version resource-manager SuppressionReviewRequired
    Projects
    None yet
    Development

    Successfully merging this pull request may close these issues.