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

Remove mongoCluster swagger spec and examples for 2024-05-15-preview … #28693

Conversation

olivertowers
Copy link
Member

@olivertowers olivertowers commented Apr 15, 2024

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.

Note

As of January 2024 there is no PR assignee. This is expected. See https://aka.ms/azsdk/pr-arm-review.

PR review workflow diagram

Please understand this diagram before proceeding. It explains how to get your PR approved & merged.

diagram

Click here to see the details of Step 1, Breaking Changes review

If you are in purview of Step 1 of the diagram, follow the Breaking Changes review process.
IMPORTANT! This applies even if you believe your PR was mislabeled, for any reason, including tool failure.

Click here to see the details of Step 2, ARM review

See https://aka.ms/azsdk/pr-arm-review.

Click here to see the diagram footnotes

Diagram footnotes

[1] See ARM review queue (for PR merge queues, see [2]).
[2] public repo merge queue, private repo merge queue (for ARM review queue, [1])
The ARM reviewer on-call engineer visits the merge queue twice a day, so the approximate ETA for merges is 12 - 24 hours.

Purpose of this PR

What's the purpose of this PR? Check the specific option that applies. This is mandatory!

  • New resource provider.
  • New API version for an existing resource provider. (If API spec is not defined in TypeSpec, the PR should have been generated using OpenAPI Hub).
  • 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 OpenAPI spec 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:

  • I confirm this PR is modifying Azure Resource Manager (ARM) related specifications, and not data plane related specifications.
  • I have reviewed following Resource Provider guidelines, including
    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

  • First, please carefully read through this PR description, from top to bottom. Please fill out the Purpose of this PR and Due diligence checklist.
  • To understand what you must do next to merge this PR, see the 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.
  • For guidance on fixing this PR CI check failures, see the hyperlinks provided in given failure
    and https://aka.ms/ci-fix.
  • For help with PR workflow diagram Step 2 (ARM review), see https://aka.ms/azsdk/pr-arm-review.
  • If the PR CI checks appear to be stuck in 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.
  • If the help provided by the previous points is not enough, post to https://aka.ms/azsdk/support/specreview-channel and link to this PR.

Copy link

openapi-pipeline-app bot commented Apr 15, 2024

Next Steps to Merge

✅ All automated merging requirements have been met! To get your PR merged, see aka.ms/azsdk/specreview/merge.

Copy link

openapi-pipeline-app bot commented Apr 15, 2024

Swagger Validation Report

️️✔️BreakingChange succeeded [Detail] [Expand]
There are no breaking changes.
️️✔️Breaking Change(Cross-Version) succeeded [Detail] [Expand]
There are no breaking changes.
️️✔️LintDiff succeeded [Detail] [Expand]
Validation passes for LintDiff.
Compared specs (v2.2.0) new version base version
default default(56e2534) default(release-cosmos-db-Microsoft.DocumentDB-2024-05-15-preview)
️❌Avocado: 7 Errors, 0 Warnings failed [Detail]
Rule Message
MISSING_APIS_IN_DEFAULT_TAG The default tag should contain all APIs. The API path /subscriptions/{}/providers/Microsoft.DocumentDB/mongoClusters is not in the default tag. Please make sure the missing API swaggers are in the default tag.
readme: specification/cosmos-db/resource-manager/readme.md
json: Microsoft.DocumentDB/preview/2024-02-15-preview/mongoCluster.json
MISSING_APIS_IN_DEFAULT_TAG The default tag should contain all APIs. The API path /subscriptions/{}/resourceGroups/{}/providers/Microsoft.DocumentDB/mongoClusters is not in the default tag. Please make sure the missing API swaggers are in the default tag.
readme: specification/cosmos-db/resource-manager/readme.md
json: Microsoft.DocumentDB/preview/2024-02-15-preview/mongoCluster.json
MISSING_APIS_IN_DEFAULT_TAG The default tag should contain all APIs. The API path /subscriptions/{}/resourceGroups/{}/providers/Microsoft.DocumentDB/mongoClusters/{} is not in the default tag. Please make sure the missing API swaggers are in the default tag.
readme: specification/cosmos-db/resource-manager/readme.md
json: Microsoft.DocumentDB/preview/2024-02-15-preview/mongoCluster.json
MISSING_APIS_IN_DEFAULT_TAG The default tag should contain all APIs. The API path /subscriptions/{}/resourceGroups/{}/providers/Microsoft.DocumentDB/mongoClusters/{}/firewallRules/{} is not in the default tag. Please make sure the missing API swaggers are in the default tag.
readme: specification/cosmos-db/resource-manager/readme.md
json: Microsoft.DocumentDB/preview/2024-02-15-preview/mongoCluster.json
MISSING_APIS_IN_DEFAULT_TAG The default tag should contain all APIs. The API path /subscriptions/{}/resourceGroups/{}/providers/Microsoft.DocumentDB/mongoClusters/{}/firewallRules is not in the default tag. Please make sure the missing API swaggers are in the default tag.
readme: specification/cosmos-db/resource-manager/readme.md
json: Microsoft.DocumentDB/preview/2024-02-15-preview/mongoCluster.json
MISSING_APIS_IN_DEFAULT_TAG The default tag should contain all APIs. The API path /subscriptions/{}/providers/Microsoft.DocumentDB/locations/{}/checkMongoClusterNameAvailability is not in the default tag. Please make sure the missing API swaggers are in the default tag.
readme: specification/cosmos-db/resource-manager/readme.md
json: Microsoft.DocumentDB/preview/2024-02-15-preview/mongoCluster.json
MISSING_APIS_IN_DEFAULT_TAG The default tag should contain all APIs. The API path /subscriptions/{}/resourceGroups/{}/providers/Microsoft.DocumentDB/mongoClusters/{}/listConnectionStrings is not in the default tag. Please make sure the missing API swaggers are in the default tag.
readme: specification/cosmos-db/resource-manager/readme.md
json: Microsoft.DocumentDB/preview/2024-02-15-preview/mongoCluster.json
️️✔️SwaggerAPIView succeeded [Detail] [Expand]
️️✔️TypeSpecAPIView succeeded [Detail] [Expand]
️️✔️ModelValidation succeeded [Detail] [Expand]
Validation passes for ModelValidation.
️️✔️SemanticValidation succeeded [Detail] [Expand]
Validation passes for SemanticValidation.
️️✔️SpellCheck succeeded [Detail] [Expand]
Validation passes for SpellCheck.
️️✔️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?

