Skip to content

Throughput bucket preview #27971

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

Open
wants to merge 21 commits into
base: Az.CosmosDB-preview
Choose a base branch
from

Conversation

pjohari-ms
Copy link
Member

@pjohari-ms pjohari-ms commented Jun 16, 2025

Description

Mandatory Checklist

  • SHOULD update ChangeLog.md file(s) appropriately
    • Update src/{{SERVICE}}/{{SERVICE}}/ChangeLog.md.
      • A snippet outlining the change(s) made in the PR should be written under the ## Upcoming Release header in the past tense.
    • Should not change ChangeLog.md if no new release is required, such as fixing test case only.
  • SHOULD regenerate markdown help files if there is cmdlet API change. Instruction
  • SHOULD have proper test coverage for changes in pull request.
  • SHOULD NOT adjust version of module manually in pull request

Achint-Agrawal and others added 21 commits May 22, 2025 15:52
Modified maximum throughput percentages for two buckets in
`Test-SqlThroughputCmdlets`. Added assertions to verify
updated bucket properties. Removed the test for container
throughput buckets and the associated function
`Test-SqlThroughputBucketCmdlets`. Adjusted formatting in
`Test-ClientEncryptionKeyCmdletsUsingInputObject` for clarity.
Modified the help message for the `MaxThroughputPercentage` parameter in `NewAzCosmosDBThroughputBucketObject.cs` for clarity. Restored two help message constants in `Constants.cs` related to throughput buckets and added a new constant to improve usability in Cosmos DB resource management.
Updated `Test-SqlThroughputCmdlets` in `SqlOperationsTests.ps1` to add assertions for `ThroughputBuckets`. The test now verifies the count of buckets and checks the `Id` and `MaxThroughputPercentage` for each bucket to ensure expected values are set correctly.
Corrected the parameter name from `-Name $AccountName` to `-AccountName $AccountName` in the `Update-AzCosmosDBSqlContainerThroughput` function calls within `SqlOperationsTests.ps1`. This change ensures proper parameter usage and consistency across test cases, including instances with empty `-ThroughputBuckets`.
Refactor throughput handling in Azure Cosmos DB management library.
Introduce `PSThroughputBucket` class to replace `ThroughputBucketResource`.
Modify `CreateThroughputSettingsObject` to accept an array of
`PSThroughputBucket`. Update `ThroughputSettingsGetResults` to ensure
consistent usage of the new type, improving type safety and aligning
with the updated data model for throughput settings.
Introduced `New-AzCosmosDBThroughputBucketObject` cmdlet to create CosmosDB Throughput Bucket objects, complete with documentation updates for synopsis, syntax, and examples.

Enhanced existing CosmosDB cmdlets to support a new `-ThroughputBuckets` parameter, allowing users to specify multiple throughput buckets for better resource management. Updated documentation for all affected cmdlets to reflect these changes.
Enhanced the synopsis and description for the command by replacing placeholder text with a specific description. Added an example to illustrate usage, demonstrating how to create a new throughput bucket object with parameters. The parameters section remains unchanged.
Updated the Azure Cosmos DB PowerShell module to replace
all instances of "ThroughputBuckets" with "ThroughputBucketsObject".
This change affects test scripts, helper classes, and model
definitions, ensuring consistency in the API. Help messages
related to these parameters have also been updated for clarity
on throughput bucket usage in Cosmos DB operations.
…mmands

Renamed `-ThroughputBuckets` to `-ThroughputBucketsObject`
across multiple Azure CosmosDB command documentation files.
This change clarifies the expected input type, indicating
that the parameter accepts an array of `PSThroughputBucket` objects.
Copy link

Thanks for your contribution! The pull request validation has started. Please revisit this comment for updated status.

@vidai-msft
Copy link
Contributor

/azp run

Copy link
Contributor

Azure Pipelines successfully started running 3 pipeline(s).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants