Regenerate DocumentDB extension for 2026-06-15-preview by amatarritamicrosoft · Pull Request #10353 · Azure/azure-cli-extensions

amatarritamicrosoft · 2026-09-17T06:39:38Z

🤖 PR Validation — ⚠️ Review suggested

Breaking Changes
⚠️ None

⚠️Azure CLI Extensions Breaking Change Test

⚠️documentdb

rule cmd_name rule_message suggest_message

⚠️ 1010 - ParaPropUpdate documentdb mongocluster replica promote cmd documentdb mongocluster replica promote update parameter promote_option: updated property choices from ['Forced'] to ['Forced', 'Planned']

Summary

regenerate the complete Azure DocumentDB command surface with 2026-06-15-preview
publish the extension as Beta 1.1.0b1 and mark all generated and custom commands as Preview
add planned replica promotion while preserving PATCH update behavior, identity list, confirmations, Microsoft Entra naming, source-cluster validation, payload shaping, and empty-response LRO handling
update playback recordings for the Preview API and current Key Vault management API

AAZ dependency

[DoNotMerge] Regenerate DocumentDB models for 2026-06-15-preview aaz#1093

Validation

AAZ command-model verification passed
Pylint and Flake8 passed
Azure CLI extension linter passed
extension index tests: 7 passed, 2 skipped
DocumentDB playback suite: 11 passed, including CMK, Forced promotion, and Planned promotion
wheel metadata verified as 1.1.0b1, Beta, and Preview
three independent reviews found no blocking issues

Use the 2026-06-15-preview API for replica promotion and cover Planned and Forced options independently. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 46bb57cf-0490-4f99-a750-27ca921e5d89

Move the complete command surface to 2026-06-15-preview, release 1.1.0b1 as Beta, and preserve the existing custom command behavior. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 46bb57cf-0490-4f99-a750-27ca921e5d89

azure-client-tools-bot-prd · 2026-09-17T06:39:42Z

Hi amatarritamicrosoft,
Please write the description of changes which can be perceived by customers into HISTORY.rst.
If you want to release a new extension version, please update the version in pyproject.toml (or setup.py, if the extension has not migrated yet) as well.

azure-pipelines · 2026-09-17T06:39:47Z

Azure Pipelines: There may be pipelines that require an authorized user to comment /azp run to run.

Copilot

🟢 Approval recommended

No unresolved blocking issues were identified, and validation coverage is complete.

Pull request overview

Regenerates the DocumentDB extension for the 2026-06-15-preview API, publishes Beta 1.1.0b1, and adds planned replica promotion support.

Changes:

Updates generated commands, custom logic, metadata, and recordings.
Adds planned promotion tests and documentation.
Marks the extension and command surface as Preview.

File summaries