Copy link

openapi-pipeline-app bot commented Apr 15, 2024

Swagger Generation Artifacts

️️✔️ApiDocPreview succeeded [Detail] [Expand]
️⚠️ azure-sdk-for-python warning [Detail]
  • ⚠️Warning in generating from c563e9c4cc60efd58d359a70bc7953be584f1120. SDK Automation 14.0.0
    command	sh scripts/automation_init.sh ../azure-sdk-for-python_tmp/initInput.json ../azure-sdk-for-python_tmp/initOutput.json
    cmderr	[automation_init.sh] WARNING: Skipping azure-nspkg as it is not installed.
    command	sh scripts/automation_generate.sh ../azure-sdk-for-python_tmp/generateInput.json ../azure-sdk-for-python_tmp/generateOutput.json
    cmderr	[automation_generate.sh] npm notice
    cmderr	[automation_generate.sh]  New patch version of npm available! 10.5.0 -> 10.5.2
    cmderr	[automation_generate.sh] npm notice Changelog: <https://github.com/npm/cli/releases/tag/v10.5.2>
    cmderr	[automation_generate.sh] npm notice Run `npm install -g [email protected]` to update!
    cmderr	[automation_generate.sh] npm notice
  • ️✔️azure-mgmt-cosmosdb [Preview SDK Changes]
    • azure_mgmt_cosmosdb-0.7.0-py3-none-any.whl
    • azure-mgmt-cosmosdb-0.7.0.zip
️️✔️ azure-sdk-for-net-track2 succeeded [Detail] [Expand]
  • ️✔️Succeeded in generating from c563e9c4cc60efd58d359a70bc7953be584f1120. SDK Automation 14.0.0
    command	pwsh ./eng/scripts/Automation-Sdk-Init.ps1 ../azure-sdk-for-net_tmp/initInput.json ../azure-sdk-for-net_tmp/initOutput.json
    command	pwsh ./eng/scripts/Invoke-GenerateAndBuildV2.ps1 ../azure-sdk-for-net_tmp/generateInput.json ../azure-sdk-for-net_tmp/generateOutput.json
  • ️✔️Azure.ResourceManager.CosmosDB [Preview SDK Changes]
    • Azure.ResourceManager.CosmosDB.1.4.0-alpha.20240415.1.nupkg
    info	[Changelog]
