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

Microsoft.CognitiveServices 帐户/部署 2022-03-01

Bicep 资源定义

可以使用目标作部署帐户/部署资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.CognitiveServices/accounts/deployments 资源,请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.CognitiveServices/accounts/deployments@2022-03-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    model: {
      format: 'string'
      name: 'string'
      version: 'string'
    }
    scaleSettings: {
      capacity: int
      scaleType: 'string'
    }
  }
}

属性值

Microsoft.CognitiveServices/accounts/deployments

名称 DESCRIPTION 价值
姓名 资源名称 string (必需)
父级 在 Bicep 中,可以为子资源指定父资源。 仅当子资源在父资源外部声明时,才需要添加此属性。

有关详细信息,请参阅 父资源外部的子资源
类型资源的符号名称:帐户
属性 认知服务帐户部署的属性。 部署属性

部署模型

名称 DESCRIPTION 价值
格式 部署模型格式。 字符串
姓名 部署模型名称。 字符串
版本 部署模型版本。 字符串

部署属性

名称 DESCRIPTION 价值
模型 认知服务帐户部署模型的属性。 部署模型
scaleSettings (缩放设置) 认知服务帐户部署模型的属性。 部署ScaleSettings

部署ScaleSettings

名称 DESCRIPTION 价值
产能 部署容量。 整数 (int)
scaleType 部署缩放类型。 “Manual”
“Standard”

用法示例

Azure 快速入门示例

以下 Azure 快速入门模板 包含用于部署此资源类型的 Bicep 示例。

Bicep 文件 DESCRIPTION
基本代理设置 API 密钥 此模板集演示如何使用 API 密钥身份验证为 AI 服务/AOAI 连接设置基本设置 Azure AI 代理服务。 代理使用完全由Microsoft管理的多租户搜索和存储资源。 无法查看或控制这些基础 Azure 资源。
基本代理设置标识 此模板集演示如何使用 AI 服务/AOAI 连接的托管标识身份验证设置基本设置 Azure AI 代理服务。 代理使用完全由Microsoft管理的多租户搜索和存储资源。 无法查看或控制这些基础 Azure 资源。
使用托管虚拟网络部署 Secure AI Foundry 此模板创建具有强大网络和标识安全限制的安全 Azure AI Foundry 环境。
使用用户托管标识 网络安全代理 此模板集演示如何使用用户托管标识身份验证为 AI 服务/AOAI 连接设置虚拟网络隔离的 Azure AI 代理服务,以及专用网络链接,以将代理连接到安全数据。
标准代理设置 此模板集演示如何使用标准设置设置设置 Azure AI 代理服务,这意味着已启用项目/中心连接的托管标识身份验证和公共 Internet 访问。 代理使用客户拥有的单租户搜索和存储资源。 通过此设置,可以完全控制这些资源并查看这些资源,但会根据使用情况产生成本。

ARM 模板资源定义

可以使用目标作部署帐户/部署资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.CognitiveServices/accounts/deployments 资源,请将以下 JSON 添加到模板。

{
  "type": "Microsoft.CognitiveServices/accounts/deployments",
  "apiVersion": "2022-03-01",
  "name": "string",
  "properties": {
    "model": {
      "format": "string",
      "name": "string",
      "version": "string"
    },
    "scaleSettings": {
      "capacity": "int",
      "scaleType": "string"
    }
  }
}

属性值

Microsoft.CognitiveServices/accounts/deployments

名称 DESCRIPTION 价值
apiVersion API 版本 '2022-03-01'
姓名 资源名称 string (必需)
属性 认知服务帐户部署的属性。 部署属性
类型 资源类型 “Microsoft.CognitiveServices/accounts/deployments”

部署模型

名称 DESCRIPTION 价值
格式 部署模型格式。 字符串
姓名 部署模型名称。 字符串
版本 部署模型版本。 字符串

部署属性