File	Summary
`src/documentdb/setup.py`	Updates version and release classification.
`src/documentdb/README.md`	Documents Preview API and promotion modes.
`src/documentdb/HISTORY.rst`	Adds release notes.
`src/documentdb/azext_documentdb/tests/latest/test_documentdb.py`	Adds planned promotion coverage.
`src/documentdb/azext_documentdb/tests/latest/recordings/test_documentdb_mongocluster_negative.yaml`	Updates Preview API recordings.
`src/documentdb/azext_documentdb/custom.py`	Updates custom API usage and promotion handling.
`src/documentdb/azext_documentdb/azext_metadata.json`	Marks the extension as Preview.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/replica/_promote.py`	Adds replica promotion command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/replica/_list.py`	Regenerates replica listing command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/replica/__cmd_group.py`	Regenerates replica command group.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/identity/_wait.py`	Regenerates identity wait command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/identity/_show.py`	Regenerates identity show command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/identity/_remove.py`	Regenerates identity removal command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/identity/_list.py`	Regenerates identity listing command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/identity/_assign.py`	Regenerates identity assignment command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/identity/__cmd_group.py`	Regenerates identity command group.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/firewall_rule/_wait.py`	Regenerates firewall rule wait command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/firewall_rule/_update.py`	Regenerates firewall rule update command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/firewall_rule/_show.py`	Regenerates firewall rule show command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/firewall_rule/_list.py`	Regenerates firewall rule listing command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/firewall_rule/_delete.py`	Regenerates firewall rule deletion command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/firewall_rule/_create.py`	Regenerates firewall rule creation command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/firewall_rule/__cmd_group.py`	Regenerates firewall rule command group.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/entra_user/_wait.py`	Regenerates Entra user wait command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/entra_user/_show.py`	Regenerates Entra user show command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/entra_user/_remove.py`	Regenerates Entra user removal command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/entra_user/_list.py`	Regenerates Entra user listing command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/entra_user/_assign.py`	Regenerates Entra user assignment command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/entra_user/__cmd_group.py`	Regenerates Entra user command group.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/_wait.py`	Regenerates cluster wait command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/_update.py`	Regenerates cluster update command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/_show.py`	Regenerates cluster show command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/_list.py`	Regenerates cluster listing command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/_list_connection_strings.py`	Regenerates connection string listing command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/_delete.py`	Regenerates cluster deletion command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/_create.py`	Regenerates cluster creation command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/_check_name_availability.py`	Regenerates name availability command.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/mongocluster/__cmd_group.py`	Regenerates cluster command group.
`src/documentdb/azext_documentdb/aaz/latest/documentdb/__cmd_group.py`	Regenerates the DocumentDB command group.

Review details

Files reviewed: 39/49 changed files
Comments generated: 0
Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Aditya Pujara (a0x1ab) · 2026-09-17T06:49:46Z

/azp run

azure-pipelines · 2026-09-17T06:49:59Z

Azure Pipelines: Successfully started running 2 pipeline(s).

Yong Zhang (yonzhan) · 2026-09-17T13:11:32Z

DocumentDB

Restore the Key Vault management API version expected by the Azure CLI version used in PR integration jobs across supported Python versions. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 46bb57cf-0490-4f99-a750-27ca921e5d89

sachim

looks good to me.

Aditya Pujara (a0x1ab) · 2026-09-17T16:49:07Z

/azp run

azure-pipelines · 2026-09-17T16:49:20Z

Azure Pipelines: Successfully started running 2 pipeline(s).

Yong Zhang (yonzhan) · 2026-09-24T14:57:07Z

Please fix CI issues

amatarritamicrosoft added 2 commits September 16, 2026 15:20

Add planned DocumentDB replica promotion

7e554ef

Use the 2026-06-15-preview API for replica promotion and cover Planned and Forced options independently. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 46bb57cf-0490-4f99-a750-27ca921e5d89

azure-client-tools-bot-prd Bot added this to the October 2026 (2026-10-06) milestone Sep 17, 2026

amatarritamicrosoft added the do-not-merge label Sep 17, 2026

amatarritamicrosoft mentioned this pull request Sep 17, 2026

[DoNotMerge] Regenerate DocumentDB models for 2026-06-15-preview Azure/aaz#1093

Draft

amatarritamicrosoft marked this pull request as ready for review September 17, 2026 06:40

Copilot AI lite review requested due to automatic review settings September 17, 2026 06:40

Copilot started reviewing on behalf of amatarritamicrosoft September 17, 2026 06:41 View session

Copilot AI reviewed Sep 17, 2026

View reviewed changes

Yong Zhang (yonzhan) requested a review from Ethan Yang (necusjz) September 17, 2026 13:11

Yong Zhang (yonzhan) assigned Ethan Yang (necusjz) Sep 17, 2026

sachim approved these changes Sep 17, 2026

View reviewed changes

amatarritamicrosoft requested a review from Oliver Towers (olivertowers) September 18, 2026 18:39

Javier Figueroa (javierfigueroa) self-requested a review September 23, 2026 14:27

Javier Figueroa (javierfigueroa) approved these changes Sep 23, 2026

View reviewed changes

Navigation Menu

Regenerate DocumentDB extension for 2026-06-15-preview - #10353

Regenerate DocumentDB extension for 2026-06-15-preview#10353
amatarritamicrosoft wants to merge 3 commits into
Azure:mainfrom
amatarritamicrosoft:users/amatarrita/docdb-0615

amatarritamicrosoft commented Sep 17, 2026 •

edited by x-engineering-agent Bot

Loading

Uh oh!

azure-client-tools-bot-prd Bot commented Sep 17, 2026

Uh oh!

azure-pipelines Bot commented Sep 17, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Aditya Pujara (a0x1ab) commented Sep 17, 2026

Uh oh!

azure-pipelines Bot commented Sep 17, 2026

Uh oh!

Yong Zhang (yonzhan) commented Sep 17, 2026

Uh oh!

sachim left a comment

Uh oh!

Aditya Pujara (a0x1ab) commented Sep 17, 2026

Uh oh!

azure-pipelines Bot commented Sep 17, 2026

Uh oh!

Yong Zhang (yonzhan) commented Sep 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

Conversation

amatarritamicrosoft commented Sep 17, 2026 • edited by x-engineering-agent Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🤖 PR Validation — ⚠️ Review suggested

Summary

AAZ dependency

Validation

Uh oh!

azure-client-tools-bot-prd Bot commented Sep 17, 2026

Uh oh!

azure-pipelines Bot commented Sep 17, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

🟢 Approval recommended

Uh oh!

Aditya Pujara (a0x1ab) commented Sep 17, 2026

Uh oh!

azure-pipelines Bot commented Sep 17, 2026

Uh oh!

Yong Zhang (yonzhan) commented Sep 17, 2026

Uh oh!

sachim left a comment

Choose a reason for hiding this comment

Uh oh!

Aditya Pujara (a0x1ab) commented Sep 17, 2026

Uh oh!

azure-pipelines Bot commented Sep 17, 2026

Uh oh!

Yong Zhang (yonzhan) commented Sep 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

amatarritamicrosoft commented Sep 17, 2026 •

edited by x-engineering-agent Bot

Loading