️⚠️ azure-sdk-for-java warning [Detail]
  • ⚠️Warning in generating from c563e9c4cc60efd58d359a70bc7953be584f1120. SDK Automation 14.0.0
    command	./eng/mgmt/automation/init.sh ../azure-sdk-for-java_tmp/initInput.json ../azure-sdk-for-java_tmp/initOutput.json
    cmderr	[init.sh] [notice] A new release of pip is available: 23.0.1 -> 24.0
    cmderr	[init.sh] [notice] To update, run: pip install --upgrade pip
    cmderr	[init.sh] [notice] A new release of pip is available: 23.0.1 -> 24.0
    cmderr	[init.sh] [notice] To update, run: pip install --upgrade pip
    command	./eng/mgmt/automation/generate.py ../azure-sdk-for-java_tmp/generateInput.json ../azure-sdk-for-java_tmp/generateOutput.json
  • ️✔️azure-resourcemanager-cosmos-generated [Preview SDK Changes]
    • pom.xml
    • azure-resourcemanager-cosmos-generated-1.0.0-beta.1.jar
    • azure-resourcemanager-cosmos-generated-1.0.0-beta.1-sources.jar
️️✔️ azure-sdk-for-go succeeded [Detail] [Expand]
  • ️✔️Succeeded in generating from c563e9c4cc60efd58d359a70bc7953be584f1120. SDK Automation 14.0.0
    command	sh ./eng/scripts/automation_init.sh ../../../../../azure-sdk-for-go_tmp/initInput.json ../../../../../azure-sdk-for-go_tmp/initOutput.json
    command	generator automation-v2 ../../../../../azure-sdk-for-go_tmp/generateInput.json ../../../../../azure-sdk-for-go_tmp/generateOutput.json
  • ️✔️sdk/resourcemanager/cosmos/armcosmos [Preview SDK Changes]
️️✔️ azure-sdk-for-js succeeded [Detail] [Expand]
  • ️✔️Succeeded in generating from c563e9c4cc60efd58d359a70bc7953be584f1120. SDK Automation 14.0.0
    command	sh .scripts/automation_init.sh ../azure-sdk-for-js_tmp/initInput.json ../azure-sdk-for-js_tmp/initOutput.json
    warn	File azure-sdk-for-js_tmp/initOutput.json not found to read
    command	sh .scripts/automation_generate.sh ../azure-sdk-for-js_tmp/generateInput.json ../azure-sdk-for-js_tmp/generateOutput.json
  • ️✔️@azure/arm-cosmosdb [Preview SDK Changes]
    • azure-arm-cosmosdb-16.0.0-beta.8.tgz
️⚠️ azure-resource-manager-schemas warning [Detail]
  • ⚠️Warning in generating from c563e9c4cc60efd58d359a70bc7953be584f1120. Schema Automation 14.0.0
    command	.sdkauto/initScript.sh ../azure-resource-manager-schemas_tmp/initInput.json ../azure-resource-manager-schemas_tmp/initOutput.json
    cmderr	[initScript.sh] notice
    cmderr	[initScript.sh] npm notice New patch version of npm available! 10.5.0 -> 10.5.2
    cmderr	[initScript.sh] npm notice Changelog: <https://github.com/npm/cli/releases/tag/v10.5.2>
    cmderr	[initScript.sh] npm notice Run `npm install -g [email protected]` to update!
    cmderr	[initScript.sh] npm notice
    warn	File azure-resource-manager-schemas_tmp/initOutput.json not found to read
    command	.sdkauto/generateScript.sh ../azure-resource-manager-schemas_tmp/generateInput.json ../azure-resource-manager-schemas_tmp/generateOutput.json
  • ️✔️cosmos-db [Preview Schema Changes]
️⚠️ azure-powershell warning [Detail]
  • ⚠️Warning in generating from c563e9c4cc60efd58d359a70bc7953be584f1120. SDK Automation 14.0.0
    command	sh ./tools/SwaggerCI/init.sh ../azure-powershell_tmp/initInput.json ../azure-powershell_tmp/initOutput.json
    command	pwsh ./tools/SwaggerCI/psci.ps1 ../azure-powershell_tmp/generateInput.json ../azure-powershell_tmp/generateOutput.json
  • ⚠️Az.cosmos-db.DefaultTag [Preview SDK Changes]
Posted by Swagger Pipeline | How to fix these errors?

@olivertowers
Copy link
Member Author

Swagger Advocado errors are for MISSING_APIS_IN_DEFAULT_TAG. Per the description, this validation will fail if an API spec if being removed intentionally which it is in this case.

Per Breaking Change policy we do not need to follow the review workflow

  • The API spec that is being removed from cosmos-db is preview-only/was never added to a stable version.
  • We intend on releasing future versions of this API under a different service spec folder mongoCluster, which is pending on finalizing the SDK namespace (expected to complete by 4/19).

@olivertowers olivertowers removed the DoNotMerge <valid label in PR review process> use to hold merge after approval label Apr 15, 2024
@pjohari-ms
Copy link
Member

