共用方式為


Microsoft.CognitiveServices 帳戶 2021-04-30

Bicep 資源定義

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

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

資源格式

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

resource symbolicname 'Microsoft.CognitiveServices/accounts@2021-04-30' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  kind: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {}
  }
  properties: {
    allowedFqdnList: [
      'string'
    ]
    apiProperties: {
      aadClientId: 'string'
      aadTenantId: 'string'
      eventHubConnectionString: 'string'
      qnaAzureSearchEndpointId: 'string'
      qnaAzureSearchEndpointKey: 'string'
      qnaRuntimeEndpoint: 'string'
      statisticsEnabled: bool
      storageAccountConnectionString: 'string'
      superUser: 'string'
      websiteName: 'string'
    }
    customSubDomainName: 'string'
    disableLocalAuth: bool
    encryption: {
      keySource: 'string'
      keyVaultProperties: {
        identityClientId: 'string'
        keyName: 'string'
        keyVaultUri: 'string'
        keyVersion: 'string'
      }
    }
    migrationToken: 'string'
    networkAcls: {
      defaultAction: 'string'
      ipRules: [
        {
          value: 'string'
        }
      ]
      virtualNetworkRules: [
        {
          id: 'string'
          ignoreMissingVnetServiceEndpoint: bool
          state: 'string'
        }
      ]
    }
    publicNetworkAccess: 'string'
    restore: bool
    restrictOutboundNetworkAccess: bool
    userOwnedStorage: [
      {
        identityClientId: 'string'
        resourceId: 'string'
      }
    ]
  }
}

屬性值

帳戶

名字 描述 價值
名字 資源名稱 字串 (必要)

字元限制:2-64

合法字元:
英數位元和連字元。

以英數位元開頭和結尾。
位置 資源所在的地理位置 字串
標籤 資源標籤。 標記名稱和值的字典。 請參閱範本中的 標籤
sku 代表 SKU 的資源模型定義 Sku
資源的Kind。 字串
身份 資源的身分識別。 身分識別
性能 認知服務帳戶的屬性。 AccountProperties

身份

名字 描述 價值
類型 識別類型。 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities 與資源相關聯的使用者指派身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 物件

AccountProperties

名字 描述 價值
allowedFqdnList string[]
apiProperties 特殊 API 的 API 屬性。 ApiProperties
customSubDomainName 用於令牌型驗證的選擇性子域名稱。 字串
disableLocalAuth bool
加密 此資源的加密屬性。 加密
migrationToken 資源移轉令牌。 字串
networkAcls 管理來自特定網路位置之輔助功能的規則集合。 NetworkRuleSet
publicNetworkAccess 此帳戶是否允許公用端點存取。 值為選擇性值,但如果傳入,則必須是 'Enabled' 或 'Disabled' 'Disabled'
'Enabled'
恢復 bool
restrictOutboundNetworkAccess bool
userOwnedStorage 此資源的記憶體帳戶。 UserOwnedStorage[]

ApiProperties

名字 描述 價值
aadClientId (僅限計量建議程式)Azure AD 用戶端識別碼(應用程式識別符)。 字串
aadTenantId (僅限計量建議程式)Azure AD 租用戶標識碼。 字串
eventHubConnectionString (僅限個人化)啟用 Bing 搜尋統計數據的旗標。 字串
qnaAzureSearchEndpointId (僅限 QnAMaker)QnAMaker 的 Azure 搜尋服務端點標識碼。 字串
qnaAzureSearchEndpointKey (僅限 QnAMaker)QnAMaker 的 Azure 搜尋服務端點密鑰。 字串
qnaRuntimeEndpoint (僅限 QnAMaker)QnAMaker 的運行時間端點。 字串
statisticsEnabled (僅限 Bing 搜尋)啟用 Bing 搜尋統計數據的旗標。 bool
storageAccountConnectionString (僅限個人化)記憶體帳戶連接字串。 字串
超級使用者 (僅限計量建議程式)Metrics Advisor 的進階使用者。 字串
websiteName (僅限計量建議程式)Metrics Advisor 的網站名稱。 字串

