1# API Management — .NET SDK Quick Reference
2 
3> Condensed from **azure-mgmt-apimanagement-dotnet**. Full patterns (service
4> creation, APIs, products, policies, users, gateways, backends)
5> in the **azure-mgmt-apimanagement-dotnet** plugin skill if installed.
6 
7## Install
8dotnet add package Azure.ResourceManager.ApiManagement
9dotnet add package Azure.Identity
10 
11## Quick Start
12> **Auth:** `DefaultAzureCredential` is for local development. See [auth-best-practices.md](../auth-best-practices.md) for production patterns.
13 
14```csharp
15using Azure.ResourceManager;
16using Azure.Identity;
17var armClient = new ArmClient(new DefaultAzureCredential());
18```
19 
20## Best Practices
21- Use `WaitUntil.Completed` for operations that must finish before proceeding
22- Use `WaitUntil.Started` for long operations like service creation (30+ min)
23- Use DefaultAzureCredential for **local development only**. In production, use ManagedIdentityCredential — see [auth-best-practices.md](../auth-best-practices.md)
24- Handle `RequestFailedException` for ARM API errors
25- Use `CreateOrUpdateAsync` for idempotent operations
26- Navigate hierarchy via `Get*` methods (e.g., `service.GetApis()`)
27- Policy format — use XML format for policies; JSON is also supported
28- Service creation — Developer SKU is fastest for testing (~15-30 min)
29