使用英语阅读

通过

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

Microsoft.CognitiveServices 帐户/部署

  • 项目
选择部署语言

Bicep 资源定义

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

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

资源格式

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

Bicep 
resource symbolicname 'Microsoft.CognitiveServices/accounts/deployments@2024-10-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'
    }
    versionUpgradeOption: 'string'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

属性值

DeploymentCapacitySettings

名字 描述 价值
designatedCapacity 指定的容量。 int

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

约束：
最小值 = 0

DeploymentModel

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

DeploymentProperties

名字 描述 价值
capacitySettings 仅供内部使用。 DeploymentCapacitySettings
currentCapacity 当前容量。 int
型 认知服务帐户部署模型的属性。 DeploymentModel
parentDeploymentName 父部署的名称。 字符串
raiPolicyName RAI 策略的名称。 字符串
scaleSettings 认知服务帐户部署模型的属性。 （已弃用，请改用 Deployment.sku。 DeploymentScaleSettings
versionUpgradeOption 部署模型版本升级选项。 “NoAutoUpgrade”
“OnceCurrentVersionExpired”
“OnceNewDefaultVersionAvailable”

DeploymentScaleSettings

名字 描述 价值
能力 部署容量。 int
scaleType 部署缩放类型。 “Manual”
“Standard”

DeploymentTags

名字 描述 价值

Microsoft.CognitiveServices/accounts/deployments

名字 描述 价值
名字 资源名称 string （必需）
父母 在 Bicep 中，可以为子资源指定父资源。 仅当子资源在父资源外部声明时，才需要添加此属性。

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

Sku

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

用法示例

Azure 快速入门示例

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

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

ARM 模板资源定义

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

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

资源格式

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

JSON 
{
  "type": "Microsoft.CognitiveServices/accounts/deployments",
  "apiVersion": "2024-10-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"
    },
    "versionUpgradeOption": "string"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

属性值

DeploymentCapacitySettings

名字 描述 价值
designatedCapacity 指定的容量。 int

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

约束：
最小值 = 0

DeploymentModel

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

DeploymentProperties

名字 描述 价值
capacitySettings 仅供内部使用。 DeploymentCapacitySettings
currentCapacity 当前容量。 int
型 认知服务帐户部署模型的属性。 DeploymentModel
parentDeploymentName 父部署的名称。 字符串
raiPolicyName RAI 策略的名称。 字符串
scaleSettings 认知服务帐户部署模型的属性。 （已弃用，请改用 Deployment.sku。 DeploymentScaleSettings
versionUpgradeOption 部署模型版本升级选项。 “NoAutoUpgrade”
“OnceCurrentVersionExpired”
“OnceNewDefaultVersionAvailable”

DeploymentScaleSettings

名字 描述 价值
能力 部署容量。 int
scaleType 部署缩放类型。 “Manual”
“Standard”

DeploymentTags

名字 描述 价值

Microsoft.CognitiveServices/accounts/deployments

名字 描述 价值
apiVersion API 版本 '2024-10-01'
名字 资源名称 string （必需）
性能 认知服务帐户部署的属性。 DeploymentProperties
sku 表示 SKU 的资源模型定义 Sku
标签 资源标记 标记名称和值的字典。 请参阅模板 中的 标记
类型 资源类型 “Microsoft.CognitiveServices/accounts/deployments”

Sku

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

用法示例

Azure 快速入门模板

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

模板 描述
基本代理设置 API 密钥

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

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

部署到 Azure 		此模板创建一个安全的 Azure AI Studio 环境，其中包含可靠的网络和标识安全限制。
使用用户托管标识 网络安全代理

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

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

Terraform （AzAPI 提供程序）资源定义

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

  • 资源组

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

资源格式

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

Terraform 
resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts/deployments@2024-10-01"
  name = "string"
  sku = {
    capacity = int
    family = "string"
    name = "string"
    size = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    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"
      }
      versionUpgradeOption = "string"
    }
  })
}

属性值

DeploymentCapacitySettings

名字 描述 价值
designatedCapacity 指定的容量。 int

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

约束：
最小值 = 0

DeploymentModel

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

DeploymentProperties

名字 描述 价值
capacitySettings 仅供内部使用。 DeploymentCapacitySettings
currentCapacity 当前容量。 int
型 认知服务帐户部署模型的属性。 DeploymentModel
parentDeploymentName 父部署的名称。 字符串
raiPolicyName RAI 策略的名称。 字符串
scaleSettings 认知服务帐户部署模型的属性。 （已弃用，请改用 Deployment.sku。 DeploymentScaleSettings
versionUpgradeOption 部署模型版本升级选项。 “NoAutoUpgrade”
“OnceCurrentVersionExpired”
“OnceNewDefaultVersionAvailable”

DeploymentScaleSettings

名字 描述 价值
能力 部署容量。 int
scaleType 部署缩放类型。 “Manual”
“Standard”

DeploymentTags

名字 描述 价值

Microsoft.CognitiveServices/accounts/deployments

名字 描述 价值
名字 资源名称 string （必需）
parent_id 此资源的父资源的 ID。 类型资源的 ID：帐户
性能 认知服务帐户部署的属性。 DeploymentProperties
sku 表示 SKU 的资源模型定义 Sku
标签 资源标记 标记名称和值的字典。
类型 资源类型 “Microsoft.CognitiveServices/accounts/deployments@2024-10-01”

Sku

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