Skip to content

Comments

docs: Add explicit User-Assigned Managed Identity (UAMI) example for Cosmos DB binding#128221

Open
paulyuk wants to merge 1 commit intoMicrosoftDocs:mainfrom
paulyuk:docs/uami-cosmosdb-example
Open

docs: Add explicit User-Assigned Managed Identity (UAMI) example for Cosmos DB binding#128221
paulyuk wants to merge 1 commit intoMicrosoftDocs:mainfrom
paulyuk:docs/uami-cosmosdb-example

Conversation

@paulyuk
Copy link

@paulyuk paulyuk commented Feb 20, 2026

Summary

This PR adds a clearer example showing how to configure Cosmos DB connections using a User-Assigned Managed Identity (UAMI) with explicit app settings.

Problem

The existing documentation mentions credential and clientId properties for user-assigned managed identities but lacks a concrete JSON example.

Solution

Added a new "User-assigned managed identity" subsection with:

  • A table showing the three required properties (accountEndpoint, credential, clientId)
  • A complete JSON example developers can copy directly
  • A tip explaining when UAMI is recommended

Changes

  • includes/functions-cosmosdb-connections.md: Added UAMI configuration example

Related

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@prmerger-automator
Copy link
Contributor

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

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit d0e81ad:

✅ Validation status: passed

File Status Preview URL Details
includes/functions-cosmosdb-connections.md ✅Succeeded

For more details, please refer to the build report.

@prmerger-automator
Copy link
Contributor

PRMerger Results

Issue Description
File Change Percent This PR contains file(s) with more than 30% file change.

Copy link
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

This PR adds explicit documentation for configuring Azure Cosmos DB connections using User-Assigned Managed Identity (UAMI) in Azure Functions. The existing documentation mentioned the credential and clientId properties but lacked a concrete example that developers could directly reference and copy.

Changes:

  • Added a dedicated "User-assigned managed identity" subsection with property details, complete JSON configuration example, and best practice guidance

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@ttorble
Copy link
Contributor

ttorble commented Feb 20, 2026

@mattchenderson

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 tracking label for the PR review team label Feb 20, 2026
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.

3 participants