共用方式為

Microsoft.CognitiveServices 帳戶/部署 2024-04-01-preview

  • 發行項

Bicep 資源定義

帳戶/部署資源類型可以使用目標作業來部署：

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.CognitiveServices/accounts/deployments 資源，請將下列 Bicep 新增至範本。

resource symbolicname 'Microsoft.CognitiveServices/accounts/deployments@2024-04-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    capacitySettings: {
      designatedCapacity: int
      priority: int
    }
    currentCapacity: int
    model: {
      format: 'string'
      name: 'string'
      source: 'string'
      version: '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 資源識別碼。 字串
版本 自選。 部署模型版本。 如果未指定版本，則會指派預設版本。 不同模型的預設版本不同，而且當有新版本可供模型使用時，可能會變更。 您可以從清單模型 API 找到模型的預設版本。 字串

DeploymentProperties

名字 描述 價值
capacitySettings 僅限內部使用。 DeploymentCapacitySettings
currentCapacity 目前的容量。 int
型 認知服務帳戶部署模型的屬性。 DeploymentModel
raiPolicyName RAI 原則的名稱。 字串
scaleSettings 認知服務帳戶部署模型的屬性。 （已被取代，請改用 Deployment.sku。） DeploymentScaleSettings
versionUpgradeOption 部署模型版本升級選項。 'NoAutoUpgrade'
'OnceCurrentVersionExpired'
'OnceNewDefaultVersionAvailable'

DeploymentScaleSettings

名字 描述 價值
能力 部署容量。 int
scaleType 部署調整類型。 'Manual'
'Standard'

DeploymentTags

名字 描述 價值

Microsoft.CognitiveServices/accounts/deployments

名字 描述 價值
名字 資源名稱 字串 （必要）
父母 在 Bicep 中，您可以指定子資源的父資源。 只有在父資源外部宣告子資源時，才需要新增這個屬性。

如需詳細資訊，請參閱 父資源外部的子資源。		 類型的資源符號名稱：帳戶
性能 認知服務帳戶部署的屬性。 DeploymentProperties
sku 代表 SKU 的資源模型定義 Sku
標籤 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤

Sku

名字 描述 價值
能力 如果 SKU 支援相應放大/縮小，則應該包含容量整數。 如果資源無法相應放大/縮小，可能會省略此專案。 int
家庭 如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。 字串
名字 SKU 的名稱。 例如 - P3。 通常是字母+數位碼 字串 （必要）
大小 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 代理程式服務，這表示已啟用專案/中樞連線和公用因特網存取的受控識別驗證。 代理程式會使用客戶擁有的單一租用戶搜尋和記憶體資源。 透過此設定，您可以完全控制這些資源並查看這些資源，但會根據您的使用量產生成本。

ARM 樣本資源定義

帳戶/部署資源類型可以使用目標作業來部署：

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.CognitiveServices/accounts/deployments 資源，請將下列 JSON 新增至範本。

{
  "type": "Microsoft.CognitiveServices/accounts/deployments",
  "apiVersion": "2024-04-01-preview",
  "name": "string",
  "properties": {
    "capacitySettings": {
      "designatedCapacity": "int",
      "priority": "int"
    },
    "currentCapacity": "int",
    "model": {
      "format": "string",
      "name": "string",
      "source": "string",
      "version": "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 資源識別碼。 字串
版本 自選。 部署模型版本。 如果未指定版本，則會指派預設版本。 不同模型的預設版本不同，而且當有新版本可供模型使用時，可能會變更。 您可以從清單模型 API 找到模型的預設版本。 字串

DeploymentProperties

名字 描述 價值
capacitySettings 僅限內部使用。 DeploymentCapacitySettings
currentCapacity 目前的容量。 int
型 認知服務帳戶部署模型的屬性。 DeploymentModel
raiPolicyName RAI 原則的名稱。 字串
scaleSettings 認知服務帳戶部署模型的屬性。 （已被取代，請改用 Deployment.sku。） DeploymentScaleSettings
versionUpgradeOption 部署模型版本升級選項。 'NoAutoUpgrade'
'OnceCurrentVersionExpired'
'OnceNewDefaultVersionAvailable'

DeploymentScaleSettings

名字 描述 價值
能力 部署容量。 int
scaleType 部署調整類型。 'Manual'
'Standard'

DeploymentTags

名字 描述 價值

Microsoft.CognitiveServices/accounts/deployments

名字 描述 價值
apiVersion API 版本 '2024-04-01-preview'
名字 資源名稱 字串 （必要）
性能 認知服務帳戶部署的屬性。 DeploymentProperties
sku 代表 SKU 的資源模型定義 Sku
標籤 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤
類型 資源類型 'Microsoft.CognitiveServices/accounts/deployments'

Sku

名字 描述 價值
能力 如果 SKU 支援相應放大/縮小，則應該包含容量整數。 如果資源無法相應放大/縮小，可能會省略此專案。 int
家庭 如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。 字串
名字 SKU 的名稱。 例如 - P3。 通常是字母+數位碼 字串 （必要）
大小 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 代理程式服務，這表示已啟用專案/中樞連線和公用因特網存取的受控識別驗證。 代理程式會使用客戶擁有的單一租用戶搜尋和記憶體資源。 透過此設定，您可以完全控制這些資源並查看這些資源，但會根據您的使用量產生成本。

Terraform （AzAPI 提供者） 資源定義

帳戶/部署資源類型可以使用目標作業來部署：

  • 資源群組

如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.CognitiveServices/accounts/deployments 資源，請將下列 Terraform 新增至您的範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts/deployments@2024-04-01-preview"
  name = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      capacitySettings = {
        designatedCapacity = int
        priority = int
      }
      currentCapacity = int
      model = {
        format = "string"
        name = "string"
        source = "string"
        version = "string"
      }
      raiPolicyName = "string"
      scaleSettings = {
        capacity = int
        scaleType = "string"
      }
      versionUpgradeOption = "string"
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

屬性值

DeploymentCapacitySettings

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

約束：
最小值 = 0
優先權 此容量設定的優先順序。 int

約束：
最小值 = 0

DeploymentModel

名字 描述 價值
格式 部署模型格式。 字串
名字 部署模型名稱。 字串
源 自選。 部署模型來源 ARM 資源識別碼。 字串
版本 自選。 部署模型版本。 如果未指定版本，則會指派預設版本。 不同模型的預設版本不同，而且當有新版本可供模型使用時，可能會變更。 您可以從清單模型 API 找到模型的預設版本。 字串

DeploymentProperties

名字 描述 價值
capacitySettings 僅限內部使用。 DeploymentCapacitySettings
currentCapacity 目前的容量。 int
型 認知服務帳戶部署模型的屬性。 DeploymentModel
raiPolicyName RAI 原則的名稱。 字串
scaleSettings 認知服務帳戶部署模型的屬性。 （已被取代，請改用 Deployment.sku。） DeploymentScaleSettings
versionUpgradeOption 部署模型版本升級選項。 'NoAutoUpgrade'
'OnceCurrentVersionExpired'
'OnceNewDefaultVersionAvailable'

DeploymentScaleSettings

名字 描述 價值
能力 部署容量。 int
scaleType 部署調整類型。 'Manual'
'Standard'

DeploymentTags

名字 描述 價值

Microsoft.CognitiveServices/accounts/deployments

名字 描述 價值
名字 資源名稱 字串 （必要）
parent_id 此資源為父系之資源的標識碼。 類型的資源標識碼：帳戶
性能 認知服務帳戶部署的屬性。 DeploymentProperties
sku 代表 SKU 的資源模型定義 Sku
標籤 資源標籤 標記名稱和值的字典。
類型 資源類型 “Microsoft.CognitiveServices/accounts/deployments@2024-04-01-preview”

Sku

名字 描述 價值
能力 如果 SKU 支援相應放大/縮小，則應該包含容量整數。 如果資源無法相應放大/縮小，可能會省略此專案。 int
家庭 如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。 字串
名字 SKU 的名稱。 例如 - P3。 通常是字母+數位碼 字串 （必要）
大小 SKU 大小。 當名稱欄位是階層和其他一些值的組合時，這會是獨立程序代碼。 字串
層 如果服務有一個以上的層級，但 PUT 上不需要此欄位，則資源提供者必須實作此字段。 'Basic'
'Enterprise'
'Free'
'Premium'
'Standard'