加密

名字 描述 價值
keySource 列舉 Encryption 的 keySource 可能值 'Microsoft.CognitiveServices'
'Microsoft.KeyVault'
keyVaultProperties KeyVault 的屬性 KeyVaultProperties

KeyVaultProperties

名字 描述 價值
identityClientId 字串
keyName KeyVault 中的金鑰名稱 字串
keyVaultUri KeyVault 的 URI 字串
keyVersion KeyVault 中的金鑰版本 字串

NetworkRuleSet

名字 描述 價值
defaultAction 沒有來自ipRules和 virtualNetworkRules 相符的規則時的默認動作。 只有在評估略過屬性之後,才會使用此屬性。 'Allow'
'Deny'
ipRules IP 位址規則的清單。 IpRule[]
virtualNetworkRules 虛擬網路規則的清單。 VirtualNetworkRule[]

IpRule

名字 描述 價值
價值 CIDR 表示法中的 IPv4 位址範圍,例如 '124.56.78.91' (簡單 IP 位址) 或 '124.56.78.0/24' (開頭為 124.56.78 的所有位址)。 字串 (必要)

VirtualNetworkRule

名字 描述 價值
id vnet 子網的完整資源標識符,例如 '/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'。 字串 (必要)
ignoreMissingVnetServiceEndpoint 忽略遺漏的 vnet 服務端點。 bool
取得虛擬網路規則的狀態。 字串

UserOwnedStorage

名字 描述 價值
identityClientId 字串
resourceId Microsoft.Storage 資源的完整資源標識符。 字串

Sku

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

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
部署 Azure AI 視覺資源

部署至 Azure
此範本會部署 Azure AI 視覺資源,讓每個開發人員都能觸手可及 AI,而不需要機器學習專業知識。
部署 Azure AI Translator 資源

部署至 Azure
此範本會部署 Azure AI Translator 資源,讓每個開發人員都能觸手可及 AI,而不需要機器學習專業知識。
部署 Azure AI 服務多服務資源

部署至 Azure
此範本會部署 Azure AI 服務資源,讓每個開發人員都能觸手可及 AI,而不需要機器學習專業知識。 只需要 API 呼叫,即可內嵌在應用程式中查看、聆聽、說話、搜尋、瞭解及加速決策的能力。
Azure AI Studio 基本設定

部署至 Azure
這組範本示範如何使用基本設定來設定 Azure AI Studio,這表示已啟用公用因特網存取、Microsoft受控密鑰進行加密,以及 AI 資源的Microsoft受控識別設定。
Azure AI Studio 基本設定

部署至 Azure
這組範本示範如何使用基本設定來設定 Azure AI Studio,這表示已啟用公用因特網存取、Microsoft受控密鑰進行加密,以及 AI 資源的Microsoft受控識別設定。
使用 Microsoft Entra ID Authentication Azure AI Studio

部署至 Azure
這組範本示範如何使用相依資源的 Microsoft Entra ID 驗證來設定 Azure AI Studio,例如 Azure AI 服務和 Azure 記憶體。

ARM 樣本資源定義

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

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

資源格式

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

{
  "type": "Microsoft.CognitiveServices/accounts",
  "apiVersion": "2021-04-30",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "kind": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {}
  },
  "properties": {
    "allowedFqdnList": [ "string" ],
    "apiProperties": {
      "aadClientId": "string",
      "aadTenantId": "string",
      "eventHubConnectionString": "string",
      "qnaAzureSearchEndpointId": "string",
      "qnaAzureSearchEndpointKey": "string",
      "qnaRuntimeEndpoint": "string",
      "statisticsEnabled": "bool",
      "storageAccountConnectionString": "string",
      "superUser": "string",
      "websiteName": "string"
    },
    "customSubDomainName": "string",
    "disableLocalAuth": "bool",
    "encryption": {
      "keySource": "string",
      "keyVaultProperties": {
        "identityClientId": "string",
        "keyName": "string",
        "keyVaultUri": "string",
        "keyVersion": "string"
      }
    },
    "migrationToken": "string",
    "networkAcls": {
      "defaultAction": "string",
      "ipRules": [
        {
          "value": "string"
        }
      ],
      "virtualNetworkRules": [
        {
          "id": "string",
          "ignoreMissingVnetServiceEndpoint": "bool",
          "state": "string"
        }
      ]
    },
    "publicNetworkAccess": "string",
    "restore": "bool",
    "restrictOutboundNetworkAccess": "bool",
    "userOwnedStorage": [
      {
        "identityClientId": "string",
        "resourceId": "string"
      }
    ]
  }
}

