Skip to content

Enhance guide with built-in roles information#360

Closed
GeethaThatipatri-MSFT wants to merge 2 commits intoMicrosoftDocs:mainfrom
GeethaThatipatri-MSFT:patch-2
Closed

Enhance guide with built-in roles information#360
GeethaThatipatri-MSFT wants to merge 2 commits intoMicrosoftDocs:mainfrom
GeethaThatipatri-MSFT:patch-2

Conversation

@GeethaThatipatri-MSFT
Copy link
Copy Markdown

Added information about built-in data plane roles with updated doc link in Azure Cosmos DB.

Added information about built-in data plane roles in Azure Cosmos DB.
@prmerger-automator
Copy link
Copy Markdown
Contributor

@GeethaThatipatri-MSFT : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 77da970:

⚠️ Validation status: warnings

File Status Preview URL Details
articles/cosmos-db/how-to-connect-role-based-access-control.md ⚠️Warning Details

articles/cosmos-db/how-to-connect-role-based-access-control.md

  • Line 166, Column 157: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/azure/cosmos-db/reference-data-plane-security#built-in-roles' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 166, Column 157: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/azure/cosmos-db/reference-data-plane-security#built-in-roles' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Azure Cosmos DB role-based access control (RBAC) connection guide to mention built-in data plane roles and link readers to the full built-in roles reference.

Changes:

  • Adds a sentence calling out built-in data plane roles (reader/contributor) for common access patterns.
  • Adds a link to the built-in roles reference section.

You can also share your feedback on Copilot code review. Take the survey.

Comment thread articles/cosmos-db/how-to-connect-role-based-access-control.md Outdated

First, you must prepare a role definition with a list of `dataActions` to grant access to read, query, and manage data in Azure Cosmos DB for NoSQL. In this guide, you prepare a custom role. Then, assign the newly defined role to an identity so that your applications can access data in Azure Cosmos DB for NoSQL.

Azure Cosmos DB also provides built-in data plane roles (such as Data Reader and Data Contributor) to simplify common access patterns; see the full list of [built-in roles](https://learn.microsoft.com/en-us/azure/cosmos-db/reference-data-plane-security#built-in-roles)
@Court72
Copy link
Copy Markdown
Contributor

Court72 commented Mar 13, 2026

@seesharprun

Can you review the proposed changes?

Important: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@prmerger-automator prmerger-automator Bot added the aq-pr-triaged C+L Pull Request Review Team label label Mar 13, 2026
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 0f426c0:

⚠️ Validation status: warnings

File Status Preview URL Details
articles/cosmos-db/how-to-connect-role-based-access-control.md ⚠️Warning Details

articles/cosmos-db/how-to-connect-role-based-access-control.md

  • Line 166, Column 191: [Warning: hard-coded-locale - See documentation] Link 'https://learn.microsoft.com/en-us/azure/cosmos-db/reference-data-plane-security#built-in-roles' contains locale code 'en-us'. For localizability, remove 'en-us' from links to most Microsoft sites.
  • Line 166, Column 191: [Suggestion: docs-link-absolute - See documentation] Absolute link 'https://learn.microsoft.com/en-us/azure/cosmos-db/reference-data-plane-security#built-in-roles' will be broken in isolated environments. Replace with a relative link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

@seesharprun
Copy link
Copy Markdown
Contributor

Resolved in another repository

#please-close

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants