---

name: azure-resource-manager-cosmosdb-dotnet description: Azure Resource Manager SDK 用于 .NET 中的 Cosmos DB。 risk: unknown source: community date_added: '2026-02-27'

Azure.ResourceManager.CosmosDB (.NET)

用于通过 Azure Resource Manager 预配和管理 Azure Cosmos DB 资源的管理平面 SDK。

管理平面 vs 数据平面

• 此 SDK (Azure.ResourceManager.CosmosDB)：创建账户、数据库、容器，配置吞吐量，管理 RBAC
• 数据平面 SDK (Microsoft.Azure.Cosmos)：文档的 CRUD 操作、查询、存储过程执行

安装

dotnet add package Azure.ResourceManager.CosmosDB
dotnet add package Azure.Identity

当前版本：稳定版 v1.4.0，预览版 v1.4.0-beta.13

环境变量

AZURE_SUBSCRIPTION_ID=<your-subscription-id>
# For service principal auth (optional)
AZURE_TENANT_ID=<tenant-id>
AZURE_CLIENT_ID=<client-id>
AZURE_CLIENT_SECRET=<client-secret>

认证

using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.CosmosDB;

// Always use DefaultAzureCredential
var credential = new DefaultAzureCredential();
var armClient = new ArmClient(credential);

// Get subscription
var subscriptionId = Environment.GetEnvironmentVariable("AZURE_SUBSCRIPTION_ID");
var subscription = armClient.GetSubscriptionResource(
    new ResourceIdentifier($"/subscriptions/{subscriptionId}"));

资源层次结构

ArmClient
└── SubscriptionResource
    └── ResourceGroupResource
        └── CosmosDBAccountResource
            ├── CosmosDBSqlDatabaseResource
            │   └── CosmosDBSqlContainerResource
            │       ├── CosmosDBSqlStoredProcedureResource
            │       ├── CosmosDBSqlTriggerResource
            │       └── CosmosDBSqlUserDefinedFunctionResource
            ├── CassandraKeyspaceResource
            ├── GremlinDatabaseResource
            ├── MongoDBDatabaseResource
            └── CosmosDBTableResource