azure-resource-manager-cosmosdb-dotnet

azure-resource-manager-cosmosdb-dotnet 技能總覽

azure-resource-manager-cosmosdb-dotnet 是 Azure Cosmos DB 的 .NET 管理平面技能。當你需要透過 Azure Resource Manager 來佈建或變更 Cosmos DB 帳戶、SQL 資料庫、容器、throughput 和 RBAC，而不是讀寫文件資料時，就該使用它。它很適合負責雲端環境自動化設定的後端開發團隊、平台工程師，以及需要用正確 Azure SDK 產生基礎結構程式碼的代理。

這個技能是用來做什麼的

azure-resource-manager-cosmosdb-dotnet 技能聚焦在控制平面工作：建立帳戶、設定區域與容錯移轉、管理資料庫與容器，以及調整 throughput。如果你的工作是對項目做 CRUD、查詢，或處理 stored procedures，那就不是這個 SDK 的範圍；這個技能刻意不處理資料平面工作。

什麼情況下它是正確選擇

當你的提示詞出現像是「create Cosmos account」、「provision Cosmos DB」、「manage Cosmos resources」或「configure Cosmos throughput」這類字眼時，就應該選用這個技能。它最大的價值在於降低 Cosmos DB 管理 API 與應用資料 API 之間的混淆，這也是最常見的導入阻礙。

主要差異點

azure-resource-manager-cosmosdb-dotnet 最強的訊號就是管理平面與資料平面的界線。這條界線很重要，因為產生出來的程式碼、驗證模式與資源物件，都和一般的 Microsoft.Azure.Cosmos SDK 不同。當你想要的是 Azure SDK for .NET，而不是泛泛的 Azure Portal 操作教學時，這個技能最有用。

如何使用 azure-resource-manager-cosmosdb-dotnet 技能

安裝並確認套件

如果是本機 .NET 專案，請使用下列指令安裝底層 SDK：
dotnet add package Azure.ResourceManager.CosmosDB
dotnet add package Azure.Identity

如果你的環境有 skills manager，請先安裝 azure-resource-manager-cosmosdb-dotnet 技能，再用它來整理程式碼與資源模型，之後再寫最終實作。

先從正確的輸入開始

一個好的 azure-resource-manager-cosmosdb-dotnet 使用需求，應該要說清楚資源類型、API 面、部署意圖與限制。例如：「建立一個 .NET 8 服務，佈建具 autoscale throughput、兩個區域與 managed identity 的 Cosmos DB SQL database。」這比「幫我處理 Cosmos DB」有效得多，因為技能可以直接對應到正確的 ARM 資源。

先讀哪些檔案最有幫助

先讀 SKILL.md，再看 references/account-management.md、references/sql-resources.md 和 references/throughput.md。這些檔案涵蓋會影響輸出品質的實務選擇：帳戶建立、SQL 資源操作，以及 RU/s 規模設定。如果你只打算先快速看一份 reference，建議先看 throughput，因為它往往直接決定成本與架構。

好用的提示詞模式

一個有用的 azure-resource-manager-cosmosdb-dotnet 引導提示詞，最好包含：

• 目標資源：account、database、container，或 RBAC
• 需要手動 throughput 還是 autoscale throughput
• 區域數量與容錯移轉預期
• 驗證方式：DefaultAzureCredential、service principal，或 managed identity
• 你只需要佈建程式碼，還是也需要 update/delete 流程

範例：「Generate backend setup code for Azure.ResourceManager.CosmosDB that creates a Cosmos DB account in East US and West US, enables automatic failover, creates a SQL database, and uses autoscale at 4000 RU/s.」

azure-resource-manager-cosmosdb-dotnet 技能 FAQ

這和 Cosmos DB data SDK 是同一個嗎？

不是。azure-resource-manager-cosmosdb-dotnet 只用於管理平面操作。它適合做帳戶與資源管理；像插入、讀取、查詢、刪除這類應用資料操作，則應該使用 Microsoft.Azure.Cosmos。

azure-resource-manager-cosmosdb-dotnet 對後端開發有幫助嗎？

有，尤其當後端服務也負責雲端佈建、環境初始化或租戶設定時。它能幫助後端程式建立可預期的 Cosmos DB 基礎結構，而不是依賴人工操作 Portal。

使用前需要很懂 Azure 嗎？

不需要太深，但你至少要知道自己要佈建什麼。這個技能可以減少 SDK 猜測成本，但你仍然要決定要用 shared throughput、autoscale、多區域 failover，還是 RBAC。

什麼情況下不該用它？

如果你的工作是文件 CRUD、應用程式內的查詢效能調校，或是要寫 Cosmos DB client library 的程式範例，就不要用 azure-resource-manager-cosmosdb-dotnet。這些情況下，用錯 SDK 產生的程式碼可能可以編譯，卻解決了錯的問題。

如何改進 azure-resource-manager-cosmosdb-dotnet 技能

把缺少的設計選項講清楚

最好的 azure-resource-manager-cosmosdb-dotnet 輸出，來自不只描述想要的資源，而是連帳戶形狀都說清楚的提示詞。請明確說出是否只用 SQL API、需要幾個區域、寫入是單區域還是多區域，以及 throughput 要固定還是 autoscale。

先把作業限制講在前面

常見失敗模式包括驗證方式說得不夠清楚、缺少 subscription context，以及 throughput 需求太模糊。較好的輸入像是：「Use managed identity in Azure, target subscription ID provided at runtime, create a SQL database with shared throughput, and avoid preview features.」這樣可以避免技能自己猜。

針對資源層級迭代，不要整個 App 重寫

如果第一次結果已經接近目標，可以用更小的變更來改善 azure-resource-manager-cosmosdb-dotnet 的輸出：帳戶冗餘、SQL container indexing、throughput migration，或 RBAC assignment。針對單一資源的小幅調整，通常比要求整個重寫更容易得到更好的程式碼。

先讀 reference，再改預設值

改進的重點通常是選對 Cosmos DB 設定，而不是多寫更多程式碼。若是帳戶旗標，請看 references/account-management.md；若是資料庫與容器操作，請看 references/sql-resources.md；而當你在意成本或擴展行為時，則要看 references/throughput.md。