名称 DESCRIPTION 价值
模型 认知服务帐户部署模型的属性。 部署模型
scaleSettings (缩放设置) 认知服务帐户部署模型的属性。 部署ScaleSettings

部署ScaleSettings

名称 DESCRIPTION 价值
产能 部署容量。 整数 (int)
scaleType 部署缩放类型。 “Manual”
“Standard”

用法示例

Azure 快速入门模板

以下 Azure 快速入门模板 部署此资源类型。

模板 DESCRIPTION
基本代理设置 API 密钥

部署到 Azure
此模板集演示如何使用 API 密钥身份验证为 AI 服务/AOAI 连接设置基本设置 Azure AI 代理服务。 代理使用完全由Microsoft管理的多租户搜索和存储资源。 无法查看或控制这些基础 Azure 资源。
基本代理设置标识

部署到 Azure
此模板集演示如何使用 AI 服务/AOAI 连接的托管标识身份验证设置基本设置 Azure AI 代理服务。 代理使用完全由Microsoft管理的多租户搜索和存储资源。 无法查看或控制这些基础 Azure 资源。
使用托管虚拟网络部署 Secure AI Foundry

部署到 Azure
此模板创建具有强大网络和标识安全限制的安全 Azure AI Foundry 环境。
使用用户托管标识 网络安全代理

部署到 Azure
此模板集演示如何使用用户托管标识身份验证为 AI 服务/AOAI 连接设置虚拟网络隔离的 Azure AI 代理服务,以及专用网络链接,以将代理连接到安全数据。
标准代理设置

部署到 Azure
此模板集演示如何使用标准设置设置设置 Azure AI 代理服务,这意味着已启用项目/中心连接的托管标识身份验证和公共 Internet 访问。 代理使用客户拥有的单租户搜索和存储资源。 通过此设置,可以完全控制这些资源并查看这些资源,但会根据使用情况产生成本。

Terraform (AzAPI 提供程序)资源定义

可以使用目标作部署帐户/部署资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.CognitiveServices/accounts/deployments 资源,请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts/deployments@2022-03-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      model = {
        format = "string"
        name = "string"
        version = "string"
      }
      scaleSettings = {
        capacity = int
        scaleType = "string"
      }
    }
  }
}

属性值

Microsoft.CognitiveServices/accounts/deployments

名称 DESCRIPTION 价值
姓名 资源名称 string (必需)
parent_id 此资源的父资源的 ID。 类型资源的 ID:帐户
属性 认知服务帐户部署的属性。 部署属性
类型 资源类型 “Microsoft.CognitiveServices/accounts/deployments@2022-03-01”

部署模型

名称 DESCRIPTION 价值
格式 部署模型格式。 字符串
姓名 部署模型名称。 字符串
版本 部署模型版本。 字符串

部署属性

名称 DESCRIPTION 价值
模型 认知服务帐户部署模型的属性。 部署模型
scaleSettings (缩放设置) 认知服务帐户部署模型的属性。 部署ScaleSettings

部署ScaleSettings

名称 DESCRIPTION 价值
产能 部署容量。 整数 (int)
scaleType 部署缩放类型。 “Manual”
“Standard”

用法示例

Terraform 示例

部署认知服务帐户部署的基本示例。

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0003"
}

variable "location" {
  type    = string
  default = "eastus"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "account" {
  type      = "Microsoft.CognitiveServices/accounts@2022-10-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location

  body = {
    identity = {
      type                   = "None"
      userAssignedIdentities = null
    }
    kind = "OpenAI"
    properties = {
      disableLocalAuth              = false
      dynamicThrottlingEnabled      = false
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = false
    }
    sku = {
      name = "S0"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "deployment" {
  type      = "Microsoft.CognitiveServices/accounts/deployments@2023-05-01"
  name      = "testdep"
  parent_id = azapi_resource.account.id
  body = {
    properties = {
      model = {
        format = "OpenAI"
        name   = "text-embedding-ada-002"
      }
    }
  }
}