屬性值

帳戶

名字 描述 價值
類型 資源類型 'Microsoft.CognitiveServices/accounts'
apiVersion 資源 API 版本 '2021-04-30'
名字 資源名稱 字串 (必要)

字元限制:2-64

合法字元:
英數位元和連字元。

以英數位元開頭和結尾。
位置 資源所在的地理位置 字串
標籤 資源標籤。 標記名稱和值的字典。 請參閱範本中的 標籤
sku 代表 SKU 的資源模型定義 Sku
資源的Kind。 字串
身份 資源的身分識別。 身分識別
性能 認知服務帳戶的屬性。 AccountProperties

身份

名字 描述 價值
類型 識別類型。 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities 與資源相關聯的使用者指派身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 物件

AccountProperties

名字 描述 價值
allowedFqdnList string[]
apiProperties 特殊 API 的 API 屬性。 ApiProperties
customSubDomainName 用於令牌型驗證的選擇性子域名稱。 字串
disableLocalAuth bool
加密 此資源的加密屬性。 加密
migrationToken 資源移轉令牌。 字串
networkAcls 管理來自特定網路位置之輔助功能的規則集合。 NetworkRuleSet
publicNetworkAccess 此帳戶是否允許公用端點存取。 值為選擇性值,但如果傳入,則必須是 'Enabled' 或 'Disabled' 'Disabled'
'Enabled'
恢復 bool
restrictOutboundNetworkAccess bool
userOwnedStorage 此資源的記憶體帳戶。 UserOwnedStorage[]

ApiProperties

名字 描述 價值
aadClientId (僅限計量建議程式)Azure AD 用戶端識別碼(應用程式識別符)。 字串
aadTenantId (僅限計量建議程式)Azure AD 租用戶標識碼。 字串
eventHubConnectionString (僅限個人化)啟用 Bing 搜尋統計數據的旗標。 字串
qnaAzureSearchEndpointId (僅限 QnAMaker)QnAMaker 的 Azure 搜尋服務端點標識碼。 字串
qnaAzureSearchEndpointKey (僅限 QnAMaker)QnAMaker 的 Azure 搜尋服務端點密鑰。 字串
qnaRuntimeEndpoint (僅限 QnAMaker)QnAMaker 的運行時間端點。 字串
statisticsEnabled (僅限 Bing 搜尋)啟用 Bing 搜尋統計數據的旗標。 bool
storageAccountConnectionString (僅限個人化)記憶體帳戶連接字串。 字串
超級使用者 (僅限計量建議程式)Metrics Advisor 的進階使用者。 字串
websiteName (僅限計量建議程式)Metrics Advisor 的網站名稱。 字串

加密

名字 描述 價值
keySource 列舉 Encryption 的 keySource 可能值 'Microsoft.CognitiveServices'
'Microsoft.KeyVault'
keyVaultProperties KeyVault 的屬性 KeyVaultProperties

KeyVaultProperties

名字 描述 價值
identityClientId 字串
keyName KeyVault 中的金鑰名稱 字串
keyVaultUri KeyVault 的 URI 字串
keyVersion KeyVault 中的金鑰版本 字串

NetworkRuleSet

名字 描述 價值
defaultAction 沒有來自ipRules和 virtualNetworkRules 相符的規則時的默認動作。 只有在評估略過屬性之後,才會使用此屬性。 'Allow'
'Deny'
ipRules IP 位址規則的清單。 IpRule[]
virtualNetworkRules 虛擬網路規則的清單。 VirtualNetworkRule[]

