Azure Mgmt Apicenter Dotnet

作者 microsoft354361d83247MIT收录于 2026年10月8日更新于 2026年10月8日

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".

AI 生成的概览

指导 .NET 开发者使用 Azure API Center SDK 管理 API 清单、版本、定义、环境和部署。

功能
该技能提供使用 Azure.ResourceManager.ApiCenter .NET SDK 的 C# 代码示例和指导。内容涵盖创建和管理 API Center 服务、工作区、API、版本、定义、环境、部署以及元数据架构。还展示了如何导入和导出 OpenAPI 规范、列出和搜索 API,以及处理常见的 Azure 错误。
适用场景
适用于构建管理 Azure API Center 清单的 .NET 应用程序或自动化任务。适合注册 API、上传 OpenAPI 规范、跟踪生命周期阶段、定义治理元数据以及将 API 关联到部署环境等场景。
运行要求
需要 .NET SDK 以及 Azure.ResourceManager.ApiCenter 和 Azure.Identity NuGet 包。需要 Azure 订阅、资源组、API Center 服务名称和适当的凭据(DefaultAzureCredential 或 ManagedIdentityCredential 等特定凭据)。需要访问 Azure 的网络连接。不包含脚本,仅为说明和代码示例。

Azure.ResourceManager.ApiCenter (.NET)

Centralized API inventory and governance SDK for managing APIs across your organization.

Installation

bash
dotnet add package Azure.ResourceManager.ApiCenterdotnet add package Azure.Identity

Current Version: v1.0.0 (GA)
API Version: 2024-03-01

Environment Variables

bash
AZURE_SUBSCRIPTION_ID=<your-subscription-id>  # Required: Azure subscription IDAZURE_RESOURCE_GROUP=<your-resource-group>  # Required: resource group nameAZURE_APICENTER_SERVICE_NAME=<your-apicenter-service>  # Required: API Center service nameAZURE_TOKEN_CREDENTIALS=prod  # Required only if DefaultAzureCredential is used in production

Authentication

csharp
using Azure.Identity;using Azure.ResourceManager;using Azure.ResourceManager.ApiCenter;
// 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();ArmClient client = new ArmClient(credential);

Resource Hierarchy

Subscription└── ResourceGroup    └── ApiCenterService                    # API inventory service        ├── Workspace                       # Logical grouping of APIs        │   ├── Api                         # API definition        │   │   └── ApiVersion              # Version of the API        │   │       └── ApiDefinition       # OpenAPI/GraphQL/etc specification        │   ├── Environment                 # Deployment target (dev/staging/prod)        │   └── Deployment                  # API deployed to environment        └── MetadataSchema                  # Custom metadata definitions

Core Workflows

1. Create API Center Service

csharp
using Azure.ResourceManager.ApiCenter;using Azure.ResourceManager.ApiCenter.Models;
ResourceGroupResource resourceGroup = await client    .GetDefaultSubscriptionAsync()    .Result    .GetResourceGroupAsync("my-resource-group");
ApiCenterServiceCollection services = resourceGroup.GetApiCenterServices();
ApiCenterServiceData data = new ApiCenterServiceData(AzureLocation.EastUS){    Identity = new ManagedServiceIdentity(ManagedServiceIdentityType.SystemAssigned)};
ArmOperation<ApiCenterServiceResource> operation = await services    .CreateOrUpdateAsync(WaitUntil.Completed, "my-api-center", data);
ApiCenterServiceResource service = operation.Value;

2. Create Workspace

csharp
ApiCenterWorkspaceCollection workspaces = service.GetApiCenterWorkspaces();
ApiCenterWorkspaceData workspaceData = new ApiCenterWorkspaceData{    Title = "Engineering APIs",    Description = "APIs owned by the engineering team"};
ArmOperation<ApiCenterWorkspaceResource> operation = await workspaces    .CreateOrUpdateAsync(WaitUntil.Completed, "engineering", workspaceData);
ApiCenterWorkspaceResource workspace = operation.Value;

3. Create API

