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

Microsoft.CognitiveServices 帐户/部署

Bicep 资源定义

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

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

资源格式

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

resource symbolicname 'Microsoft.CognitiveServices/accounts/deployments@2025-09-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    capacitySettings: {
      designatedCapacity: int
      priority: int
    }
    currentCapacity: int
    model: {
      format: 'string'
      name: 'string'
      publisher: 'string'
      source: 'string'
      sourceAccount: 'string'
      version: 'string'
    }
    parentDeploymentName: 'string'
    raiPolicyName: 'string'
    scaleSettings: {
      capacity: int
      scaleType: 'string'
    }
    spilloverDeploymentName: 'string'
    versionUpgradeOption: 'string'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

属性值

Microsoft.CognitiveServices/accounts/deployments

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

有关详细信息,请参阅 父资源外部的子资源
类型资源的符号名称:帐户
属性 认知服务帐户部署的属性。 部署属性
SKU 表示 SKU 的资源模型定义 SKU
标签 资源标记 标记名称和值的字典。 请参阅模板 中的 标记

DeploymentCapacitySettings

名称 DESCRIPTION 价值
指定容量 指定的容量。 int

约束:
最小值 = 0
优先级 此容量设置的优先级。 int

约束:
最小值 = 0

部署模型

名称 DESCRIPTION 价值
格式 部署模型格式。 字符串
姓名 部署模型名称。 字符串
发布服务器 部署模型发布者。 字符串
可选。 部署模型源 ARM 资源 ID。 字符串
sourceAccount 可选。 模型的源,另一个 Microsoft.CognitiveServices 帐户 ARM 资源 ID。 字符串
版本 可选。 部署模型版本。 如果未指定版本,则会分配默认版本。 对于不同的模型,默认版本不同,当有可用于模型的新版本时,可能会更改。 可以从列表模型 API 找到模型的默认版本。 字符串

部署属性

