你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：使用 ARM 模板创建 Azure AI 服务资源

项目
09/03/2024

本快速入门介绍如何使用 Azure 资源管理器模板（ARM 模板）创建 Azure AI 服务中的资源。

Azure AI 服务通过现成的预生成可定制 API 和模型，帮助开发人员和组织快速创建智能、前沿、面向市场且负责任的应用程序。应用程序示例包括对话、搜索、监视、翻译、语音、视觉和决策的自然语言处理。

提示

在 Azure AI Studio 中尝试 Azure AI 服务，包括 Azure OpenAI、内容安全、语音、视觉等。有关详细信息，请参阅什么是 Azure AI Studio？。

可采用常用开发语言通过 REST API 和客户端库 SDK 使用大部分 Azure AI 服务。有关详细信息，请参阅各服务的相关文档。

Azure 资源管理器模板是定义项目基础结构和配置的 JavaScript 对象表示法 (JSON) 文件。模板使用声明性语法。你可以在不编写用于创建部署的编程命令序列的情况下，描述预期部署。

先决条件

免费创建一个 Azure 订阅（如果没有）。

查看模板

本快速入门中使用的模板来自 Azure 快速入门模板。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.30.23.60470",
      "templateHash": "10147189867297702253"
    }
  },
  "parameters": {
    "aiServicesName": {
      "type": "string",
      "defaultValue": "[format('aiServices-{0}', uniqueString(resourceGroup().id))]",
      "metadata": {
        "description": "That name is the name of our application. It has to be unique.Type a name followed by your resource group name. (<name>-<resourceGroupName>)"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    },
    "sku": {
      "type": "string",
      "defaultValue": "S0",
      "allowedValues": [
        "S0"
      ]
    }
  },
  "resources": [
    {
      "type": "Microsoft.CognitiveServices/accounts",
      "apiVersion": "2023-05-01",
      "name": "[parameters('aiServicesName')]",
      "location": "[parameters('location')]",
      "identity": {
        "type": "SystemAssigned"
      },
      "sku": {
        "name": "[parameters('sku')]"
      },
      "kind": "AIServices",
      "properties": {
        "publicNetworkAccess": "Disabled",
        "networkAcls": {
          "defaultAction": "Deny"
        },
        "disableLocalAuth": true
      }
    }
  ]
}

Bicep 文件中定义了一个 Azure 资源。 Bicep 文件中的 kind 字段定义资源类型。

根据需要，将 sku 参数值更改为所需的定价实例。 sku 取决于所使用的资源 kind。例如，对于 Azure AI 语言服务，应使用 TextAnalytics。 TextAnalytics 种类使用 S 而不是 S0 作为 sku 值。

选择“部署到 Azure”按钮。

输入以下值。

值	说明
订阅	选择 Azure 订阅。
资源组	选择“新建”，输入资源组的唯一名称，然后选择“确定”。
区域	选择区域（例如美国东部）。
AI 服务名称	将该值替换为 Azure AI 服务资源的唯一名称。在下一部分验证部署时，需要使用该名称。
位置	替换为所选区域。
Sku	为资源选择定价层。

屏幕截图显示了用于创建资源的窗格。

选择“查看 + 创建”，然后选择“创建”。部署成功后，“转到资源”按钮将会可用。

从本地计算机运行以下脚本，或使用“试用”按钮从浏览器运行它。包括新资源组的名称和位置（例如 centralus），然后系统将使用 ARM 模板在该资源组中部署 Azure AI 服务资源。请记住你使用的名称。该名称稍后将用于验证部署。

注意

脚本中的 az deployment group create 命令需要 Azure CLI 2.6 或更高版本。要显示版本，请输入 az --version。有关详细信息，请参阅文档。

read -p "Enter a name for your new resource group:" resourceGroupName &&
read -p "Enter the location (i.e. centralus):" location &&
templateUri="https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.cognitiveservices/cognitive-services-universalkey/azuredeploy.json" &&
az group create --name $resourceGroupName --location "$location" &&
az deployment group create --resource-group $resourceGroupName --template-uri  $templateUri &&
echo "Press [ENTER] to continue ..." &&
read

提示

如果订阅不允许创建 Azure AI 服务资源，则可能需要使用 Azure 门户、PowerShell 命令或 Azure CLI 命令启用 Azure 资源提供程序的特权。如果你不是订阅所有者，请要求订阅所有者或具有管理员角色的人员为你完成注册。或者请求向你的帐户授予 /register/action 权限。

查看已部署的资源

Azure 门户
Azure CLI

部署完成后，可以选择“转到资源”按钮以查看新资源。通过以下方式也可找到该资源组：

从左侧窗格中选择“资源组”。
选择资源组名称。

运行以下脚本。包括之前创建的资源组的名称。

echo "Enter the resource group where the Azure AI services resource exists:" &&
read resourceGroupName &&
az cognitiveservices account list -g $resourceGroupName

清理资源

如果想要清理并移除 Azure AI 服务订阅，可以删除资源或资源组。删除资源组也会删除资源组中包含的任何其他资源。

Azure 门户
Azure CLI

在左侧窗格中，选择“资源组”以显示资源组的列表。
找到包含要删除的资源的资源组。
右键单击该资源组，并选择“删除资源组”，然后确认。