[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M69AMZVYA927KRRAQP7TD2W6":3,"skill-same:01M69AMZVYA927KRRAQP7TD2W6":74},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":41,"linkOnly":42,"markdownContent":43,"markdownBody":44,"frontMatter":45,"refName":50,"commitSha":51,"skillDirectory":52,"forksCount":53,"repositoryHtmlUrl":54,"repositoryHomepageUrl":55,"ownerHtmlUrl":56,"ownerBlogUrl":57,"ownerDescription":58,"updatedAt":59,"install":60,"resources":73},"01M69AMZVYA927KRRAQP7TD2W6","azure-mgmt-apicenter-dotnet",null,"Azure API Center SDK for .NET. Centralized API inventory management with governance, versioning, and discovery. Use for creating API services, workspaces, APIs, versions, definitions, environments, deployments, and metadata schemas. Triggers: \"API Center\", \"ApiCenterService\", \"ApiCenterWorkspace\", \"ApiCenterApi\", \"API inventory\", \"API governance\", \"API versioning\", \"API catalog\", \"API discovery\".","microsoft\u002Fskills","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M69AJYYW4E1RMSYCQDJ4FJSH",3204,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-sdk-dotnet\u002Fskills\u002Fazure-mgmt-apicenter-dotnet\u002FSKILL.md",[],[19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,9],"dotnet","azure","azure mgmt apicenter dotnet","catalog","api catalog","for","api services","environments","with","azure api center","triggers","api versioning","workspaces","deployments","use","sdk","versioning","discovery","api","inventory","services","governance","2026-11-10 10:12:30",false,"---\nname: azure-mgmt-apicenter-dotnet\ndescription: |\n  Azure API Center SDK for .NET. Centralized API inventory management with governance, versioning, and discovery. Use for creating API services, workspaces, APIs, versions, definitions, environments, deployments, and metadata schemas. Triggers: \"API Center\", \"ApiCenterService\", \"ApiCenterWorkspace\", \"ApiCenterApi\", \"API inventory\", \"API governance\", \"API versioning\", \"API catalog\", \"API discovery\".\nlicense: MIT\nmetadata:\n  author: Microsoft\n  version: \"1.0.0\"\n  package: Azure.ResourceManager.ApiCenter\n---\n\n# Azure.ResourceManager.ApiCenter (.NET)\n\nCentralized API inventory and governance SDK for managing APIs across your organization.\n\n## Installation\n\n```bash\ndotnet add package Azure.ResourceManager.ApiCenter\ndotnet add package Azure.Identity\n```\n\n**Current Version**: v1.0.0 (GA)  \n**API Version**: 2024-03-01\n\n## Environment Variables\n\n```bash\nAZURE_SUBSCRIPTION_ID=\u003Cyour-subscription-id>  # Required: Azure subscription ID\nAZURE_RESOURCE_GROUP=\u003Cyour-resource-group>  # Required: resource group name\nAZURE_APICENTER_SERVICE_NAME=\u003Cyour-apicenter-service>  # Required: API Center service name\nAZURE_TOKEN_CREDENTIALS=prod  # Required only if DefaultAzureCredential is used in production\n```\n\n## Authentication\n\n```csharp\nusing Azure.Identity;\nusing Azure.ResourceManager;\nusing Azure.ResourceManager.ApiCenter;\n\n\u002F\u002F Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=\u003Cspecific_credential>\nvar credential = new DefaultAzureCredential(\n    DefaultAzureCredential.DefaultEnvironmentVariableName\n);\n\u002F\u002F Or use a specific credential directly in production:\n\u002F\u002F See https:\u002F\u002Flearn.microsoft.com\u002Fdotnet\u002Fapi\u002Foverview\u002Fazure\u002Fidentity-readme?view=azure-dotnet#credential-classes\n\u002F\u002F var credential = new ManagedIdentityCredential();\nArmClient client = new ArmClient(credential);\n```\n\n## Resource Hierarchy\n\n```\nSubscription\n└── ResourceGroup\n    └── ApiCenterService                    # API inventory service\n        ├── Workspace                       # Logical grouping of APIs\n        │   ├── Api                         # API definition\n        │   │   └── ApiVersion              # Version of the API\n        │   │       └── ApiDefinition       # OpenAPI\u002FGraphQL\u002Fetc specification\n        │   ├── Environment                 # Deployment target (dev\u002Fstaging\u002Fprod)\n        │   └── Deployment                  # API deployed to environment\n        └── MetadataSchema                  # Custom metadata definitions\n```\n\n## Core Workflows\n\n### 1. Create API Center Service\n\n```csharp\nusing Azure.ResourceManager.ApiCenter;\nusing Azure.ResourceManager.ApiCenter.Models;\n\nResourceGroupResource resourceGroup = await client\n    .GetDefaultSubscriptionAsync()\n    .Result\n    .GetResourceGroupAsync(\"my-resource-group\");\n\nApiCenterServiceCollection services = resourceGroup.GetApiCenterServices();\n\nApiCenterServiceData data = new ApiCenterServiceData(AzureLocation.EastUS)\n{\n    Identity = new ManagedServiceIdentity(ManagedServiceIdentityType.SystemAssigned)\n};\n\nArmOperation\u003CApiCenterServiceResource> operation = await services\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"my-api-center\", data);\n\nApiCenterServiceResource service = operation.Value;\n```\n\n### 2. Create Workspace\n\n```csharp\nApiCenterWorkspaceCollection workspaces = service.GetApiCenterWorkspaces();\n\nApiCenterWorkspaceData workspaceData = new ApiCenterWorkspaceData\n{\n    Title = \"Engineering APIs\",\n    Description = \"APIs owned by the engineering team\"\n};\n\nArmOperation\u003CApiCenterWorkspaceResource> operation = await workspaces\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"engineering\", workspaceData);\n\nApiCenterWorkspaceResource workspace = operation.Value;\n```\n\n### 3. Create API\n\n```csharp\nApiCenterApiCollection apis = workspace.GetApiCenterApis();\n\nApiCenterApiData apiData = new ApiCenterApiData\n{\n    Title = \"Orders API\",\n    Description = \"API for managing customer orders\",\n    Kind = ApiKind.Rest,\n    LifecycleStage = ApiLifecycleStage.Production,\n    TermsOfService = new ApiTermsOfService\n    {\n        Uri = new Uri(\"https:\u002F\u002Fexample.com\u002Fterms\")\n    },\n    ExternalDocumentation = \n    {\n        new ApiExternalDocumentation\n        {\n            Title = \"Documentation\",\n            Uri = new Uri(\"https:\u002F\u002Fdocs.example.com\u002Forders\")\n        }\n    },\n    Contacts =\n    {\n        new ApiContact\n        {\n            Name = \"API Support\",\n            Email = \"api-support@example.com\"\n        }\n    }\n};\n\n\u002F\u002F Add custom metadata\napiData.CustomProperties = BinaryData.FromObjectAsJson(new\n{\n    team = \"orders-team\",\n    costCenter = \"CC-1234\"\n});\n\nArmOperation\u003CApiCenterApiResource> operation = await apis\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"orders-api\", apiData);\n\nApiCenterApiResource api = operation.Value;\n```\n\n### 4. Create API Version\n\n```csharp\nApiCenterApiVersionCollection versions = api.GetApiCenterApiVersions();\n\nApiCenterApiVersionData versionData = new ApiCenterApiVersionData\n{\n    Title = \"v1.0.0\",\n    LifecycleStage = ApiLifecycleStage.Production\n};\n\nArmOperation\u003CApiCenterApiVersionResource> operation = await versions\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"v1-0-0\", versionData);\n\nApiCenterApiVersionResource version = operation.Value;\n```\n\n### 5. Create API Definition (Upload OpenAPI Spec)\n\n```csharp\nApiCenterApiDefinitionCollection definitions = version.GetApiCenterApiDefinitions();\n\nApiCenterApiDefinitionData definitionData = new ApiCenterApiDefinitionData\n{\n    Title = \"OpenAPI Specification\",\n    Description = \"Orders API OpenAPI 3.0 definition\"\n};\n\nArmOperation\u003CApiCenterApiDefinitionResource> operation = await definitions\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"openapi\", definitionData);\n\nApiCenterApiDefinitionResource definition = operation.Value;\n\n\u002F\u002F Import specification\nstring openApiSpec = await File.ReadAllTextAsync(\"orders-api.yaml\");\n\nApiSpecImportContent importContent = new ApiSpecImportContent\n{\n    Format = ApiSpecImportSourceFormat.Inline,\n    Value = openApiSpec,\n    Specification = new ApiSpecImportSpecification\n    {\n        Name = \"openapi\",\n        Version = \"3.0.1\"\n    }\n};\n\nawait definition.ImportSpecificationAsync(WaitUntil.Completed, importContent);\n```\n\n### 6. Export API Specification\n\n```csharp\nApiCenterApiDefinitionResource definition = await client\n    .GetApiCenterApiDefinitionResource(definitionResourceId)\n    .GetAsync();\n\nArmOperation\u003CApiSpecExportResult> operation = await definition\n    .ExportSpecificationAsync(WaitUntil.Completed);\n\nApiSpecExportResult result = operation.Value;\n\n\u002F\u002F result.Format - e.g., \"inline\"\n\u002F\u002F result.Value - the specification content\n```\n\n### 7. Create Environment\n\n```csharp\nApiCenterEnvironmentCollection environments = workspace.GetApiCenterEnvironments();\n\nApiCenterEnvironmentData envData = new ApiCenterEnvironmentData\n{\n    Title = \"Production\",\n    Description = \"Production environment\",\n    Kind = ApiCenterEnvironmentKind.Production,\n    Server = new ApiCenterEnvironmentServer\n    {\n        ManagementPortalUris = { new Uri(\"https:\u002F\u002Fportal.azure.com\") }\n    },\n    Onboarding = new EnvironmentOnboardingModel\n    {\n        Instructions = \"Contact platform team for access\",\n        DeveloperPortalUris = { new Uri(\"https:\u002F\u002Fdeveloper.example.com\") }\n    }\n};\n\nArmOperation\u003CApiCenterEnvironmentResource> operation = await environments\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"production\", envData);\n```\n\n### 8. Create Deployment\n\n```csharp\nApiCenterDeploymentCollection deployments = workspace.GetApiCenterDeployments();\n\n\u002F\u002F Get environment resource ID\nResourceIdentifier envResourceId = ApiCenterEnvironmentResource.CreateResourceIdentifier(\n    subscriptionId, resourceGroupName, serviceName, workspaceName, \"production\");\n\n\u002F\u002F Get API definition resource ID\nResourceIdentifier definitionResourceId = ApiCenterApiDefinitionResource.CreateResourceIdentifier(\n    subscriptionId, resourceGroupName, serviceName, workspaceName, \n    \"orders-api\", \"v1-0-0\", \"openapi\");\n\nApiCenterDeploymentData deploymentData = new ApiCenterDeploymentData\n{\n    Title = \"Orders API - Production\",\n    Description = \"Production deployment of Orders API v1.0.0\",\n    EnvironmentId = envResourceId,\n    DefinitionId = definitionResourceId,\n    State = ApiCenterDeploymentState.Active,\n    Server = new ApiCenterDeploymentServer\n    {\n        RuntimeUris = { new Uri(\"https:\u002F\u002Fapi.example.com\u002Forders\") }\n    }\n};\n\nArmOperation\u003CApiCenterDeploymentResource> operation = await deployments\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"orders-api-prod\", deploymentData);\n```\n\n### 9. Create Metadata Schema\n\n```csharp\nApiCenterMetadataSchemaCollection schemas = service.GetApiCenterMetadataSchemas();\n\nstring jsonSchema = \"\"\"\n{\n    \"type\": \"object\",\n    \"properties\": {\n        \"team\": {\n            \"type\": \"string\",\n            \"title\": \"Owning Team\"\n        },\n        \"costCenter\": {\n            \"type\": \"string\",\n            \"title\": \"Cost Center\"\n        },\n        \"dataClassification\": {\n            \"type\": \"string\",\n            \"enum\": [\"public\", \"internal\", \"confidential\"],\n            \"title\": \"Data Classification\"\n        }\n    },\n    \"required\": [\"team\"]\n}\n\"\"\";\n\nApiCenterMetadataSchemaData schemaData = new ApiCenterMetadataSchemaData\n{\n    Schema = jsonSchema,\n    AssignedTo =\n    {\n        new MetadataAssignment\n        {\n            Entity = MetadataAssignmentEntity.Api,\n            Required = true\n        }\n    }\n};\n\nArmOperation\u003CApiCenterMetadataSchemaResource> operation = await schemas\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"api-metadata\", schemaData);\n```\n\n### 10. List and Search APIs\n\n```csharp\n\u002F\u002F List all APIs in a workspace\nApiCenterWorkspaceResource workspace = await client\n    .GetApiCenterWorkspaceResource(workspaceResourceId)\n    .GetAsync();\n\nawait foreach (ApiCenterApiResource api in workspace.GetApiCenterApis())\n{\n    Console.WriteLine($\"API: {api.Data.Title}\");\n    Console.WriteLine($\"  Kind: {api.Data.Kind}\");\n    Console.WriteLine($\"  Stage: {api.Data.LifecycleStage}\");\n    \n    \u002F\u002F List versions\n    await foreach (ApiCenterApiVersionResource version in api.GetApiCenterApiVersions())\n    {\n        Console.WriteLine($\"  Version: {version.Data.Title}\");\n    }\n}\n\n\u002F\u002F List environments\nawait foreach (ApiCenterEnvironmentResource env in workspace.GetApiCenterEnvironments())\n{\n    Console.WriteLine($\"Environment: {env.Data.Title} ({env.Data.Kind})\");\n}\n\n\u002F\u002F List deployments\nawait foreach (ApiCenterDeploymentResource deployment in workspace.GetApiCenterDeployments())\n{\n    Console.WriteLine($\"Deployment: {deployment.Data.Title}\");\n    Console.WriteLine($\"  State: {deployment.Data.State}\");\n}\n```\n\n## Key Types Reference\n\n| Type | Purpose |\n|------|---------|\n| `ApiCenterServiceResource` | API Center service instance |\n| `ApiCenterWorkspaceResource` | Logical grouping of APIs |\n| `ApiCenterApiResource` | Individual API |\n| `ApiCenterApiVersionResource` | Version of an API |\n| `ApiCenterApiDefinitionResource` | API specification (OpenAPI, etc.) |\n| `ApiCenterEnvironmentResource` | Deployment environment |\n| `ApiCenterDeploymentResource` | API deployment to environment |\n| `ApiCenterMetadataSchemaResource` | Custom metadata schema |\n| `ApiKind` | rest, graphql, grpc, soap, webhook, websocket, mcp |\n| `ApiLifecycleStage` | design, development, testing, preview, production, deprecated, retired |\n| `ApiCenterEnvironmentKind` | development, testing, staging, production |\n| `ApiCenterDeploymentState` | active, inactive |\n\n## Best Practices\n\n1. **Organize with workspaces** — Group APIs by team, domain, or product\n2. **Use metadata schemas** — Define custom properties for governance\n3. **Track lifecycle stages** — Keep API status current (design → production → deprecated)\n4. **Document environments** — Include onboarding instructions and portal URIs\n5. **Version consistently** — Use semantic versioning for API versions\n6. **Import specifications** — Upload OpenAPI\u002FGraphQL specs for discovery\n7. **Link deployments** — Connect APIs to their runtime environments\n8. **Use managed identity** — Enable SystemAssigned identity for secure integrations\n\n## Error Handling\n\n```csharp\nusing Azure;\n\ntry\n{\n    ArmOperation\u003CApiCenterApiResource> operation = await apis\n        .CreateOrUpdateAsync(WaitUntil.Completed, \"my-api\", apiData);\n}\ncatch (RequestFailedException ex) when (ex.Status == 409)\n{\n    Console.WriteLine(\"API already exists with conflicting configuration\");\n}\ncatch (RequestFailedException ex) when (ex.Status == 400)\n{\n    Console.WriteLine($\"Invalid request: {ex.Message}\");\n}\ncatch (RequestFailedException ex)\n{\n    Console.WriteLine($\"Azure error: {ex.Status} - {ex.Message}\");\n}\n```\n\n## Related SDKs\n\n| SDK | Purpose | Install |\n|-----|---------|---------|\n| `Azure.ResourceManager.ApiCenter` | API Center management (this SDK) | `dotnet add package Azure.ResourceManager.ApiCenter` |\n| `Azure.ResourceManager.ApiManagement` | API gateway and policies | `dotnet add package Azure.ResourceManager.ApiManagement` |\n\n## Reference Links\n\n| Resource | URL |\n|----------|-----|\n| NuGet Package | https:\u002F\u002Fwww.nuget.org\u002Fpackages\u002FAzure.ResourceManager.ApiCenter |\n| API Reference | https:\u002F\u002Flearn.microsoft.com\u002Fdotnet\u002Fapi\u002Fazure.resourcemanager.apicenter |\n| Product Documentation | https:\u002F\u002Flearn.microsoft.com\u002Fazure\u002Fapi-center\u002F |\n| GitHub Source | https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Ftree\u002Fmain\u002Fsdk\u002Fapicenter\u002FAzure.ResourceManager.ApiCenter |\n","# Azure.ResourceManager.ApiCenter (.NET)\n\nCentralized API inventory and governance SDK for managing APIs across your organization.\n\n## Installation\n\n```bash\ndotnet add package Azure.ResourceManager.ApiCenter\ndotnet add package Azure.Identity\n```\n\n**Current Version**: v1.0.0 (GA)  \n**API Version**: 2024-03-01\n\n## Environment Variables\n\n```bash\nAZURE_SUBSCRIPTION_ID=\u003Cyour-subscription-id>  # Required: Azure subscription ID\nAZURE_RESOURCE_GROUP=\u003Cyour-resource-group>  # Required: resource group name\nAZURE_APICENTER_SERVICE_NAME=\u003Cyour-apicenter-service>  # Required: API Center service name\nAZURE_TOKEN_CREDENTIALS=prod  # Required only if DefaultAzureCredential is used in production\n```\n\n## Authentication\n\n```csharp\nusing Azure.Identity;\nusing Azure.ResourceManager;\nusing Azure.ResourceManager.ApiCenter;\n\n\u002F\u002F Local dev: DefaultAzureCredential. Production: set AZURE_TOKEN_CREDENTIALS=prod or AZURE_TOKEN_CREDENTIALS=\u003Cspecific_credential>\nvar credential = new DefaultAzureCredential(\n    DefaultAzureCredential.DefaultEnvironmentVariableName\n);\n\u002F\u002F Or use a specific credential directly in production:\n\u002F\u002F See https:\u002F\u002Flearn.microsoft.com\u002Fdotnet\u002Fapi\u002Foverview\u002Fazure\u002Fidentity-readme?view=azure-dotnet#credential-classes\n\u002F\u002F var credential = new ManagedIdentityCredential();\nArmClient client = new ArmClient(credential);\n```\n\n## Resource Hierarchy\n\n```\nSubscription\n└── ResourceGroup\n    └── ApiCenterService                    # API inventory service\n        ├── Workspace                       # Logical grouping of APIs\n        │   ├── Api                         # API definition\n        │   │   └── ApiVersion              # Version of the API\n        │   │       └── ApiDefinition       # OpenAPI\u002FGraphQL\u002Fetc specification\n        │   ├── Environment                 # Deployment target (dev\u002Fstaging\u002Fprod)\n        │   └── Deployment                  # API deployed to environment\n        └── MetadataSchema                  # Custom metadata definitions\n```\n\n## Core Workflows\n\n### 1. Create API Center Service\n\n```csharp\nusing Azure.ResourceManager.ApiCenter;\nusing Azure.ResourceManager.ApiCenter.Models;\n\nResourceGroupResource resourceGroup = await client\n    .GetDefaultSubscriptionAsync()\n    .Result\n    .GetResourceGroupAsync(\"my-resource-group\");\n\nApiCenterServiceCollection services = resourceGroup.GetApiCenterServices();\n\nApiCenterServiceData data = new ApiCenterServiceData(AzureLocation.EastUS)\n{\n    Identity = new ManagedServiceIdentity(ManagedServiceIdentityType.SystemAssigned)\n};\n\nArmOperation\u003CApiCenterServiceResource> operation = await services\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"my-api-center\", data);\n\nApiCenterServiceResource service = operation.Value;\n```\n\n### 2. Create Workspace\n\n```csharp\nApiCenterWorkspaceCollection workspaces = service.GetApiCenterWorkspaces();\n\nApiCenterWorkspaceData workspaceData = new ApiCenterWorkspaceData\n{\n    Title = \"Engineering APIs\",\n    Description = \"APIs owned by the engineering team\"\n};\n\nArmOperation\u003CApiCenterWorkspaceResource> operation = await workspaces\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"engineering\", workspaceData);\n\nApiCenterWorkspaceResource workspace = operation.Value;\n```\n\n### 3. Create API\n\n```csharp\nApiCenterApiCollection apis = workspace.GetApiCenterApis();\n\nApiCenterApiData apiData = new ApiCenterApiData\n{\n    Title = \"Orders API\",\n    Description = \"API for managing customer orders\",\n    Kind = ApiKind.Rest,\n    LifecycleStage = ApiLifecycleStage.Production,\n    TermsOfService = new ApiTermsOfService\n    {\n        Uri = new Uri(\"https:\u002F\u002Fexample.com\u002Fterms\")\n    },\n    ExternalDocumentation = \n    {\n        new ApiExternalDocumentation\n        {\n            Title = \"Documentation\",\n            Uri = new Uri(\"https:\u002F\u002Fdocs.example.com\u002Forders\")\n        }\n    },\n    Contacts =\n    {\n        new ApiContact\n        {\n            Name = \"API Support\",\n            Email = \"api-support@example.com\"\n        }\n    }\n};\n\n\u002F\u002F Add custom metadata\napiData.CustomProperties = BinaryData.FromObjectAsJson(new\n{\n    team = \"orders-team\",\n    costCenter = \"CC-1234\"\n});\n\nArmOperation\u003CApiCenterApiResource> operation = await apis\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"orders-api\", apiData);\n\nApiCenterApiResource api = operation.Value;\n```\n\n### 4. Create API Version\n\n```csharp\nApiCenterApiVersionCollection versions = api.GetApiCenterApiVersions();\n\nApiCenterApiVersionData versionData = new ApiCenterApiVersionData\n{\n    Title = \"v1.0.0\",\n    LifecycleStage = ApiLifecycleStage.Production\n};\n\nArmOperation\u003CApiCenterApiVersionResource> operation = await versions\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"v1-0-0\", versionData);\n\nApiCenterApiVersionResource version = operation.Value;\n```\n\n### 5. Create API Definition (Upload OpenAPI Spec)\n\n```csharp\nApiCenterApiDefinitionCollection definitions = version.GetApiCenterApiDefinitions();\n\nApiCenterApiDefinitionData definitionData = new ApiCenterApiDefinitionData\n{\n    Title = \"OpenAPI Specification\",\n    Description = \"Orders API OpenAPI 3.0 definition\"\n};\n\nArmOperation\u003CApiCenterApiDefinitionResource> operation = await definitions\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"openapi\", definitionData);\n\nApiCenterApiDefinitionResource definition = operation.Value;\n\n\u002F\u002F Import specification\nstring openApiSpec = await File.ReadAllTextAsync(\"orders-api.yaml\");\n\nApiSpecImportContent importContent = new ApiSpecImportContent\n{\n    Format = ApiSpecImportSourceFormat.Inline,\n    Value = openApiSpec,\n    Specification = new ApiSpecImportSpecification\n    {\n        Name = \"openapi\",\n        Version = \"3.0.1\"\n    }\n};\n\nawait definition.ImportSpecificationAsync(WaitUntil.Completed, importContent);\n```\n\n### 6. Export API Specification\n\n```csharp\nApiCenterApiDefinitionResource definition = await client\n    .GetApiCenterApiDefinitionResource(definitionResourceId)\n    .GetAsync();\n\nArmOperation\u003CApiSpecExportResult> operation = await definition\n    .ExportSpecificationAsync(WaitUntil.Completed);\n\nApiSpecExportResult result = operation.Value;\n\n\u002F\u002F result.Format - e.g., \"inline\"\n\u002F\u002F result.Value - the specification content\n```\n\n### 7. Create Environment\n\n```csharp\nApiCenterEnvironmentCollection environments = workspace.GetApiCenterEnvironments();\n\nApiCenterEnvironmentData envData = new ApiCenterEnvironmentData\n{\n    Title = \"Production\",\n    Description = \"Production environment\",\n    Kind = ApiCenterEnvironmentKind.Production,\n    Server = new ApiCenterEnvironmentServer\n    {\n        ManagementPortalUris = { new Uri(\"https:\u002F\u002Fportal.azure.com\") }\n    },\n    Onboarding = new EnvironmentOnboardingModel\n    {\n        Instructions = \"Contact platform team for access\",\n        DeveloperPortalUris = { new Uri(\"https:\u002F\u002Fdeveloper.example.com\") }\n    }\n};\n\nArmOperation\u003CApiCenterEnvironmentResource> operation = await environments\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"production\", envData);\n```\n\n### 8. Create Deployment\n\n```csharp\nApiCenterDeploymentCollection deployments = workspace.GetApiCenterDeployments();\n\n\u002F\u002F Get environment resource ID\nResourceIdentifier envResourceId = ApiCenterEnvironmentResource.CreateResourceIdentifier(\n    subscriptionId, resourceGroupName, serviceName, workspaceName, \"production\");\n\n\u002F\u002F Get API definition resource ID\nResourceIdentifier definitionResourceId = ApiCenterApiDefinitionResource.CreateResourceIdentifier(\n    subscriptionId, resourceGroupName, serviceName, workspaceName, \n    \"orders-api\", \"v1-0-0\", \"openapi\");\n\nApiCenterDeploymentData deploymentData = new ApiCenterDeploymentData\n{\n    Title = \"Orders API - Production\",\n    Description = \"Production deployment of Orders API v1.0.0\",\n    EnvironmentId = envResourceId,\n    DefinitionId = definitionResourceId,\n    State = ApiCenterDeploymentState.Active,\n    Server = new ApiCenterDeploymentServer\n    {\n        RuntimeUris = { new Uri(\"https:\u002F\u002Fapi.example.com\u002Forders\") }\n    }\n};\n\nArmOperation\u003CApiCenterDeploymentResource> operation = await deployments\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"orders-api-prod\", deploymentData);\n```\n\n### 9. Create Metadata Schema\n\n```csharp\nApiCenterMetadataSchemaCollection schemas = service.GetApiCenterMetadataSchemas();\n\nstring jsonSchema = \"\"\"\n{\n    \"type\": \"object\",\n    \"properties\": {\n        \"team\": {\n            \"type\": \"string\",\n            \"title\": \"Owning Team\"\n        },\n        \"costCenter\": {\n            \"type\": \"string\",\n            \"title\": \"Cost Center\"\n        },\n        \"dataClassification\": {\n            \"type\": \"string\",\n            \"enum\": [\"public\", \"internal\", \"confidential\"],\n            \"title\": \"Data Classification\"\n        }\n    },\n    \"required\": [\"team\"]\n}\n\"\"\";\n\nApiCenterMetadataSchemaData schemaData = new ApiCenterMetadataSchemaData\n{\n    Schema = jsonSchema,\n    AssignedTo =\n    {\n        new MetadataAssignment\n        {\n            Entity = MetadataAssignmentEntity.Api,\n            Required = true\n        }\n    }\n};\n\nArmOperation\u003CApiCenterMetadataSchemaResource> operation = await schemas\n    .CreateOrUpdateAsync(WaitUntil.Completed, \"api-metadata\", schemaData);\n```\n\n### 10. List and Search APIs\n\n```csharp\n\u002F\u002F List all APIs in a workspace\nApiCenterWorkspaceResource workspace = await client\n    .GetApiCenterWorkspaceResource(workspaceResourceId)\n    .GetAsync();\n\nawait foreach (ApiCenterApiResource api in workspace.GetApiCenterApis())\n{\n    Console.WriteLine($\"API: {api.Data.Title}\");\n    Console.WriteLine($\"  Kind: {api.Data.Kind}\");\n    Console.WriteLine($\"  Stage: {api.Data.LifecycleStage}\");\n    \n    \u002F\u002F List versions\n    await foreach (ApiCenterApiVersionResource version in api.GetApiCenterApiVersions())\n    {\n        Console.WriteLine($\"  Version: {version.Data.Title}\");\n    }\n}\n\n\u002F\u002F List environments\nawait foreach (ApiCenterEnvironmentResource env in workspace.GetApiCenterEnvironments())\n{\n    Console.WriteLine($\"Environment: {env.Data.Title} ({env.Data.Kind})\");\n}\n\n\u002F\u002F List deployments\nawait foreach (ApiCenterDeploymentResource deployment in workspace.GetApiCenterDeployments())\n{\n    Console.WriteLine($\"Deployment: {deployment.Data.Title}\");\n    Console.WriteLine($\"  State: {deployment.Data.State}\");\n}\n```\n\n## Key Types Reference\n\n| Type | Purpose |\n|------|---------|\n| `ApiCenterServiceResource` | API Center service instance |\n| `ApiCenterWorkspaceResource` | Logical grouping of APIs |\n| `ApiCenterApiResource` | Individual API |\n| `ApiCenterApiVersionResource` | Version of an API |\n| `ApiCenterApiDefinitionResource` | API specification (OpenAPI, etc.) |\n| `ApiCenterEnvironmentResource` | Deployment environment |\n| `ApiCenterDeploymentResource` | API deployment to environment |\n| `ApiCenterMetadataSchemaResource` | Custom metadata schema |\n| `ApiKind` | rest, graphql, grpc, soap, webhook, websocket, mcp |\n| `ApiLifecycleStage` | design, development, testing, preview, production, deprecated, retired |\n| `ApiCenterEnvironmentKind` | development, testing, staging, production |\n| `ApiCenterDeploymentState` | active, inactive |\n\n## Best Practices\n\n1. **Organize with workspaces** — Group APIs by team, domain, or product\n2. **Use metadata schemas** — Define custom properties for governance\n3. **Track lifecycle stages** — Keep API status current (design → production → deprecated)\n4. **Document environments** — Include onboarding instructions and portal URIs\n5. **Version consistently** — Use semantic versioning for API versions\n6. **Import specifications** — Upload OpenAPI\u002FGraphQL specs for discovery\n7. **Link deployments** — Connect APIs to their runtime environments\n8. **Use managed identity** — Enable SystemAssigned identity for secure integrations\n\n## Error Handling\n\n```csharp\nusing Azure;\n\ntry\n{\n    ArmOperation\u003CApiCenterApiResource> operation = await apis\n        .CreateOrUpdateAsync(WaitUntil.Completed, \"my-api\", apiData);\n}\ncatch (RequestFailedException ex) when (ex.Status == 409)\n{\n    Console.WriteLine(\"API already exists with conflicting configuration\");\n}\ncatch (RequestFailedException ex) when (ex.Status == 400)\n{\n    Console.WriteLine($\"Invalid request: {ex.Message}\");\n}\ncatch (RequestFailedException ex)\n{\n    Console.WriteLine($\"Azure error: {ex.Status} - {ex.Message}\");\n}\n```\n\n## Related SDKs\n\n| SDK | Purpose | Install |\n|-----|---------|---------|\n| `Azure.ResourceManager.ApiCenter` | API Center management (this SDK) | `dotnet add package Azure.ResourceManager.ApiCenter` |\n| `Azure.ResourceManager.ApiManagement` | API gateway and policies | `dotnet add package Azure.ResourceManager.ApiManagement` |\n\n## Reference Links\n\n| Resource | URL |\n|----------|-----|\n| NuGet Package | https:\u002F\u002Fwww.nuget.org\u002Fpackages\u002FAzure.ResourceManager.ApiCenter |\n| API Reference | https:\u002F\u002Flearn.microsoft.com\u002Fdotnet\u002Fapi\u002Fazure.resourcemanager.apicenter |\n| Product Documentation | https:\u002F\u002Flearn.microsoft.com\u002Fazure\u002Fapi-center\u002F |\n| GitHub Source | https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Ftree\u002Fmain\u002Fsdk\u002Fapicenter\u002FAzure.ResourceManager.ApiCenter |\n",{"name":5,"license":15,"metadata":46,"description":49},{"author":12,"package":47,"version":48},"Azure.ResourceManager.ApiCenter","1.0.0","Azure API Center SDK for .NET. Centralized API inventory management with governance, versioning, and discovery. Use for creating API services, workspaces, APIs, versions, definitions, environments, deployments, and metadata schemas. Triggers: \"API Center\", \"ApiCenterService\", \"ApiCenterWorkspace\", \"ApiCenterApi\", \"API inventory\", \"API governance\", \"API versioning\", \"API catalog\", \"API discovery\".\n","main","3f5b461b2314e01c400564051e92469114c5b68f",".github\u002Fplugins\u002Fazure-sdk-dotnet\u002Fskills\u002Fazure-mgmt-apicenter-dotnet",368,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills","https:\u002F\u002Fmicrosoft.github.io\u002Fskills\u002F","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-14 06:48:25",{"source":8,"skillName":5,"commands":61,"prompt":71,"zipAvailable":72},[62,65,68],{"tool":63,"command":64},"npx","npx skills add microsoft\u002Fskills --skill azure-mgmt-apicenter-dotnet",{"tool":66,"command":67},"bunx","bunx skills add microsoft\u002Fskills --skill azure-mgmt-apicenter-dotnet",{"tool":69,"command":70},"pnpm","pnpm dlx skills add microsoft\u002Fskills --skill azure-mgmt-apicenter-dotnet","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-sdk-dotnet\u002Fskills\u002Fazure-mgmt-apicenter-dotnet\u002FSKILL.md",true,[],[75,83,108,145,172,192],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":82},"01M741JBE1VH8A2Y3FXX2P7386","azure-advisor-cost-optimization","Analyze Azure Advisor Cost\u002FIdleResources findings and prevalidate deletion safety, including Service Groups. WHEN: \"find unused Azure resources\", \"what resources am I paying for but no longer using\", \"idle-resource savings\", \"historical idle-resource savings\", \"are these idle resources safe to delete\". Generic Cost, other subcategories, and cross-category requests use azure-advisor.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fplugins\u002Fazure-advisor\u002Fskills\u002Fazure-advisor-cost-optimization\u002FSKILL.md",[],[],"2026-11-11 15:11:14",{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":94,"publishedAt":41},"01M69B4JCRQV5SPXAFCKXQRV0H","skill-creator","Guide for creating effective skills for AI coding agents working with Azure SDKs and Microsoft Foundry services. Use when creating new skills or updating existing skills.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fskill-creator\u002FSKILL.md",[89],{"categoryNo":90,"categoryName":91,"taxonomyType":92,"taxonomyTypeDesc":93},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[95,96,97,98,9,20,99,100,101,102,24,33,103,39,104,105,106,27,107],"skill creator","creator","ai coding agents","coding agents","foundry","microsoft foundry","coding","guide","Existing","new","when","sdks","ai coding",{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":124,"publishedAt":41},"01M69B4FD57V1MYKRWAJJECTZ7","podcast-generation","Generate AI-powered podcast-style audio narratives using Azure OpenAI's GPT Realtime Mini model via WebSocket. Use when building text-to-speech features, audio narrative generation, podcast creation from content, or integrating with Azure OpenAI Realtime API for real audio output. Covers full-stack implementation from React frontend to Python FastAPI backend with WebSocket streaming.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fpodcast-generation\u002FSKILL.md",[114,117,120,123],{"categoryNo":115,"categoryName":116,"taxonomyType":92,"taxonomyTypeDesc":93},"01JBSEEDCAT000000000000009","前端开发",{"categoryNo":118,"categoryName":119,"taxonomyType":92,"taxonomyTypeDesc":93},"01JBSEEDCAT000000000000010","后端与接口",{"categoryNo":121,"categoryName":122,"taxonomyType":92,"taxonomyTypeDesc":93},"01JBSEEDCAT000000000000016","图像与多媒体",{"categoryNo":90,"categoryName":91,"taxonomyType":92,"taxonomyTypeDesc":93},[125,126,127,128,20,129,130,131,132,133,134,135,136,137,138,105,37,139,140,141,142,143,144],"podcast generation","generation","podcast","frontend","azure openai","realtime","react","python","Audio","creation","model","fastapi backend","python fastapi","fastapi","streaming","text","narrative","stack","generate","features",{"skillNo":146,"name":147,"nameZh":6,"description":148,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":149,"categories":150,"keywords":152,"publishedAt":41},"01M69B4CYPM5SESY5ZWEFDXEQZ","microsoft-docs","Understand Microsoft technologies by querying official documentation. Use whenever the user asks how something works, wants tutorials, needs configuration options, limits, quotas, or best practices for any Microsoft technology (Azure, .NET, M365, Windows, Power Platform, etc.)—even if they don't mention \"docs.\" If the question is about understanding a concept rather than writing code, this is the right skill.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",[151],{"categoryNo":90,"categoryName":91,"taxonomyType":92,"taxonomyTypeDesc":93},[153,9,154,155,156,157,158,20,159,160,161,162,163,164,165,166,24,167,63,168,33,169,170,171],"microsoft docs","docs","documentation","windows","official","cli","MCP","writing","power platform","mcp server","back","concept","power","platform","technology","question","learn mcp","learn","best practices",{"skillNo":173,"name":174,"nameZh":6,"description":175,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":176,"categories":177,"keywords":179,"publishedAt":41},"01M69B49C3YPD1ZJ3NC0HPCY58","mcp-builder","Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP), Node\u002FTypeScript (MCP SDK), or C#\u002F.NET (Microsoft MCP SDK).","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fmcp-builder\u002FSKILL.md",[178],{"categoryNo":90,"categoryName":91,"taxonomyType":92,"taxonomyTypeDesc":93},[180,159,181,182,34,9,132,183,184,135,185,105,186,187,188,102,189,190,24,191,33,27],"mcp builder","builder","llms","typescript","model context protocol","building mcp servers","node","integrate","Tools","context","fastmcp","mcp sdk",{"skillNo":193,"name":194,"nameZh":6,"description":195,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":196,"categories":197,"keywords":210,"publishedAt":41},"01M69B467A7CDMFQ0T6Q0ZA12Q","kql","KQL language expertise for writing correct, efficient Kusto Query Language queries. Covers syntax gotchas, join patterns, dynamic types, datetime pitfalls, regex patterns, serialization, memory management, result-size discipline, and advanced functions (geo, vector, graph). USE THIS SKILL whenever writing, debugging, or reviewing KQL queries — even simple ones — because the gotchas section prevents the most common errors that waste tool calls and cause expensive retry cascades. Trigger on: KQL, Kusto, ADX, Azure Data Explorer, Fabric Real-Time Intelligence, EventHouse, Log Analytics, log analysis, data exploration, time series, anomaly detection, summarize, where clause, join, extend, project, let statement, parse operator, extract function, any mention of pipe-forward query syntax.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fskills\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fkql\u002FSKILL.md",[198,201,202,207],{"categoryNo":199,"categoryName":200,"taxonomyType":92,"taxonomyTypeDesc":93},"01JBSEEDCAT000000000000018","写作与文案",{"categoryNo":90,"categoryName":91,"taxonomyType":92,"taxonomyTypeDesc":93},{"categoryNo":203,"categoryName":204,"taxonomyType":205,"taxonomyTypeDesc":206},"01JBSEEDCAT000000000000033","数据分析师","PROFESSION","适用职业",{"categoryNo":208,"categoryName":209,"taxonomyType":205,"taxonomyTypeDesc":206},"01JBSEEDCAT000000000000036","内容创作者",[194,20,160,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,226,24,227,228,229],"analytics","memory","summarize","exploration","parse","project","time","vector","join","log","pipe","datetime","discipline","time series","regex","anomaly","section","tool","geo"]