Cosmosdb Api

Azure Cosmos DB is Microsoft's globally distributed database — unique in offering multiple wire protocols (NoSQL, MongoDB, Cassandra, Gremlin, Table) so teams can use familiar interfaces while getting Cosmos DB's global distribution, SLA-backed latency (<10ms reads), and configurable consistency levels. For agents: the NoSQL API (native) provides the richest feature set; MongoDB API enables existing pymongo code to work against Cosmos DB. Managed Identity auth enables passwordless access from Azure services. Free tier (1000 RU/s, 25GB) covers development. Confidence is docs-derived.

NoSQL API via azure-cosmos SDK (Python). client = CosmosClient(url, credential=DefaultAzureCredential()). db = client.get_database_client("mydb"). container = db.get_container_client("users"). container.create_item({id: "user-123", partitionKey: "users", name: "Alice", email: "alice@example.com"}). container.read_item("user-123", partition_key="users") retrieves document. container.query_items(query="SELECT * FROM c WHERE c.plan = 'pro'", enable_cross_partition_query=False). container.upsert_item({...}) upserts. container.delete_item("user-123", partition_key="users"). Patch: container.patch_item(item_id, partition_key, patch_operations=[{"op": "add", "path": "/newField", "value": "x"}]). Change feed: container.read_all_items(max_item_count=100) with continuation token.

Managed Identity (recommended for Azure-hosted agents): DefaultAzureCredential() from azure-identity — zero stored credentials. Connection string: CosmosClient(connection_string) for simpler setup. Account key: CosmosClient(url, credential=AzureKeyCredential(key)) for non-Azure deployments. HTTPS enforced. No OAuth2. RBAC: assign Cosmos DB Built-in Data Contributor role to Managed Identity or Service Principal. Partition key: required on all operations — design data model around partition key before implementation.

azure-cosmos SDK exceptions (CosmosResourceNotFoundError, CosmosHttpResponseError with status_code). 429: Request rate too large — implement exponential backoff (SDK auto-retries by default). Partition key required: operations without valid partition key fail. Cross-partition queries: significantly slower — avoid in hot paths (enable_cross_partition_query=True only for infrequent analytics). Free tier: 1000 RU/s limit — budget request units per operation type. Cosmos DB uptime at status.azure.com. Consistency: 5 levels (Strong, Bounded Staleness, Session, Consistent Prefix, Eventual) — choose per use case. Indexing: automatic by default — customize IndexingPolicy for cost optimization.

learn.microsoft.com/azure/cosmos-db covers NoSQL API reference, SDK guides (Python, .NET, Java, JS, Go), MongoDB API setup, data modeling guide, and global distribution documentation. Getting started: Azure free account, create Cosmos DB account (free tier), azure-cosmos SDK — first item in under 10 minutes. azure-cosmos: pip install azure-cosmos azure-identity. Terraform: azurerm_cosmosdb_account. Community via Microsoft Q&A and Stack Overflow (azure-cosmosdb tag). Comprehensive documentation for a complex, feature-rich globally distributed database.