快速入门：创建 API 中心 - Azure CLI

创建 API 中心以启动组织的 API 清单。 Azure API 中心支持在一个集中位置跟踪 API，以便进行发现、重用和治理。

创建 API 中心后，请按照教程中的步骤添加自定义元数据、API、版本、定义和其他信息。

先决条件

• 如果没有 Azure 订阅，请在开始之前创建一个 Azure 免费帐户。

• 在 Azure 订阅中至少分配有参与者角色或等效权限。

• 对于 Azure CLI：

  • 在 Azure Cloud Shell 中使用 Bash 环境。 有关详细信息，请参阅 Azure Cloud Shell 入门。

    

  • 如需在本地运行 CLI 参考命令，请安装 Azure CLI。 如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。 有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。

    • 如果使用的是本地安装，请使用 az login 命令登录 Azure CLI。 若要完成身份验证过程，请遵循终端中显示的步骤。 有关其他登录选项，请参阅 使用 Azure CLI 向 Azure 进行身份验证。

    • 出现提示时，请在首次使用时安装 Azure CLI 扩展。 有关扩展的详细信息，请参阅 使用和管理 Azure CLI 中的扩展。

    • 运行 az version 以查找安装的版本和依赖库。 若要升级到最新版本，请运行 az upgrade。

  注意

  az apic 命令需要 Azure CLI 扩展 apic-extension。 如果尚未使用 az apic 命令，则可以在运行第一个 az apic 命令时动态安装扩展，也可以手动安装扩展。 详细了解 Azure CLI 扩展。

  请参阅最新更改的发行说明和 apic-extension 中的更新。 某些功能可能需要预览版或特定版本的扩展。

注册 Microsoft.ApiCenter 提供程序

如果尚未注册，请在订阅中注册 Microsoft.ApiCenter 资源提供程序。 您只需注册资源提供程序一次。

若要使用 Azure CLI 在订阅中注册资源提供程序，请运行 az provider register 以下命令：

az provider register --namespace Microsoft.ApiCenter

你可以通过运行以下 az provider show 命令来检查注册状态。

az provider show --namespace Microsoft.ApiCenter

创建资源组

Azure API 中心实例（例如所有 Azure 资源）都必须部署到资源组中。 使用资源组可以组织和管理相关的 Azure 资源。

使用 az group create 命令创建资源组。 以下示例在“美国东部”位置创建名为“MyGroup”的组。

az group create --name MyGroup --location eastus

创建 API 中心

使用 az apic create 命令创建 API 中心。

以下示例在 MyGroup 资源组中创建名为 MyApiCenter 的 API 中心。 在此示例中，API 中心部署在“西欧”位置。 替换所选的 API 中心名称，并输入 API 中心的其中一个可用位置。

az apic create --name MyApiCenter --resource-group MyGroup --location westeurope

命令的输出与以下所示相似。 默认情况下，API 中心是在免费计划中创建的。

{
  "dataApiHostname": "myapicenter.data.westeurope.azure-apicenter.ms",
  "id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/mygroup/providers/Microsoft.ApiCenter/services/myapicenter",
  "location": "westeurope",
  "name": "myapicenter",
  "resourceGroup": "mygroup",
  "sku": {
    "name": "Free"
  },
  "systemData": {
    "createdAt": "2024-06-22T21:40:35.2541624Z",
    "lastModifiedAt": "2024-06-22T21:40:35.2541624Z"
  },
  "tags": {},
  "type": "Microsoft.ApiCenter/services"
}

部署后，API 中心可供你使用！

后续步骤

现在可以开始将信息添加到 API 中心的清单。 为了帮助整理 API 和其他信息，请首先在 API 中心定义自定义元数据。