csharp
ApiCenterApiCollection apis = workspace.GetApiCenterApis();
ApiCenterApiData apiData = new ApiCenterApiData{    Title = "Orders API",    Description = "API for managing customer orders",    Kind = ApiKind.Rest,    LifecycleStage = ApiLifecycleStage.Production,    TermsOfService = new ApiTermsOfService    {        Uri = new Uri("https://example.com/terms")    },    ExternalDocumentation =     {        new ApiExternalDocumentation        {            Title = "Documentation",            Uri = new Uri("https://docs.example.com/orders")        }    },    Contacts =    {        new ApiContact        {            Name = "API Support",            Email = "[email protected]"        }    }};
// Add custom metadataapiData.CustomProperties = BinaryData.FromObjectAsJson(new{    team = "orders-team",    costCenter = "CC-1234"});
ArmOperation<ApiCenterApiResource> operation = await apis    .CreateOrUpdateAsync(WaitUntil.Completed, "orders-api", apiData);
ApiCenterApiResource api = operation.Value;

4. Create API Version

csharp
ApiCenterApiVersionCollection versions = api.GetApiCenterApiVersions();
ApiCenterApiVersionData versionData = new ApiCenterApiVersionData{    Title = "v1.0.0",    LifecycleStage = ApiLifecycleStage.Production};
ArmOperation<ApiCenterApiVersionResource> operation = await versions    .CreateOrUpdateAsync(WaitUntil.Completed, "v1-0-0", versionData);
ApiCenterApiVersionResource version = operation.Value;

5. Create API Definition (Upload OpenAPI Spec)

csharp
ApiCenterApiDefinitionCollection definitions = version.GetApiCenterApiDefinitions();
ApiCenterApiDefinitionData definitionData = new ApiCenterApiDefinitionData{    Title = "OpenAPI Specification",    Description = "Orders API OpenAPI 3.0 definition"};
ArmOperation<ApiCenterApiDefinitionResource> operation = await definitions    .CreateOrUpdateAsync(WaitUntil.Completed, "openapi", definitionData);
ApiCenterApiDefinitionResource definition = operation.Value;
// Import specificationstring openApiSpec = await File.ReadAllTextAsync("orders-api.yaml");
ApiSpecImportContent importContent = new ApiSpecImportContent{    Format = ApiSpecImportSourceFormat.Inline,    Value = openApiSpec,    Specification = new ApiSpecImportSpecification    {        Name = "openapi",        Version = "3.0.1"    }};
await definition.ImportSpecificationAsync(WaitUntil.Completed, importContent);

6. Export API Specification

csharp
ApiCenterApiDefinitionResource definition = await client    .GetApiCenterApiDefinitionResource(definitionResourceId)    .GetAsync();
ArmOperation<ApiSpecExportResult> operation = await definition    .ExportSpecificationAsync(WaitUntil.Completed);
ApiSpecExportResult result = operation.Value;
// result.Format - e.g., "inline"// result.Value - the specification content

7. Create Environment

csharp
ApiCenterEnvironmentCollection environments = workspace.GetApiCenterEnvironments();
ApiCenterEnvironmentData envData = new ApiCenterEnvironmentData{    Title = "Production",    Description = "Production environment",    Kind = ApiCenterEnvironmentKind.Production,    Server = new ApiCenterEnvironmentServer    {        ManagementPortalUris = { new Uri("https://portal.azure.com") }    },    Onboarding = new EnvironmentOnboardingModel    {        Instructions = "Contact platform team for access",        DeveloperPortalUris = { new Uri("https://developer.example.com") }    }};
ArmOperation<ApiCenterEnvironmentResource> operation = await environments    .CreateOrUpdateAsync(WaitUntil.Completed, "production", envData);

8. Create Deployment

csharp
ApiCenterDeploymentCollection deployments = workspace.GetApiCenterDeployments();
// Get environment resource IDResourceIdentifier envResourceId = ApiCenterEnvironmentResource.CreateResourceIdentifier(    subscriptionId, resourceGroupName, serviceName, workspaceName, "production");
// Get API definition resource IDResourceIdentifier definitionResourceId = ApiCenterApiDefinitionResource.CreateResourceIdentifier(    subscriptionId, resourceGroupName, serviceName, workspaceName,     "orders-api", "v1-0-0", "openapi");
ApiCenterDeploymentData deploymentData = new ApiCenterDeploymentData{    Title = "Orders API - Production",    Description = "Production deployment of Orders API v1.0.0",    EnvironmentId = envResourceId,    DefinitionId = definitionResourceId,    State = ApiCenterDeploymentState.Active,    Server = new ApiCenterDeploymentServer    {        RuntimeUris = { new Uri("https://api.example.com/orders") }    }};
ArmOperation<ApiCenterDeploymentResource> operation = await deployments    .CreateOrUpdateAsync(WaitUntil.Completed, "orders-api-prod", deploymentData);

