---
id: azure-mgmt-cosmosdb
version: "10.0.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# azure-mgmt-cosmosdb — Microsoft Azure Cosmosdb Management Client Library for Python

License: permissive · Maintenance: active · Downloads: 14.2M/mo

## What it is and what it does

This is the official Azure SDK management client for Cosmos DB. It lets you create, update, delete, and query Cosmos DB accounts, databases, containers, and clusters programmatically from Python code. You authenticate via Microsoft Entra using environment variables or credential objects, then instantiate a CosmosDBManagementClient and call methods on operation groups to manage your infrastructure.

The package requires Python 3.10 or later and depends on azure-mgmt-core (the base Azure management SDK), isodate (for date parsing), and typing-extensions (for type hints). It is designed for infrastructure automation, deployment pipelines, and administrative tooling rather than for querying data within Cosmos DB itself.

Use it for:

- Automate provisioning of Cosmos DB accounts and databases in CI/CD pipelines
- Build infrastructure-as-code scripts to manage Cosmos DB resources across environments
- Create administrative dashboards or tools that list and configure Cosmos DB clusters
- Programmatically scale throughput or adjust backup schedules on existing databases
- Migrate or replicate Cosmos DB configurations across Azure subscriptions or regions

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides programmatic management of Azure Cosmos DB resources—databases, containers, clusters, and accounts—via the Azure control plane.

Yes—if you need to manage Azure Cosmos DB resources from Python code. The package is actively maintained, has no known vulnerabilities, low install friction, and is the official Microsoft SDK for this purpose. Requires Python 3.10+, Azure subscription, and proper Entra authentication setup.

## Install

pip install azure-mgmt-cosmosdb
uv add azure-mgmt-cosmosdb
poetry add azure-mgmt-cosmosdb

## Installing azure-mgmt-cosmosdb

Before you install: Low install friction; pure Python wheel with three lightweight runtime dependencies. Actively maintained with recent release (42 days old); repository is not archived and has 5588 stars.

License in practice: MIT license permits commercial and private use with minimal restrictions; suitable for most projects.

Quickstart:

pip install azure-mgmt-cosmosdb

from azure.mgmt.cosmosdb import CosmosDBManagementClient
import os

sub_id = os.getenv("AZURE_SUBSCRIPTION_ID")
client = CosmosDBManagementClient(
    credential=credential,
    subscription_id=sub_id
)

Requires Python 3.10+; Azure subscription and Entra credentials (AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET, AZURE_SUBSCRIPTION_ID environment variables) must be configured.

Verify before relying:

- Whether the package includes async/await support for management operations
- Specific Azure Cosmos DB API types supported (SQL, MongoDB, Cassandra, Gremlin, Table)
- Rate limits or throttling behavior for management plane calls
- Whether azure-identity is required or optional for authentication

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 14.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

azure cosmos db management, azure cosmosdb client library, manage cosmos db resources, azure sdk python cosmosdb, cosmos db infrastructure as code, azure database administration, cosmos db provisioning python, azure-sdk, infrastructure-management, cloud-provisioning

[View on SkillFed](https://skillfed.io/packages/azure-mgmt-cosmosdb) · [View on PyPI](https://pypi.org/project/azure-mgmt-cosmosdb/)