Azure Resource Manager Playwright Dotnet
MicrosoftOfficialCreated by Microsoft
- Skill
- Tool integration
- Cloud and DevOps
- MIT
- No issues found
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
The Azure.ResourceManager.Playwright SDK provides a .NET interface for interacting with the Azure Resource Manager (ARM) to provision and manage Microsoft Playwright Testing workspaces. This tool is strictly for management plane operations, such as creating, updating, or deleting workspaces, checking name availability, and monitoring resource quotas. It is distinct from test execution libraries and serves as the infrastructure-as-code layer for setting up the environment required to run Playwright tests at scale in the cloud.
What it does
- Provision and configure Microsoft Playwright Testing workspaces.
- Manage workspace lifecycle including creation, updates, and deletion.
- Check the availability of workspace names within an Azure subscription.
- Retrieve and monitor subscription-level and workspace-level resource quotas.
- Retrieve the Data Plane URI required for configuring test execution clients.
- Integrate with Azure Identity for secure, authenticated management operations.
When to use it
- When automating the deployment of Playwright Testing infrastructure via .NET.
- When you need to programmatically manage workspace settings or tags.
- When building CI/CD pipelines that provision cloud resources before running tests.
- When auditing or monitoring resource usage and quotas for Playwright workspaces.
Advantages
- Native .NET support for Azure Resource Manager operations.
- Enables infrastructure-as-code patterns for test environments.
- Provides clear separation between management plane and data plane operations.
- Supports standard Azure authentication flows via DefaultAzureCredential.
Usage examples
- “How do I create a new Playwright Testing workspace using the .NET SDK?”
- The agent provides a code snippet using PlaywrightWorkspaceData and CreateOrUpdateAsync to provision a new workspace in a specific resource group.
- “How can I check if a Playwright workspace name is available?”
- The agent demonstrates using the CheckPlaywrightNameAvailabilityAsync method with a PlaywrightCheckNameAvailabilityContent object.
- “How do I get the Data Plane URI after creating a workspace?”
- The agent shows how to access the DataplaneUri property from the PlaywrightWorkspaceResource data object after a successful creation operation.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/microsoft/azure-resource-manager-playwright-dotnet/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip azure-resource-manager-playwright-dotnet.zip -d .agents/skills
Documentation by Microsoft
Azure.ResourceManager.Playwright (.NET)
Management plane SDK for provisioning and managing Microsoft Playwright Testing workspaces via Azure Resource Manager.
⚠️ Management vs Test Execution
This SDK (Azure.ResourceManager.Playwright): Create workspaces, manage quotas, check name availability
Test Execution SDK (Azure.Developer.MicrosoftPlaywrightTesting.NUnit): Run Playwright tests at scale on cloud browsers
Installation
dotnet add package Azure.ResourceManager.Playwright
dotnet add package Azure.IdentityCurrent Versions: Stable v1.0.0, Preview v1.0.0-beta.1
Environment Variables
AZURE_SUBSCRIPTION_ID=<your-subscription-id> # Required: Azure subscription ID
AZURE_TOKEN_CREDENTIALS=prod # Required only if DefaultAzureCredential is used in production
AZURE_TENANT_ID=<tenant-id> # For service principal auth (optional)
AZURE_CLIENT_ID=<client-id> # For service principal auth (optional)
AZURE_CLIENT_SECRET=<client-secret> # For service principal auth (optional)Authentication
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Playwright;
// Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=<specific_credential>
var credential = new DefaultAzureCredential(
DefaultAzureCredential.DefaultEnvironmentVariableName
);
// Or use a specific credential directly in production:
// See https://learn.microsoft.com/dotnet/api/overview/azure/identity-readme?view=azure-dotnet#credential-classes
// var credential = new ManagedIdentityCredential();
var armClient = new ArmClient(credential);
// Get subscription
var subscriptionId = Environment.GetEnvironmentVariable("AZURE_SUBSCRIPTION_ID");
var subscription = armClient.GetSubscriptionResource(
new ResourceIdentifier($"/subscriptions/{subscriptionId}"));Resource Hierarchy
ArmClient
└── SubscriptionResource
├── PlaywrightQuotaResource (subscription-level quotas)
└── ResourceGroupResource
└── PlaywrightWorkspaceResource
└── PlaywrightWorkspaceQuotaResource (workspace-level quotas)Core Workflow
1. Create Playwright Workspace
using Azure.ResourceManager.Playwright;
using Azure.ResourceManager.Playwright.Models;
// Get resource group
var resourceGroup = await subscription
.GetResourceGroupAsync("my-resource-group");
// Define workspace
var workspaceData = new PlaywrightWorkspaceData(AzureLocation.WestUS3)
{
// Optional: Configure regional affinity and local auth
RegionalAffinity = PlaywrightRegionalAffinity.Enabled,
LocalAuth = PlaywrightLocalAuth.Enabled,
Tags =
{
["Team"] = "Dev Exp",
["Environment"] = "Production"
}
};
// Create workspace (long-running operation)
var workspaceCollection = resourceGroup.Value.GetPlaywrightWorkspaces();
var operation = await workspaceCollection.CreateOrUpdateAsync(
WaitUntil.Completed,
"my-playwright-workspace",
workspaceData);
PlaywrightWorkspaceResource workspace = operation.Value;
// Get the data plane URI for running tests
Console.WriteLine($"Data Plane URI: {workspace.Data.DataplaneUri}");
Console.WriteLine($"Workspace ID: {workspace.Data.WorkspaceId}");2. Get Existing Workspace
// Get by name
var workspace = await workspaceCollection.GetAsync("my-playwright-workspace");
// Or check if exists first
bool exists = await workspaceCollection.ExistsAsync("my-playwright-workspace");
if (exists)
{
var existingWorkspace = await workspaceCollection.GetAsync("my-playwright-workspace");
Console.WriteLine($"Workspace found: {existingWorkspace.Value.Data.Name}");
}3. List Workspaces
// List in resource group
await foreach (var workspace in workspaceCollection.GetAllAsync())
{
Console.WriteLine($"Workspace: {workspace.Data.Name}");
Console.WriteLine($" Location: {workspace.Data.Location}");
Console.WriteLine($" State: {workspace.Data.ProvisioningState}");
Console.WriteLine($" Data Plane URI: {workspace.Data.DataplaneUri}");
}
// List across subscription
await foreach (var workspace in subscription.GetPlaywrightWorkspacesAsync())
{
Console.WriteLine($"Workspace: {workspace.Data.Name}");
}4. Update Workspace
var patch = new PlaywrightWorkspacePatch
{
Tags =
{
["Team"] = "Dev Exp",
["Environment"] = "Staging",
["UpdatedAt"] = DateTime.UtcNow.ToString("o")
}
};
var updatedWorkspace = await workspace.Value.UpdateAsync(patch);5. Check Name Availability
using Azure.ResourceManager.Playwright.Models;
var checkRequest = new PlaywrightCheckNameAvailabilityContent
{
Name = "my-new-workspace",
ResourceType = "Microsoft.LoadTestService/playwrightWorkspaces"
};
var result = await subscription.CheckPlaywrightNameAvailabilityAsync(checkRequest);
if (result.Value.IsNameAvailable == true)
{
Console.WriteLine("Name is available!");
}
else
{
Console.WriteLine($"Name unavailable: {result.Value.Message}");
Console.WriteLine($"Reason: {result.Value.Reason}");
}6. Get Quota Information
// Subscription-level quotas
await foreach (var quota in subscription.GetPlaywrightQuotasAsync(AzureLocation.WestUS3))
{
Console.WriteLine($"Quota: {quota.Data.Name}");
Console.WriteLine($" Limit: {quota.Data.Limit}");
Console.WriteLine($" Used: {quota.Data.Used}");
}
// Workspace-level quotas
var workspaceQuotas = workspace.Value.GetAllPlaywrightWorkspaceQuota();
await foreach (var quota in workspaceQuotas.GetAllAsync())
{
Console.WriteLine($"Workspace Quota: {quota.Data.Name}");
}7. Delete Workspace
// Delete (long-running operation)
await workspace.Value.DeleteAsync(WaitUntil.Completed);Key Types Reference
| Type | Purpose |
|---|---|
ArmClient | Entry point for all ARM operations |
PlaywrightWorkspaceResource | Represents a Playwright Testing workspace |
PlaywrightWorkspaceCollection | Collection for workspace CRUD |
PlaywrightWorkspaceData | Workspace creation/response payload |
PlaywrightWorkspacePatch | Workspace update payload |
PlaywrightQuotaResource | Subscription-level quota information |
PlaywrightWorkspaceQuotaResource | Workspace-level quota information |
PlaywrightExtensions | Extension methods for ARM resources |
PlaywrightCheckNameAvailabilityContent | Name availability check request |
Workspace Properties
| Property | Description |
|---|---|
DataplaneUri | URI for running tests (e.g., https://api.dataplane.{guid}.domain.com) |
WorkspaceId | Unique workspace identifier (GUID) |
RegionalAffinity | Enable/disable regional affinity for test execution |
LocalAuth | Enable/disable local authentication (access tokens) |
ProvisioningState | Current provisioning state (Succeeded, Failed, etc.) |
Best Practices
Use
WaitUntil.Completedfor operations that must finish before proceedingUse
WaitUntil.Startedwhen you want to poll manually or run operations in parallelAlways use
DefaultAzureCredential— never hardcode keysHandle
RequestFailedExceptionfor ARM API errorsUse
CreateOrUpdateAsyncfor idempotent operationsNavigate hierarchy via
Get*methods (e.g.,resourceGroup.GetPlaywrightWorkspaces())Store the DataplaneUri after workspace creation for test execution configuration
Error Handling
using Azure;
try
{
var operation = await workspaceCollection.CreateOrUpdateAsync(
WaitUntil.Completed, workspaceName, workspaceData);
}
catch (RequestFailedException ex) when (ex.Status == 409)
{
Console.WriteLine("Workspace already exists");
}
catch (RequestFailedException ex) when (ex.Status == 400)
{
Console.WriteLine($"Bad request: {ex.Message}");
}
catch (RequestFailedException ex)
{
Console.WriteLine($"ARM Error: {ex.Status} - {ex.ErrorCode}: {ex.Message}");
}Integration with Test Execution
After creating a workspace, use the DataplaneUri to configure your Playwright tests:
// 1. Create workspace (this SDK)
var workspace = await workspaceCollection.CreateOrUpdateAsync(
WaitUntil.Completed, "my-workspace", workspaceData);
// 2. Get the service URL
var serviceUrl = workspace.Value.Data.DataplaneUri;
// 3. Set environment variable for test execution
Environment.SetEnvironmentVariable("PLAYWRIGHT_SERVICE_URL", serviceUrl.ToString());
// 4. Run tests using Azure.Developer.MicrosoftPlaywrightTesting.NUnit
// (separate package for test execution)Related SDKs
| SDK | Purpose | Install |
|---|---|---|
Azure.ResourceManager.Playwright | Management plane (this SDK) | dotnet add package Azure.ResourceManager.Playwright |
Azure.Developer.MicrosoftPlaywrightTesting.NUnit | Run NUnit Playwright tests at scale | dotnet add package Azure.Developer.MicrosoftPlaywrightTesting.NUnit --prerelease |
Azure.Developer.Playwright | Playwright client library | dotnet add package Azure.Developer.Playwright |
API Information
Resource Provider:
Microsoft.LoadTestServiceDefault API Version:
2025-09-01Resource Type:
Microsoft.LoadTestService/playwrightWorkspaces
Documentation Links
Files
- ATTRIBUTION.mdAdded by AutoGineer1.0 KiB
- LICENSELicence file added by AutoGineer1.1 KiB
- SKILL.md10.3 KiB
Requirements and compatibility
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta
“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.
Security
No issues found by our static scan· No issues found
A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.
Attribution and licence
- Created by
- Microsoft
- Publisher
- Microsoft (Official)
- Source
- microsoft/skills · .github/plugins/azure-sdk-dotnet/skills/azure-resource-manager-playwright-dotnet · commit 0696600
- Licence
- MIT License (redistribution allowed)
- LICENSE (added by AutoGineer from LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by Microsoft or Microsoft.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download azure-resource-manager-playwright-dotnet.zip