IpRule

名字 描述 價值
價值 CIDR 表示法中的 IPv4 位址範圍,例如 '124.56.78.91' (簡單 IP 位址) 或 '124.56.78.0/24' (開頭為 124.56.78 的所有位址)。 字串 (必要)

VirtualNetworkRule

名字 描述 價值
id vnet 子網的完整資源標識符,例如 '/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'。 字串 (必要)
ignoreMissingVnetServiceEndpoint 忽略遺漏的 vnet 服務端點。 bool
取得虛擬網路規則的狀態。 字串

UserOwnedStorage

名字 描述 價值
identityClientId 字串
resourceId Microsoft.Storage 資源的完整資源標識符。 字串

Sku

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

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
部署 Azure AI 視覺資源

部署至 Azure
此範本會部署 Azure AI 視覺資源,讓每個開發人員都能觸手可及 AI,而不需要機器學習專業知識。
部署 Azure AI Translator 資源

部署至 Azure
此範本會部署 Azure AI Translator 資源,讓每個開發人員都能觸手可及 AI,而不需要機器學習專業知識。
部署 Azure AI 服務多服務資源

部署至 Azure
此範本會部署 Azure AI 服務資源,讓每個開發人員都能觸手可及 AI,而不需要機器學習專業知識。 只需要 API 呼叫,即可內嵌在應用程式中查看、聆聽、說話、搜尋、瞭解及加速決策的能力。
Azure AI Studio 基本設定

部署至 Azure
這組範本示範如何使用基本設定來設定 Azure AI Studio,這表示已啟用公用因特網存取、Microsoft受控密鑰進行加密,以及 AI 資源的Microsoft受控識別設定。
Azure AI Studio 基本設定

部署至 Azure
這組範本示範如何使用基本設定來設定 Azure AI Studio,這表示已啟用公用因特網存取、Microsoft受控密鑰進行加密,以及 AI 資源的Microsoft受控識別設定。
使用 Microsoft Entra ID Authentication Azure AI Studio

部署至 Azure
這組範本示範如何使用相依資源的 Microsoft Entra ID 驗證來設定 Azure AI Studio,例如 Azure AI 服務和 Azure 記憶體。

Terraform (AzAPI 提供者) 資源定義

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

  • 資源群組

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

資源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts@2021-04-30"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      allowedFqdnList = [
        "string"
      ]
      apiProperties = {
        aadClientId = "string"
        aadTenantId = "string"
        eventHubConnectionString = "string"
        qnaAzureSearchEndpointId = "string"
        qnaAzureSearchEndpointKey = "string"
        qnaRuntimeEndpoint = "string"
        statisticsEnabled = bool
        storageAccountConnectionString = "string"
        superUser = "string"
        websiteName = "string"
      }
      customSubDomainName = "string"
      disableLocalAuth = bool
      encryption = {
        keySource = "string"
        keyVaultProperties = {
          identityClientId = "string"
          keyName = "string"
          keyVaultUri = "string"
          keyVersion = "string"
        }
      }
      migrationToken = "string"
      networkAcls = {
        defaultAction = "string"
        ipRules = [
          {
            value = "string"
          }
        ]
        virtualNetworkRules = [
          {
            id = "string"
            ignoreMissingVnetServiceEndpoint = bool
            state = "string"
          }
        ]
      }
      publicNetworkAccess = "string"
      restore = bool
      restrictOutboundNetworkAccess = bool
      userOwnedStorage = [
        {
          identityClientId = "string"
          resourceId = "string"
        }
      ]
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
    kind = "string"
  })
}

屬性值

帳戶

名字 描述 價值
類型 資源類型 “Microsoft.CognitiveServices/accounts@2021-04-30”
名字 資源名稱 字串 (必要)

字元限制:2-64

合法字元:
英數位元和連字元。

