Учетные записи Microsoft.CognitiveServices

Определение ресурсов Bicep

Тип ресурса учетных записей можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.CognitiveServices/accounts, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.CognitiveServices/accounts@2025-10-01-preview' = {
  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/учетные записи

AccountProperties (Свойства аккаунта)

AccountTags

ApiProperties

Шифрование

Идентичность

IdentityUserAssignedIdentities

Правило IpRule

Свойства KeyVault

MultiRegionSettings

Внедрение в сеть

Набор сетевых правил

Конфигурация RaiMonitorConfig

РегионСеттинг

Артикул

Пользовательская назначенная идентичность

UserOwnedAmlWorkspace

UserOwnedStorage

Правило VirtualNetworkRule (Правило VirtualNetwork)

Примеры использования

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Определение ресурса шаблона ARM

Тип ресурса учетных записей можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.CognitiveServices/accounts, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.CognitiveServices/accounts",
  "apiVersion": "2025-10-01-preview",
  "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/учетные записи

AccountProperties (Свойства аккаунта)

AccountTags

ApiProperties

Шифрование

Идентичность

IdentityUserAssignedIdentities

Правило IpRule

Свойства KeyVault

MultiRegionSettings

Внедрение в сеть

Набор сетевых правил

Конфигурация RaiMonitorConfig

РегионСеттинг

Артикул

Пользовательская назначенная идентичность

UserOwnedAmlWorkspace

UserOwnedStorage

Правило VirtualNetworkRule (Правило VirtualNetwork)

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Шаблон	Описание
Базовая настройка Azure AI Foundry	В этом наборе шаблонов показано, как настроить Azure AI Foundry с базовой настройкой, то есть с включенным общедоступным доступом к Интернету, ключами шифрования, управляемыми корпорацией Майкрософт, и конфигурацией удостоверений, управляемой корпорацией Майкрософт для ресурса ИИ.
Базовая настройка Azure AI Foundry	В этом наборе шаблонов показано, как настроить Azure AI Foundry с базовой настройкой, то есть с включенным общедоступным доступом к Интернету, ключами шифрования, управляемыми корпорацией Майкрософт, и конфигурацией удостоверений, управляемой корпорацией Майкрософт для ресурса ИИ.
Ограниченная сеть Azure AI Foundry	В этом наборе шаблонов показано, как настроить Azure AI Foundry с отключенным приватным каналом и исходящим трафиком, используя ключи, управляемые корпорацией Майкрософт, для шифрования и конфигурацию удостоверений, управляемую корпорацией Майкрософт для ресурса ИИ.
Azure AI Foundry с проверкой подлинности Microsoft Entra ID	В этом наборе шаблонов показано, как настроить Azure AI Foundry с проверкой подлинности Microsoft Entra ID для зависимых ресурсов, таких как службы Azure AI и служба хранилища Azure.
базовая настройка Azure AI Studio	В этом наборе шаблонов показано, как настроить Azure AI Studio с помощью базовой настройки, то есть с поддержкой общедоступного доступа к Интернету, ключами, управляемыми Корпорацией Майкрософт, для шифрования и конфигурации управляемых корпорацией Майкрософт удостоверений для ресурса ИИ.
ограниченной сети Azure AI Studio	Этот набор шаблонов демонстрирует настройку Azure AI Studio с закрытым каналом и отключением исходящего трафика с помощью ключей, управляемых Корпорацией Майкрософт, для шифрования и конфигурации управляемых корпорацией Майкрософт удостоверений для ресурса искусственного интеллекта.
ключи API установки базового агента	В этом наборе шаблонов показано, как настроить службу агента ИИ Azure с базовой настройкой с помощью проверки подлинности ключей API для подключения службы ИИ/AOAI. Агенты используют ресурсы поиска в нескольких клиентах и хранилища, полностью управляемые корпорацией Майкрософт. У вас нет видимости или контроля над этими базовыми ресурсами Azure.
базовый идентификатор установки агента	В этом наборе шаблонов показано, как настроить службу агента ИИ Azure с базовой настройкой с помощью проверки подлинности управляемого удостоверения для подключения службы ИИ/AOAI. Агенты используют ресурсы поиска в нескольких клиентах и хранилища, полностью управляемые корпорацией Майкрософт. У вас нет видимости или контроля над этими базовыми ресурсами Azure.
Развертывание ресурса нескольких служб ИИ Azure	Этот шаблон развертывает ресурс служб искусственного интеллекта Azure для привлечения ИИ в пределах досягаемости каждого разработчика, не требуя опыта машинного обучения. Все, что требуется, — это вызов API для внедрения возможности видеть, слышать, говорить, искать, понимать и ускорить принятие решений в приложения.
Развертывание ресурса Azure AI Translator	Этот шаблон развертывает ресурс Azure AI Translator для привлечения ИИ в пределах досягаемости каждого разработчика, не требуя опыта машинного обучения.
Развертывание ресурса Визуального распознавания ИИ Azure	Этот шаблон развертывает ресурс Azure AI Vision для привлечения ИИ в пределах досягаемости каждого разработчика, не требуя опыта машинного обучения.
Развертывание Secure AI Foundry с помощью управляемой виртуальной сети	Этот шаблон создает безопасную среду Azure AI Foundry с надежными ограничениями безопасности сети и удостоверений.
агент с управляемым удостоверением пользователя	Этот набор шаблонов демонстрирует настройку службы агента ИИ Azure с изоляцией виртуальной сети с помощью проверки подлинности управляемого удостоверения пользователей для подключения службы ИИ/AOAI и частных сетевых каналов для подключения агента к защищенным данным.
настройка стандартного агента	В этом наборе шаблонов показано, как настроить службу агента ИИ Azure со стандартной настройкой, то есть с проверкой подлинности управляемого удостоверения для подключений к проекту или концентратору и общедоступного доступа к Интернету. Агенты используют ресурсы поиска и хранилища с одним клиентом. С помощью этой настройки вы можете полностью контролировать и просматривать эти ресурсы, но вы будете нести расходы на основе использования.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса учетных записей можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.CognitiveServices/accounts, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts@2025-10-01-preview"
  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/учетные записи

AccountProperties (Свойства аккаунта)

AccountTags

ApiProperties

Шифрование

Идентичность

IdentityUserAssignedIdentities

Правило IpRule

Свойства KeyVault

MultiRegionSettings

Внедрение в сеть

Набор сетевых правил

Конфигурация RaiMonitorConfig

РегионСеттинг

Артикул

Пользовательская назначенная идентичность

UserOwnedAmlWorkspace

UserOwnedStorage

Правило VirtualNetworkRule (Правило VirtualNetwork)

Примеры использования

Примеры Terraform

Простой пример развертывания учетной записи AI Services.

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 можно использовать для развертывания этого типа ресурсов.