9. Create Metadata Schema

csharp
ApiCenterMetadataSchemaCollection schemas = service.GetApiCenterMetadataSchemas();
string jsonSchema = """{    "type": "object",    "properties": {        "team": {            "type": "string",            "title": "Owning Team"        },        "costCenter": {            "type": "string",            "title": "Cost Center"        },        "dataClassification": {            "type": "string",            "enum": ["public", "internal", "confidential"],            "title": "Data Classification"        }    },    "required": ["team"]}""";
ApiCenterMetadataSchemaData schemaData = new ApiCenterMetadataSchemaData{    Schema = jsonSchema,    AssignedTo =    {        new MetadataAssignment        {            Entity = MetadataAssignmentEntity.Api,            Required = true        }    }};
ArmOperation<ApiCenterMetadataSchemaResource> operation = await schemas    .CreateOrUpdateAsync(WaitUntil.Completed, "api-metadata", schemaData);

10. List and Search APIs

csharp
// List all APIs in a workspaceApiCenterWorkspaceResource workspace = await client    .GetApiCenterWorkspaceResource(workspaceResourceId)    .GetAsync();
await foreach (ApiCenterApiResource api in workspace.GetApiCenterApis()){    Console.WriteLine($"API: {api.Data.Title}");    Console.WriteLine($"  Kind: {api.Data.Kind}");    Console.WriteLine($"  Stage: {api.Data.LifecycleStage}");        // List versions    await foreach (ApiCenterApiVersionResource version in api.GetApiCenterApiVersions())    {        Console.WriteLine($"  Version: {version.Data.Title}");    }}
// List environmentsawait foreach (ApiCenterEnvironmentResource env in workspace.GetApiCenterEnvironments()){    Console.WriteLine($"Environment: {env.Data.Title} ({env.Data.Kind})");}
// List deploymentsawait foreach (ApiCenterDeploymentResource deployment in workspace.GetApiCenterDeployments()){    Console.WriteLine($"Deployment: {deployment.Data.Title}");    Console.WriteLine($"  State: {deployment.Data.State}");}

Key Types Reference

TypePurpose
ApiCenterServiceResourceAPI Center service instance
ApiCenterWorkspaceResourceLogical grouping of APIs
ApiCenterApiResourceIndividual API
ApiCenterApiVersionResourceVersion of an API
ApiCenterApiDefinitionResourceAPI specification (OpenAPI, etc.)
ApiCenterEnvironmentResourceDeployment environment
ApiCenterDeploymentResourceAPI deployment to environment
ApiCenterMetadataSchemaResourceCustom metadata schema
ApiKindrest, graphql, grpc, soap, webhook, websocket, mcp
ApiLifecycleStagedesign, development, testing, preview, production, deprecated, retired
ApiCenterEnvironmentKinddevelopment, testing, staging, production
ApiCenterDeploymentStateactive, inactive

Best Practices

  1. Organize with workspaces — Group APIs by team, domain, or product
  2. Use metadata schemas — Define custom properties for governance
  3. Track lifecycle stages — Keep API status current (design → production → deprecated)
  4. Document environments — Include onboarding instructions and portal URIs
  5. Version consistently — Use semantic versioning for API versions
  6. Import specifications — Upload OpenAPI/GraphQL specs for discovery
  7. Link deployments — Connect APIs to their runtime environments
  8. Use managed identity — Enable SystemAssigned identity for secure integrations

Error Handling

csharp
using Azure;
try{    ArmOperation<ApiCenterApiResource> operation = await apis        .CreateOrUpdateAsync(WaitUntil.Completed, "my-api", apiData);}catch (RequestFailedException ex) when (ex.Status == 409){    Console.WriteLine("API already exists with conflicting configuration");}catch (RequestFailedException ex) when (ex.Status == 400){    Console.WriteLine($"Invalid request: {ex.Message}");}catch (RequestFailedException ex){    Console.WriteLine($"Azure error: {ex.Status} - {ex.Message}");}

Related SDKs

SDKPurposeInstall
Azure.ResourceManager.ApiCenterAPI Center management (this SDK)dotnet add package Azure.ResourceManager.ApiCenter
Azure.ResourceManager.ApiManagementAPI gateway and policiesdotnet add package Azure.ResourceManager.ApiManagement

Reference Links

来源与署名

来源:microsoft/skills位于.github/plugins/azure-sdk-dotnet/skills/azure-mgmt-apicenter-dotnet提交354361d

许可证: MIT

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架