以英數位元開頭和結尾。
位置 資源所在的地理位置 字串
parent_id 若要部署至資源群組,請使用該資源群組的標識碼。 字串 (必要)
標籤 資源標籤。 標記名稱和值的字典。
sku 代表 SKU 的資源模型定義 Sku
資源的Kind。 字串
身份 資源的身分識別。 身分識別
性能 認知服務帳戶的屬性。 AccountProperties

身份

名字 描述 價值
類型 識別類型。 “SystemAssigned”
“SystemAssigned, UserAssigned”
“UserAssigned”
identity_ids 與資源相關聯的使用者指派身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 使用者身分識別標識碼的陣列。

AccountProperties

名字 描述 價值
allowedFqdnList string[]
apiProperties 特殊 API 的 API 屬性。 ApiProperties
customSubDomainName 用於令牌型驗證的選擇性子域名稱。 字串
disableLocalAuth bool
加密 此資源的加密屬性。 加密
migrationToken 資源移轉令牌。 字串
networkAcls 管理來自特定網路位置之輔助功能的規則集合。 NetworkRuleSet
publicNetworkAccess 此帳戶是否允許公用端點存取。 值為選擇性值,但如果傳入,則必須是 'Enabled' 或 'Disabled' “Disabled”
“Enabled”
恢復 bool
restrictOutboundNetworkAccess bool
userOwnedStorage 此資源的記憶體帳戶。 UserOwnedStorage[]

ApiProperties

名字 描述 價值
aadClientId (僅限計量建議程式)Azure AD 用戶端識別碼(應用程式識別符)。 字串
aadTenantId (僅限計量建議程式)Azure AD 租用戶標識碼。 字串
eventHubConnectionString (僅限個人化)啟用 Bing 搜尋統計數據的旗標。 字串
qnaAzureSearchEndpointId (僅限 QnAMaker)QnAMaker 的 Azure 搜尋服務端點標識碼。 字串
qnaAzureSearchEndpointKey (僅限 QnAMaker)QnAMaker 的 Azure 搜尋服務端點密鑰。 字串
qnaRuntimeEndpoint (僅限 QnAMaker)QnAMaker 的運行時間端點。 字串
statisticsEnabled (僅限 Bing 搜尋)啟用 Bing 搜尋統計數據的旗標。 bool
storageAccountConnectionString (僅限個人化)記憶體帳戶連接字串。 字串
超級使用者 (僅限計量建議程式)Metrics Advisor 的進階使用者。 字串
websiteName (僅限計量建議程式)Metrics Advisor 的網站名稱。 字串

加密

名字 描述 價值
keySource 列舉 Encryption 的 keySource 可能值 “Microsoft.CognitiveServices”
“Microsoft.KeyVault”
keyVaultProperties KeyVault 的屬性 KeyVaultProperties

KeyVaultProperties

名字 描述 價值
identityClientId 字串
keyName KeyVault 中的金鑰名稱 字串
keyVaultUri KeyVault 的 URI 字串
keyVersion KeyVault 中的金鑰版本 字串

NetworkRuleSet

名字 描述 價值
defaultAction 沒有來自ipRules和 virtualNetworkRules 相符的規則時的默認動作。 只有在評估略過屬性之後,才會使用此屬性。 “Allow”
“Deny”
ipRules IP 位址規則的清單。 IpRule[]
virtualNetworkRules 虛擬網路規則的清單。 VirtualNetworkRule[]

IpRule

名字 描述 價值
價值 CIDR 表示法中的 IPv4 位址範圍,例如 '124.56.78.91' (簡單 IP 位址) 或 '124.56.78.0/24' (開頭為 124.56.78 的所有位址)。 字串 (必要)

VirtualNetworkRule

名字 描述 價值
id vnet 子網的完整資源標識符,例如 '/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'。 字串 (必要)
ignoreMissingVnetServiceEndpoint 忽略遺漏的 vnet 服務端點。 bool
取得虛擬網路規則的狀態。 字串

UserOwnedStorage

名字 描述 價值
identityClientId 字串
resourceId Microsoft.Storage 資源的完整資源標識符。 字串

Sku

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