DocumentDB for VS Code
User Manual — Back to User Manual
Azure CosmosDB for MongoDB (vCore) Service Discovery Plugin
The Azure CosmosDB for MongoDB (vCore) plugin is available as part of the Service Discovery feature in DocumentDB for VS Code. This plugin helps you connect to your Azure CosmosDB for MongoDB (vCore) clusters by handling authentication, resource discovery, and connection management within the extension.
📘 Managing Azure Resources: This provider shares common Azure management features with other Azure-based providers. See Managing Azure Discovery (Accounts, Tenants, and Subscriptions) for detailed information about:
- Managing Azure accounts and credentials
- Filtering by tenants and subscriptions
- Troubleshooting common issues
How to Access
You can access this plugin in two ways:
- Through the
Service Discoverypanel in the extension sidebar. - When adding a new connection, select the
Azure CosmosDB for MongoDB (vCore)option.
How It Works
When you use the Azure CosmosDB for MongoDB (vCore) plugin, the following steps are performed:
-
Authentication: The plugin authenticates you with Azure using your credentials. See Managing Azure Accounts for details on managing your Azure accounts.
-
Resource Filtering (Service Discovery Panel): When accessing this plugin from the Service Discovery panel, you can control which resources are displayed by filtering tenants and subscriptions. Click the funnel icon next to the provider name to configure filters. See Filtering Azure Resources for more information.
- Subscription and Cluster Discovery:
- From Service Discovery Panel: The plugin lists subscriptions based on your configured filters, allowing you to browse vCore clusters within selected subscriptions.
- From Add New Connection Wizard: All subscriptions from all tenants are shown without pre-filtering. You select one subscription to view its resources.
-
Cluster Discovery: The plugin enumerates all Azure CosmosDB for MongoDB (vCore) clusters available in your selected subscriptions.
- Connection Options:
- You can connect to a cluster by expanding its entry in the tree view.
- You can save a cluster to your
DocumentDB Connectionslist using the context menu or by clicking the save icon next to its name. - When connecting or saving, the extension detects the authentication methods supported by the cluster (e.g., Username/Password or Entra ID). If multiple are available, you will be prompted to choose your preferred method.
For an overview of how service discovery works, see the Service Discovery documentation. For details on managing your Azure accounts and subscriptions, refer to the Managing Azure Subscriptions guide.
Managing Credentials and Filters
This provider supports the following management features:
- Manage Credentials: View and manage Azure accounts used for service discovery. Right-click the provider or click the gear icon.
- Filter Resources: Control which tenants and subscriptions are displayed. Click the funnel icon next to the provider name.
- Refresh: Reload the resource list after making changes. Click the refresh icon.
For detailed instructions on these features, see Managing Azure Discovery (Accounts, Tenants, and Subscriptions).
Feedback and Contributions
If you have suggestions for improving this plugin or would like to see support for additional Azure resource types, please join the discussion board and share your feedback.