Agreed with what Oliver said. We're removing these APIs from the preview version of CosmosDB API set. These APIs are being removed as they will be exposed in their own RP.
Waiting on a swagger reviewer to provide ARMSignOff before merging this PR.

@raosuhas raosuhas added the ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review label Apr 19, 2024
@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 Apr 19, 2024
@olivertowers
Copy link
Member Author

olivertowers commented Apr 22, 2024

/pr RequestMerge

@olivertowers olivertowers merged commit 7333955 into release-cosmos-db-Microsoft.DocumentDB-2024-05-15-preview Apr 22, 2024
28 of 29 checks passed
@olivertowers olivertowers deleted the mongocluster-remove-2024-05-15-preview branch April 22, 2024 14:38
razvanbadea-msft pushed a commit that referenced this pull request May 22, 2024
#29192)

* Copy files from preview/2024-02-15-preview

Copied the files in a separate commit.
This allows reviewers to easily diff subsequent changes against the previous spec.

* Update version to preview/2024-05-15-preview

Updated the API version from preview/2024-02-15-preview to preview/2024-05-15-preview.

* Added tag for 2024-05-15-preview in readme file

* Add mongo v5 and v6 to the preview swagger (#28472)

Co-authored-by: Andrew Khoma <[email protected]>

* swagger changes for capacityMode changes (#28457)

* swagger changes for capacityMode changes

* Ran the npx Prettier command

* fixing swagger lint

* fixing camelcase issue

* NSP RP changes for public preview (#28552)

* NSP RP API changes

* small change

* validation failures handling

* linter errors

* types version

* still failing

* Probably all the fixes

* Missed one file

* Will revert this commit - temp fix for hanging push

* Reverted commit

---------

Co-authored-by: pjohari-ms <[email protected]>

* Remove mongoCluster swagger spec and examples for 2024-05-15-preview release (#28693)

* Porting from stable changes from Cassandra API (#28801)

* nsp related comments (#28950)

* Review comments - Cassandra and circular reference (#29021)

* Review comments - Cassandra and circular reference

* Nits - Services.json

* Porting from stable brranch

* Nits

* Moved files

* Using common types

* Fixes

* Used custom parameter - as suggested by reviewer

* Merged commit correctly

* Another merge remove issue

* Prettier issues due to line endings being different during merge

* Prettier check. Whole folder.

---------

Co-authored-by: Andrew Khoma <[email protected]>
Co-authored-by: Andrew Khoma <[email protected]>
Co-authored-by: chandrasekhar gunturi <[email protected]>
Co-authored-by: Vandit Jain <[email protected]>
Co-authored-by: Oliver Towers <[email protected]>
Francisco-Gamino pushed a commit to Francisco-Gamino/azure-rest-api-specs that referenced this pull request Jun 5, 2024
Azure#29192)

* Copy files from preview/2024-02-15-preview

Copied the files in a separate commit.
This allows reviewers to easily diff subsequent changes against the previous spec.

* Update version to preview/2024-05-15-preview

Updated the API version from preview/2024-02-15-preview to preview/2024-05-15-preview.

* Added tag for 2024-05-15-preview in readme file

* Add mongo v5 and v6 to the preview swagger (Azure#28472)

Co-authored-by: Andrew Khoma <[email protected]>

* swagger changes for capacityMode changes (Azure#28457)

* swagger changes for capacityMode changes

* Ran the npx Prettier command

* fixing swagger lint

* fixing camelcase issue

* NSP RP changes for public preview (Azure#28552)

* NSP RP API changes

* small change

* validation failures handling

* linter errors

* types version

* still failing

* Probably all the fixes

* Missed one file

* Will revert this commit - temp fix for hanging push

* Reverted commit

---------

Co-authored-by: pjohari-ms <[email protected]>

* Remove mongoCluster swagger spec and examples for 2024-05-15-preview release (Azure#28693)

* Porting from stable changes from Cassandra API (Azure#28801)

* nsp related comments (Azure#28950)

* Review comments - Cassandra and circular reference (Azure#29021)

* Review comments - Cassandra and circular reference

* Nits - Services.json

* Porting from stable brranch

* Nits

* Moved files

* Using common types

* Fixes

* Used custom parameter - as suggested by reviewer

* Merged commit correctly

* Another merge remove issue

* Prettier issues due to line endings being different during merge

* Prettier check. Whole folder.

---------

Co-authored-by: Andrew Khoma <[email protected]>
Co-authored-by: Andrew Khoma <[email protected]>
Co-authored-by: chandrasekhar gunturi <[email protected]>
Co-authored-by: Vandit Jain <[email protected]>
Co-authored-by: Oliver Towers <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
ARMReview ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review resource-manager
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants