[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-1cf2be0f-4b5d-4b50-a161-2766deb20b9a":3,"$ffdqL1Wuw-hemP29BQNhL2QKigGpLB1kb-GDR933DhFk":43},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":34},"1cf2be0f-4b5d-4b50-a161-2766deb20b9a","azure-resource-manager-durabletask-dotnet","Azure资源管理器SDK for .NET中的Durable Task Scheduler。","cat_coding_devops","mod_coding","sickn33,coding","---\nname: azure-resource-manager-durabletask-dotnet\ndescription: Azure Resource Manager SDK for Durable Task Scheduler in .NET.\nrisk: unknown\nsource: community\ndate_added: '2026-02-27'\n---\n\n# Azure.ResourceManager.DurableTask (.NET)\n\nManagement plane SDK for provisioning and managing Azure Durable Task Scheduler resources via Azure Resource Manager.\n\n> **⚠️ Management vs Data Plane**\n> - **This SDK (Azure.ResourceManager.DurableTask)**: Create schedulers, task hubs, configure retention policies\n> - **Data Plane SDK (Microsoft.DurableTask.Client.AzureManaged)**: Start orchestrations, query instances, send events\n\n## Installation\n\n```bash\ndotnet add package Azure.ResourceManager.DurableTask\ndotnet add package Azure.Identity\n```\n\n**Current Versions**: Stable v1.0.0 (2025-11-03), Preview v1.0.0-beta.1 (2025-04-24)\n**API Version**: 2025-11-01\n\n## Environment Variables\n\n```bash\nAZURE_SUBSCRIPTION_ID=\u003Cyour-subscription-id>\nAZURE_RESOURCE_GROUP=\u003Cyour-resource-group>\n# For service principal auth (optional)\nAZURE_TENANT_ID=\u003Ctenant-id>\nAZURE_CLIENT_ID=\u003Cclient-id>\nAZURE_CLIENT_SECRET=\u003Cclient-secret>\n```\n\n## Authentication\n\n```csharp\nusing Azure.Identity;\nusing Azure.ResourceManager;\nusing Azure.ResourceManager.DurableTask;\n\n\u002F\u002F Always use DefaultAzureCredential\nvar credential = new DefaultAzureCredential();\nvar armClient = new ArmClient(credential);\n\n\u002F\u002F Get subscription\nvar subscriptionId = Environment.GetEnvironmentVariable(\"AZURE_SUBSCRIPTION_ID\");\nvar subscription = armClient.GetSubscriptionResource(\n    new ResourceIdentifier($\"\u002Fsubscriptions\u002F{subscriptionId}\"));\n```\n\n## Resource Hierarchy\n\n```\nArmClient\n└── SubscriptionResource\n    └── ResourceGroupResource\n        └── DurableTaskSchedulerResource\n            ├── DurableTaskHubResource\n            └── DurableTaskRetentionPolicyResource\n```\n\n## Core Workflow\n\n### 1. Create Durable Task Scheduler\n\n```csharp\nusing Azure.ResourceManager.DurableTask;\nusing Azure.ResourceManager.DurableTask.Models;\n\n\u002F\u002F Get resource group\nvar resourceGroup = await subscription\n    .GetResourceGroupAsync(\"my-resource-group\");\n\n\u002F\u002F Define scheduler with Dedicated SKU\nvar schedulerData = new DurableTaskSchedulerData(AzureLocation.EastUS)\n{\n    Properties = new DurableTaskSchedulerProperties\n    {\n        Sku = new DurableTaskSchedulerSku(DurableTaskSchedulerSkuName.Dedicated)\n        {\n            Capacity = 1  \u002F\u002F Number of instances\n        },\n        \u002F\u002F Optional: IP allowlist for network security\n        IPAllowlist = { \"10.0.0.0\u002F24\", \"192.168.1.0\u002F24\" }\n    }\n};\n\n\u002F\u002F Create scheduler (long-running operation)\nvar schedulerCollection = resourceGroup.Value.GetDurableTaskSchedulers();\nvar operation = await schedulerCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"my-scheduler\",\n    schedulerData);\n\nDurableTaskSchedulerResource scheduler = operation.Value;\nConsole.WriteLine($\"Scheduler created: {scheduler.Data.Name}\");\nConsole.WriteLine($\"Endpoint: {scheduler.Data.Properties.Endpoint}\");\n```\n\n### 2. Create Scheduler with Consumption SKU\n\n```csharp\n\u002F\u002F Consumption SKU (serverless)\nvar consumptionSchedulerData = new DurableTaskSchedulerData(AzureLocation.EastUS)\n{\n    Properties = new DurableTaskSchedulerProperties\n    {\n        Sku = new DurableTaskSchedulerSku(DurableTaskSchedulerSkuName.Consumption)\n        \u002F\u002F No capacity needed for consumption\n    }\n};\n\nvar operation = await schedulerCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"my-serverless-scheduler\",\n    consumptionSchedulerData);\n```\n\n### 3. Create Task Hub\n\n```csharp\n\u002F\u002F Task hubs are created under a scheduler\nvar taskHubData = new DurableTaskHubData\n{\n    \u002F\u002F Properties are optional for basic task hub\n};\n\nvar taskHubCollection = scheduler.GetDurableTaskHubs();\nvar hubOperation = await taskHubCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"my-taskhub\",\n    taskHubData);\n\nDurableTaskHubResource taskHub = hubOperation.Value;\nConsole.WriteLine($\"Task Hub created: {taskHub.Data.Name}\");\n```\n\n### 4. List Schedulers\n\n```csharp\n\u002F\u002F List all schedulers in subscription\nawait foreach (var sched in subscription.GetDurableTaskSchedulersAsync())\n{\n    Console.WriteLine($\"Scheduler: {sched.Data.Name}\");\n    Console.WriteLine($\"  Location: {sched.Data.Location}\");\n    Console.WriteLine($\"  SKU: {sched.Data.Properties.Sku?.Name}\");\n    Console.WriteLine($\"  Endpoint: {sched.Data.Properties.Endpoint}\");\n}\n\n\u002F\u002F List schedulers in resource group\nvar schedulers = resourceGroup.Value.GetDurableTaskSchedulers();\nawait foreach (var sched in schedulers.GetAllAsync())\n{\n    Console.WriteLine($\"Scheduler: {sched.Data.Name}\");\n}\n```\n\n### 5. Get Scheduler by Name\n\n```csharp\n\u002F\u002F Get existing scheduler\nvar existingScheduler = await schedulerCollection.GetAsync(\"my-scheduler\");\nConsole.WriteLine($\"Found: {existingScheduler.Value.Data.Name}\");\n\n\u002F\u002F Or use extension method\nvar schedulerResource = armClient.GetDurableTaskSchedulerResource(\n    DurableTaskSchedulerResource.CreateResourceIdentifier(\n        subscriptionId,\n        \"my-resource-group\",\n        \"my-scheduler\"));\nvar scheduler = await schedulerResource.GetAsync();\n```\n\n### 6. Update Scheduler\n\n```csharp\n\u002F\u002F Get current scheduler\nvar scheduler = await schedulerCollection.GetAsync(\"my-scheduler\");\n\n\u002F\u002F Update with new configuration\nvar updateData = new DurableTaskSchedulerData(scheduler.Value.Data.Location)\n{\n    Properties = new DurableTaskSchedulerProperties\n    {\n        Sku = new DurableTaskSchedulerSku(DurableTaskSchedulerSkuName.Dedicated)\n        {\n            Capacity = 2  \u002F\u002F Scale up\n        },\n        IPAllowlist = { \"10.0.0.0\u002F16\" }  \u002F\u002F Update IP allowlist\n    }\n};\n\nvar updateOperation = await schedulerCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"my-scheduler\",\n    updateData);\n```\n\n### 7. Delete Resources\n\n```csharp\n\u002F\u002F Delete task hub first\nvar taskHub = await scheduler.GetDurableTaskHubs().GetAsync(\"my-taskhub\");\nawait taskHub.Value.DeleteAsync(WaitUntil.Completed);\n\n\u002F\u002F Then delete scheduler\nawait scheduler.DeleteAsync(WaitUntil.Completed);\n```\n\n### 8. Manage Retention Policies\n\n```csharp\n\u002F\u002F Get retention policy collection\nvar retentionPolicies = scheduler.GetDurableTaskRetentionPolicies();\n\n\u002F\u002F Create or update retention policy\nvar retentionData = new DurableTaskRetentionPolicyData\n{\n    Properties = new DurableTaskRetentionPolicyProperties\n    {\n        \u002F\u002F Configure retention settings\n    }\n};\n\nvar retentionOperation = await retentionPolicies.CreateOrUpdateAsync(\n    WaitUntil.Completed,\n    \"default\",  \u002F\u002F Policy name\n    retentionData);\n```\n\n## Key Types Reference\n\n| Type | Purpose |\n|------|---------|\n| `ArmClient` | Entry point for all ARM operations |\n| `DurableTaskSchedulerResource` | Represents a Durable Task Scheduler |\n| `DurableTaskSchedulerCollection` | Collection for scheduler CRUD |\n| `DurableTaskSchedulerData` | Scheduler creation\u002Fupdate payload |\n| `DurableTaskSchedulerProperties` | Scheduler configuration (SKU, IPAllowlist) |\n| `DurableTaskSchedulerSku` | SKU configuration (Name, Capacity, RedundancyState) |\n| `DurableTaskSchedulerSkuName` | SKU options: `Dedicated`, `Consumption` |\n| `DurableTaskHubResource` | Represents a Task Hub |\n| `DurableTaskHubCollection` | Collection for task hub CRUD |\n| `DurableTaskHubData` | Task hub creation payload |\n| `DurableTaskRetentionPolicyResource` | Retention policy management |\n| `DurableTaskRetentionPolicyData` | Retention policy configuration |\n| `DurableTaskExtensions` | Extension methods for ARM client |\n\n## SKU Options\n\n| SKU | Description | Use Case |\n|-----|-------------|----------|\n| `Dedicated` | Fixed capacity with configurable instances | Production workloads, predictable performance |\n| `Consumption` | Serverless, auto-scaling | Development, variable workloads |\n\n## Extension Methods\n\nThe SDK provides extension methods on `SubscriptionResource` and `ResourceGroupResource`:\n\n```csharp\n\u002F\u002F On SubscriptionResource\nsubscription.GetDurableTaskSchedulers();           \u002F\u002F List all in subscription\nsubscription.GetDurableTaskSchedulersAsync();      \u002F\u002F Async enumerable\n\n\u002F\u002F On ResourceGroupResource  \nresourceGroup.GetDurableTaskSchedulers();          \u002F\u002F Get collection\nresourceGroup.GetDurableTaskSchedulerAsync(name);  \u002F\u002F Get by name\n\n\u002F\u002F On ArmClient\narmClient.GetDurableTaskSchedulerResource(id);     \u002F\u002F Get by resource ID\narmClient.GetDurableTaskHubResource(id);           \u002F\u002F Get task hub by ID\n```\n\n## Best Practices\n\n1. **Use `WaitUntil.Completed`** for operations that must finish before proceeding\n2. **Use `WaitUntil.Started`** when you want to poll manually or run operations in parallel\n3. **Always use `DefaultAzureCredential`** — never hardcode keys\n4. **Handle `RequestFailedException`** for ARM API errors\n5. **Use `CreateOrUpdateAsync`** for idempotent operations\n6. **Delete task hubs before schedulers** — schedulers with task hubs cannot be deleted\n7. **Use IP allowlists** for network security in production\n\n## Error Handling\n\n```csharp\nusing Azure;\n\ntry\n{\n    var operation = await schedulerCollection.CreateOrUpdateAsync(\n        WaitUntil.Completed, schedulerName, schedulerData);\n}\ncatch (RequestFailedException ex) when (ex.Status == 409)\n{\n    Console.WriteLine(\"Scheduler already exists\");\n}\ncatch (RequestFailedException ex) when (ex.Status == 404)\n{\n    Console.WriteLine(\"Resource group not found\");\n}\ncatch (RequestFailedException ex)\n{\n    Console.WriteLine($\"ARM Error: {ex.Status} - {ex.ErrorCode}: {ex.Message}\");\n}\n```\n\n## Complete Example\n\n```csharp\nusing Azure;\nusing Azure.Identity;\nusing Azure.ResourceManager;\nusing Azure.ResourceManager.DurableTask;\nusing Azure.ResourceManager.DurableTask.Models;\nusing Azure.ResourceManager.Resources;\n\n\u002F\u002F Setup\nvar credential = new DefaultAzureCredential();\nvar armClient = new ArmClient(credential);\n\nvar subscriptionId = Environment.GetEnvironmentVariable(\"AZURE_SUBSCRIPTION_ID\")!;\nvar resourceGroupName = Environment.GetEnvironmentVariable(\"AZURE_RESOURCE_GROUP\")!;\n\nvar subscription = armClient.GetSubscriptionResource(\n    new ResourceIdentifier($\"\u002Fsubscriptions\u002F{subscriptionId}\"));\nvar resourceGroup = await subscription.GetResourceGroupAsync(resourceGroupName);\n\n\u002F\u002F Create scheduler\nvar schedulerData = new DurableTaskSchedulerData(AzureLocation.EastUS)\n{\n    Properties = new DurableTaskSchedulerProperties\n    {\n        Sku = new DurableTaskSchedulerSku(DurableTaskSchedulerSkuName.Dedicated)\n        {\n            Capacity = 1\n        }\n    }\n};\n\nvar schedulerCollection = resourceGroup.Value.GetDurableTaskSchedulers();\nvar schedulerOp = await schedulerCollection.CreateOrUpdateAsync(\n    WaitUntil.Completed, \"my-scheduler\", schedulerData);\nvar scheduler = schedulerOp.Value;\n\nConsole.WriteLine($\"Scheduler endpoint: {scheduler.Data.Properties.Endpoint}\");\n\n\u002F\u002F Create task hub\nvar taskHubData = new DurableTaskHubData();\nvar taskHubOp = await scheduler.GetDurableTaskHubs().CreateOrUpdateAsync(\n    WaitUntil.Completed, \"my-taskhub\", taskHubData);\nvar taskHub = taskHubOp.Value;\n\nConsole.WriteLine($\"Task Hub: {taskHub.Data.Name}\");\n\n\u002F\u002F Cleanup\nawait taskHub.DeleteAsync(WaitUntil.Completed);\nawait scheduler.DeleteAsync(WaitUntil.Completed);\n```\n\n## Related SDKs\n\n| SDK | Purpose | Install |\n|-----|---------|---------|\n| `Azure.ResourceManager.DurableTask` | Management plane (this SDK) | `dotnet add package Azure.ResourceManager.DurableTask` |\n| `Microsoft.DurableTask.Client.AzureManaged` | Data plane (orchestrations, activities) | `dotnet add package Microsoft.DurableTask.Client.AzureManaged` |\n| `Microsoft.DurableTask.Worker.AzureManaged` | Worker for running orchestrations | `dotnet add package Microsoft.DurableTask.Worker.AzureManaged` |\n| `Azure.Identity` | Authentication | `dotnet add package Azure.Identity` |\n| `Azure.ResourceManager` | Base ARM SDK | `dotnet add package Azure.ResourceManager` |\n\n## Source Reference\n\n- [GitHub: Azure.ResourceManager.DurableTask](https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Ftree\u002Fmain\u002Fsdk\u002Fdurabletask\u002FAzure.ResourceManager.DurableTask)\n- [NuGet: Azure.ResourceManager.DurableTask](https:\u002F\u002Fwww.nuget.org\u002Fpackages\u002FAzure.ResourceManager.DurableTask)\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,166,339,"2026-05-16 13:07:23",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"编程开发","coding","mdi-code-braces","代码生成、调试、审查，提升开发效率",2,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":32,"skillCount":33,"createdAt":26},"DevOps","devops","mdi-cog-outline","CI\u002FCD、容器化、部署运维",3,162,[35],{"id":36,"skillId":4,"version":37,"fileName":38,"fileSize":39,"filePath":40,"fileHash":41,"manifest":42,"createdAt":19},"4f0ab374-05ad-42cb-b55b-ebbdddb5307d","1.0.0","azure-resource-manager-durabletask-dotnet.zip",3482,"uploads\u002Fskills\u002F1cf2be0f-4b5d-4b50-a161-2766deb20b9a\u002Fazure-resource-manager-durabletask-dotnet.zip","3cc51af44d8bcd85224c86924e33f7691beb2fe287039d3604d663eefa216bc7","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":12516}]",{"code":44,"message":45,"data":46},200,"success",{"items":47,"stats":48,"page":51},[],{"averageRating":49,"totalRatings":49,"ratingCounts":50},0,[49,49,49,49,49],{"limit":52,"offset":49,"hasMore":53,"nextOffset":52,"ratedOnly":16},15,false]