Microsoft.CognitiveServices 帐户

Bicep 资源定义

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

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

资源格式

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

resource symbolicname 'Microsoft.CognitiveServices/accounts@2025-09-01' = {
  scope: resourceSymbolicName or scope
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    allowedFqdnList: [
      'string'
    ]
    allowProjectManagement: bool
    amlWorkspace: {
      identityClientId: 'string'
      resourceId: 'string'
    }
    apiProperties: {
      aadClientId: 'string'
      aadTenantId: 'string'
      eventHubConnectionString: 'string'
      qnaAzureSearchEndpointId: 'string'
      qnaAzureSearchEndpointKey: 'string'
      qnaRuntimeEndpoint: 'string'
      statisticsEnabled: bool
      storageAccountConnectionString: 'string'
      superUser: 'string'
      websiteName: 'string'
    }
    associatedProjects: [
      'string'
    ]
    customSubDomainName: 'string'
    defaultProject: 'string'
    disableLocalAuth: bool
    dynamicThrottlingEnabled: bool
    encryption: {
      keySource: 'string'
      keyVaultProperties: {
        identityClientId: 'string'
        keyName: 'string'
        keyVaultUri: 'string'
        keyVersion: 'string'
      }
    }
    locations: {
      regions: [
        {
          customsubdomain: 'string'
          name: 'string'
          value: int
        }
      ]
      routingMethod: 'string'
    }
    migrationToken: 'string'
    networkAcls: {
      bypass: 'string'
      defaultAction: 'string'
      ipRules: [
        {
          value: 'string'
        }
      ]
      virtualNetworkRules: [
        {
          id: 'string'
          ignoreMissingVnetServiceEndpoint: bool
          state: 'string'
        }
      ]
    }
    networkInjections: [
      {
        scenario: 'string'
        subnetArmId: 'string'
        useMicrosoftManagedNetwork: bool
      }
    ]
    publicNetworkAccess: 'string'
    raiMonitorConfig: {
      adxStorageResourceId: 'string'
      identityClientId: 'string'
    }
    restore: bool
    restrictOutboundNetworkAccess: bool
    storedCompletionsDisabled: bool
    userOwnedStorage: [
      {
        identityClientId: 'string'
        resourceId: 'string'
      }
    ]
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

属性值

Microsoft.CognitiveServices/accounts（微软认知服务/帐户）

AccountProperties

AccountTags 账户标签

ApiProperties

加密

身份

IdentityUserAssignedIdentities

IpRule （英语）

KeyVaultProperties

多Region设置

网络注入

NetworkRuleSet 网络规则集

RaiMonitorConfig

RegionSetting

SKU

UserAssignedIdentity

UserOwnedAmlWorkspace

UserOwnedStorage

VirtualNetworkRule （虚拟网络规则）

用法示例

Azure 验证模块

以下 Azure 验证模块 可用于部署此资源类型。

Azure 快速入门示例

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

ARM 模板资源定义

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

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

资源格式

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

{
  "type": "Microsoft.CognitiveServices/accounts",
  "apiVersion": "2025-09-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "allowedFqdnList": [ "string" ],
    "allowProjectManagement": "bool",
    "amlWorkspace": {
      "identityClientId": "string",
      "resourceId": "string"
    },
    "apiProperties": {
      "aadClientId": "string",
      "aadTenantId": "string",
      "eventHubConnectionString": "string",
      "qnaAzureSearchEndpointId": "string",
      "qnaAzureSearchEndpointKey": "string",
      "qnaRuntimeEndpoint": "string",
      "statisticsEnabled": "bool",
      "storageAccountConnectionString": "string",
      "superUser": "string",
      "websiteName": "string"
    },
    "associatedProjects": [ "string" ],
    "customSubDomainName": "string",
    "defaultProject": "string",
    "disableLocalAuth": "bool",
    "dynamicThrottlingEnabled": "bool",
    "encryption": {
      "keySource": "string",
      "keyVaultProperties": {
        "identityClientId": "string",
        "keyName": "string",
        "keyVaultUri": "string",
        "keyVersion": "string"
      }
    },
    "locations": {
      "regions": [
        {
          "customsubdomain": "string",
          "name": "string",
          "value": "int"
        }
      ],
      "routingMethod": "string"
    },
    "migrationToken": "string",
    "networkAcls": {
      "bypass": "string",
      "defaultAction": "string",
      "ipRules": [
        {
          "value": "string"
        }
      ],
      "virtualNetworkRules": [
        {
          "id": "string",
          "ignoreMissingVnetServiceEndpoint": "bool",
          "state": "string"
        }
      ]
    },
    "networkInjections": [
      {
        "scenario": "string",
        "subnetArmId": "string",
        "useMicrosoftManagedNetwork": "bool"
      }
    ],
    "publicNetworkAccess": "string",
    "raiMonitorConfig": {
      "adxStorageResourceId": "string",
      "identityClientId": "string"
    },
    "restore": "bool",
    "restrictOutboundNetworkAccess": "bool",
    "storedCompletionsDisabled": "bool",
    "userOwnedStorage": [
      {
        "identityClientId": "string",
        "resourceId": "string"
      }
    ]
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

属性值

Microsoft.CognitiveServices/accounts（微软认知服务/帐户）

AccountProperties

AccountTags 账户标签

ApiProperties

加密

身份

IdentityUserAssignedIdentities

IpRule （英语）

KeyVaultProperties

多Region设置

网络注入

NetworkRuleSet 网络规则集

RaiMonitorConfig

RegionSetting

SKU

UserAssignedIdentity

UserOwnedAmlWorkspace

UserOwnedStorage

VirtualNetworkRule （虚拟网络规则）

用法示例

Azure 快速入门模板

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

模板	DESCRIPTION
Azure AI Foundry 基本设置	这组模板演示了如何使用基本设置设置 Azure AI Foundry，这意味着启用公共 Internet 访问、用于加密的 Microsoft 托管密钥以及 AI 资源的 Microsoft 托管身份配置。
Azure AI Foundry 基本设置	这组模板演示了如何使用基本设置设置 Azure AI Foundry，这意味着启用公共 Internet 访问、用于加密的 Microsoft 托管密钥以及 AI 资源的 Microsoft 托管身份配置。
Azure AI Foundry 网络受限	这组模板演示了如何在禁用专用链接和出口的情况下设置 Azure AI Foundry，使用 Microsoft 管理的密钥进行加密，并使用 Microsoft 管理的标识配置为 AI 资源。
具有 Microsoft Entra ID 身份验证的 Azure AI Foundry	这组模板演示了如何为依赖资源（如 Azure AI 服务和 Azure 存储）设置 Azure AI Foundry 和 Microsoft Entra ID 身份验证。
Azure AI Studio 基本设置	此模板集演示如何使用基本设置设置设置 Azure AI Studio，这意味着启用了公共 Internet 访问、Microsoft托管密钥进行加密和 AI 资源的Microsoft托管标识配置。
Azure AI Studio 网络受限	此模板集演示如何使用禁用专用链接和出口设置 Azure AI Studio，并使用Microsoft托管密钥进行加密和 AI 资源的Microsoft托管标识配置。
基本代理设置 API 密钥	此模板集演示如何使用 API 密钥身份验证为 AI 服务/AOAI 连接设置基本设置 Azure AI 代理服务。 代理使用完全由Microsoft管理的多租户搜索和存储资源。 无法查看或控制这些基础 Azure 资源。
基本代理设置标识	此模板集演示如何使用 AI 服务/AOAI 连接的托管标识身份验证设置基本设置 Azure AI 代理服务。 代理使用完全由Microsoft管理的多租户搜索和存储资源。 无法查看或控制这些基础 Azure 资源。
部署 Azure AI 服务多服务资源	此模板部署一个 Azure AI 服务资源，使 AI 在无需机器学习专业知识的情况下，使每个开发人员都能接触到 AI。 只需通过 API 调用即可将查看、听到、说话、搜索、理解和加速决策的功能嵌入到应用中。
部署 Azure AI Translator 资源	此模板部署 Azure AI Translator 资源，使 AI 在无需机器学习专业知识的情况下，让每个开发人员都能访问 AI。
部署 Azure AI 视觉资源	此模板部署 Azure AI 视觉资源，使 AI 在无需机器学习专业知识的情况下，使每个开发人员都能接触到 AI。
使用托管虚拟网络部署 Secure AI Foundry	此模板创建具有强大网络和标识安全限制的安全 Azure AI Foundry 环境。
使用用户托管标识 网络安全代理	此模板集演示如何使用用户托管标识身份验证为 AI 服务/AOAI 连接设置虚拟网络隔离的 Azure AI 代理服务，以及专用网络链接，以将代理连接到安全数据。
标准代理设置	此模板集演示如何使用标准设置设置设置 Azure AI 代理服务，这意味着已启用项目/中心连接的托管标识身份验证和公共 Internet 访问。 代理使用客户拥有的单租户搜索和存储资源。 通过此设置，可以完全控制这些资源并查看这些资源，但会根据使用情况产生成本。

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

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

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

资源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts@2025-09-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    kind = "string"
    properties = {
      allowedFqdnList = [
        "string"
      ]
      allowProjectManagement = bool
      amlWorkspace = {
        identityClientId = "string"
        resourceId = "string"
      }
      apiProperties = {
        aadClientId = "string"
        aadTenantId = "string"
        eventHubConnectionString = "string"
        qnaAzureSearchEndpointId = "string"
        qnaAzureSearchEndpointKey = "string"
        qnaRuntimeEndpoint = "string"
        statisticsEnabled = bool
        storageAccountConnectionString = "string"
        superUser = "string"
        websiteName = "string"
      }
      associatedProjects = [
        "string"
      ]
      customSubDomainName = "string"
      defaultProject = "string"
      disableLocalAuth = bool
      dynamicThrottlingEnabled = bool
      encryption = {
        keySource = "string"
        keyVaultProperties = {
          identityClientId = "string"
          keyName = "string"
          keyVaultUri = "string"
          keyVersion = "string"
        }
      }
      locations = {
        regions = [
          {
            customsubdomain = "string"
            name = "string"
            value = int
          }
        ]
        routingMethod = "string"
      }
      migrationToken = "string"
      networkAcls = {
        bypass = "string"
        defaultAction = "string"
        ipRules = [
          {
            value = "string"
          }
        ]
        virtualNetworkRules = [
          {
            id = "string"
            ignoreMissingVnetServiceEndpoint = bool
            state = "string"
          }
        ]
      }
      networkInjections = [
        {
          scenario = "string"
          subnetArmId = "string"
          useMicrosoftManagedNetwork = bool
        }
      ]
      publicNetworkAccess = "string"
      raiMonitorConfig = {
        adxStorageResourceId = "string"
        identityClientId = "string"
      }
      restore = bool
      restrictOutboundNetworkAccess = bool
      storedCompletionsDisabled = bool
      userOwnedStorage = [
        {
          identityClientId = "string"
          resourceId = "string"
        }
      ]
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

属性值

Microsoft.CognitiveServices/accounts（微软认知服务/帐户）

AccountProperties

AccountTags 账户标签

ApiProperties

加密

身份

IdentityUserAssignedIdentities

IpRule （英语）

KeyVaultProperties

多Region设置

网络注入

NetworkRuleSet 网络规则集

RaiMonitorConfig

RegionSetting

SKU

UserAssignedIdentity

UserOwnedAmlWorkspace

UserOwnedStorage

VirtualNetworkRule （虚拟网络规则）

用法示例

Terraform 示例

部署 AI 服务帐户的基本示例。

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westus2"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "userAssignedIdentity" {
  type                      = "Microsoft.ManagedIdentity/userAssignedIdentities@2023-01-31"
  parent_id                 = azapi_resource.resourceGroup.id
  name                      = var.resource_name
  location                  = var.location
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "account" {
  type      = "Microsoft.CognitiveServices/accounts@2022-10-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  identity {
    type         = "SystemAssigned, UserAssigned"
    identity_ids = [azapi_resource.userAssignedIdentity.id]
  }

  body = {
    kind = "SpeechServices"
    properties = {
      allowedFqdnList = [
      ]
      apiProperties = {
      }
      customSubDomainName           = "acctest-cogacc-230630032807723157"
      disableLocalAuth              = false
      dynamicThrottlingEnabled      = false
      publicNetworkAccess           = "Enabled"
      restrictOutboundNetworkAccess = false
    }
    sku = {
      name = "S0"
      tier = "Standard"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Azure 验证模块

以下 Azure 验证模块 可用于部署此资源类型。