名称 DESCRIPTION 价值
capacitySettings 仅供内部使用。 DeploymentCapacitySettings
currentCapacity 当前容量。 整数 (int)
模型 认知服务帐户部署模型的属性。 部署模型
parentDeploymentName (父部署名称) 父部署的名称。 字符串
raiPolicy名称 RAI 策略的名称。 字符串
scaleSettings (缩放设置) 认知服务帐户部署模型的属性。 (已弃用,请改用 Deployment.sku。 部署ScaleSettings
spilloverDeploymentName (溢出部署名称) 指定当请求因达到当前部署吞吐量限制而受到限制时,应为请求提供服务的部署名称。 字符串
versionUpgradeOption 版本 部署模型版本升级选项。 “NoAutoUpgrade”
“OnceCurrentVersionExpired”
“OnceNewDefaultVersionAvailable”

部署ScaleSettings

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

部署标签

名称 DESCRIPTION 价值

SKU

名称 DESCRIPTION 价值
产能 如果 SKU 支持横向扩展/缩减,则应包含容量整数。 如果资源无法横向扩展/缩小,则可能会省略此范围。 整数 (int)
家庭 如果服务具有不同代的硬件(对于同一 SKU,则可以在此处捕获)。 字符串
姓名 SKU 的名称。 例 - P3。 它通常是字母+数字代码 string (必需)
大小 SKU 大小。 当名称字段是层和其他一些值的组合时,这将是独立的代码。 字符串
分层 如果服务具有多个层,但在 PUT 上不需要,则需要资源提供程序实现此字段。 “Basic”
“Enterprise”
“Free”
“Premium”
“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": "2025-09-01",
  "name": "string",
  "properties": {
    "capacitySettings": {
      "designatedCapacity": "int",
      "priority": "int"
    },
    "currentCapacity": "int",
    "model": {
      "format": "string",
      "name": "string",
      "publisher": "string",
      "source": "string",
      "sourceAccount": "string",
      "version": "string"
    },
    "parentDeploymentName": "string",
    "raiPolicyName": "string",
    "scaleSettings": {
      "capacity": "int",
      "scaleType": "string"
    },
    "spilloverDeploymentName": "string",
    "versionUpgradeOption": "string"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

属性值

Microsoft.CognitiveServices/accounts/deployments

名称 DESCRIPTION 价值
apiVersion API 版本 '2025-09-01'
姓名 资源名称 string (必需)
属性 认知服务帐户部署的属性。 部署属性
SKU 表示 SKU 的资源模型定义 SKU
标签 资源标记 标记名称和值的字典。 请参阅模板 中的 标记
类型 资源类型 “Microsoft.CognitiveServices/accounts/deployments”

DeploymentCapacitySettings

名称 DESCRIPTION 价值
指定容量 指定的容量。 int

约束:
最小值 = 0
优先级 此容量设置的优先级。 int

约束:
最小值 = 0

部署模型

名称 DESCRIPTION 价值
格式 部署模型格式。 字符串
姓名 部署模型名称。 字符串
发布服务器 部署模型发布者。 字符串
可选。 部署模型源 ARM 资源 ID。 字符串
sourceAccount 可选。 模型的源,另一个 Microsoft.CognitiveServices 帐户 ARM 资源 ID。 字符串
版本 可选。 部署模型版本。 如果未指定版本,则会分配默认版本。 对于不同的模型,默认版本不同,当有可用于模型的新版本时,可能会更改。 可以从列表模型 API 找到模型的默认版本。 字符串

部署属性

名称 DESCRIPTION 价值
capacitySettings 仅供内部使用。 DeploymentCapacitySettings
currentCapacity 当前容量。 整数 (int)
模型 认知服务帐户部署模型的属性。 部署模型
parentDeploymentName (父部署名称) 父部署的名称。 字符串
raiPolicy名称 RAI 策略的名称。 字符串
scaleSettings (缩放设置) 认知服务帐户部署模型的属性。 (已弃用,请改用 Deployment.sku。 部署ScaleSettings
spilloverDeploymentName (溢出部署名称) 指定当请求因达到当前部署吞吐量限制而受到限制时,应为请求提供服务的部署名称。 字符串
versionUpgradeOption 版本 部署模型版本升级选项。 “NoAutoUpgrade”
“OnceCurrentVersionExpired”
“OnceNewDefaultVersionAvailable”

部署ScaleSettings

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

部署标签

名称 DESCRIPTION 价值

SKU

名称 DESCRIPTION 价值
产能 如果 SKU 支持横向扩展/缩减,则应包含容量整数。 如果资源无法横向扩展/缩小,则可能会省略此范围。 整数 (int)
家庭 如果服务具有不同代的硬件(对于同一 SKU,则可以在此处捕获)。 字符串
姓名 SKU 的名称。 例 - P3。 它通常是字母+数字代码 string (必需)
大小 SKU 大小。 当名称字段是层和其他一些值的组合时,这将是独立的代码。 字符串
分层 如果服务具有多个层,但在 PUT 上不需要,则需要资源提供程序实现此字段。 “Basic”
“Enterprise”
“Free”
“Premium”
“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@2025-09-01"
  name = "string"
  parent_id = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      capacitySettings = {
        designatedCapacity = int
        priority = int
      }
      currentCapacity = int
      model = {
        format = "string"
        name = "string"
        publisher = "string"
        source = "string"
        sourceAccount = "string"
        version = "string"
      }
      parentDeploymentName = "string"
      raiPolicyName = "string"
      scaleSettings = {
        capacity = int
        scaleType = "string"
      }
      spilloverDeploymentName = "string"
      versionUpgradeOption = "string"
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

属性值

Microsoft.CognitiveServices/accounts/deployments

名称 DESCRIPTION 价值
姓名 资源名称 string (必需)
parent_id 此资源的父资源的 ID。 类型资源的 ID:帐户
属性 认知服务帐户部署的属性。 部署属性
SKU 表示 SKU 的资源模型定义 SKU
标签 资源标记 标记名称和值的字典。
类型 资源类型 “Microsoft.CognitiveServices/accounts/deployments@2025-09-01”

DeploymentCapacitySettings

名称 DESCRIPTION 价值
指定容量 指定的容量。 int

约束:
最小值 = 0
优先级 此容量设置的优先级。 int

约束:
最小值 = 0

部署模型

名称 DESCRIPTION 价值
格式 部署模型格式。 字符串
姓名 部署模型名称。 字符串
发布服务器 部署模型发布者。 字符串
可选。 部署模型源 ARM 资源 ID。 字符串
sourceAccount 可选。 模型的源,另一个 Microsoft.CognitiveServices 帐户 ARM 资源 ID。 字符串
版本 可选。 部署模型版本。 如果未指定版本,则会分配默认版本。 对于不同的模型,默认版本不同,当有可用于模型的新版本时,可能会更改。 可以从列表模型 API 找到模型的默认版本。 字符串

部署属性

名称 DESCRIPTION 价值
capacitySettings 仅供内部使用。 DeploymentCapacitySettings
currentCapacity 当前容量。 整数 (int)
模型 认知服务帐户部署模型的属性。 部署模型
parentDeploymentName (父部署名称) 父部署的名称。 字符串
raiPolicy名称 RAI 策略的名称。 字符串
scaleSettings (缩放设置) 认知服务帐户部署模型的属性。 (已弃用,请改用 Deployment.sku。 部署ScaleSettings
spilloverDeploymentName (溢出部署名称) 指定当请求因达到当前部署吞吐量限制而受到限制时,应为请求提供服务的部署名称。 字符串
versionUpgradeOption 版本 部署模型版本升级选项。 “NoAutoUpgrade”
“OnceCurrentVersionExpired”
“OnceNewDefaultVersionAvailable”

部署ScaleSettings

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

部署标签

名称 DESCRIPTION 价值

SKU

名称 DESCRIPTION 价值
产能 如果 SKU 支持横向扩展/缩减,则应包含容量整数。 如果资源无法横向扩展/缩小,则可能会省略此范围。 整数 (int)
家庭 如果服务具有不同代的硬件(对于同一 SKU,则可以在此处捕获)。 字符串
姓名 SKU 的名称。 例 - P3。 它通常是字母+数字代码 string (必需)
大小 SKU 大小。 当名称字段是层和其他一些值的组合时,这将是独立的代码。 字符串
分层 如果服务具有多个层,但在 PUT 上不需要,则需要资源提供程序实现此字段。 “Basic”
“Enterprise”
“Free”
“Premium”
“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"
      }
    }
  }
}