你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
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 密钥 |
此模板集演示如何使用 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 访问。 代理使用客户拥有的单租户搜索和存储资源。 通过此设置,可以完全控制这些资源并查看这些资源,但会根据使用情况产生成本。 |
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"
}
}
}
}