Поделиться через


Майкрософт. Аккаунты CognitiveServices

Определение ресурса Bicep

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

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

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

Создать Майкрософт. Когнитивные сервисы/ресурс аккаунтов, добавьте следующий Bicep в свой шаблон.

resource symbolicname 'Microsoft.CognitiveServices/accounts@2026-03-01' = {
  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'
  }
}

Значения свойств

Майкрософт. Когнитивные сервисы/аккаунты

Имя Описание Ценность
идентичность Удостоверение ресурса. Идентичность
добрый Тип (тип) учетной записи когнитивной службы. струна
расположение Географическое расположение, в котором находится ресурс струна
имя имя ресурса. струна

Ограничения целостности:
Минимальная длина = 2
Максимальная длина = 64
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ (обязательно)
свойства Свойства учетной записи Cognitive Services. AccountProperties (Свойства аккаунта)
SKU (Единица учета запасов) Определение модели ресурсов, представляющее номер SKU SKU
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

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

Имя Описание Ценность
allowedFqdnList строка[]
allowProjectManagement Указывает, поддерживает ли этот ресурс управление проектами в качестве дочерних ресурсов, используемых в качестве контейнеров для управления доступом, изоляции данных и затрат в AI Foundry. булевая переменная (bool)
amlWorkspace Свойства учетной записи AML, принадлежащие пользователю. UserOwnedAmlWorkspace
apiСвойства Свойства API для специальных API. ApiProperties
ассоциированныеПроекты Указывает проекты по имени проекта, связанные с этим ресурсом. строка[]
customSubDomainName Необязательное имя поддомена, используемое для проверки подлинности на основе маркеров. струна
defaultProject Указывает проект по имени проекта, на который нацелены при вызове конечных точек плоскости данных без параметра project. струна
disableLocalAuth булевая переменная (bool)
dynamicThrottlingEnabled Флаг для включения динамического регулирования. булевая переменная (bool)
шифрование Свойства шифрования для этого ресурса. Шифрование
местоположения Параметры мультирегионирования учетной записи Cognitive Services. MultiRegionSettings
migrationToken Маркер миграции ресурсов. струна
networkAcls Коллекция правил, регулирующих специальные возможности из определенных сетевых расположений. Набор сетевых правил
networkInjections Внедрение в сеть[]
доступ к публичной сети Разрешен доступ к общедоступной конечной точке для этой учетной записи. "Отключено"
"Включено"
Конфигурация raiMonitorConfig Конфигурация монитора Rai в Cognitive Services. Конфигурация RaiMonitorConfig
Восстановление булевая переменная (bool)
restrictOutboundNetworkAccess булевая переменная (bool)
storedCompletionsDisabled Флаг для отключения сохраненных завершений. булевая переменная (bool)
userOwnedStorage Учетные записи хранения для этого ресурса. UserOwnedStorage[]

AccountTags

Имя Описание Ценность

ApiProperties

Имя Описание Ценность
aadClientId (Только для консультанта по метрике) Идентификатор клиента Azure AD (Application Id). струна

Ограничения целостности:
Максимальная длина = 500
aadTenantId (Только для консультанта по метрике) Идентификатор арендатора Azure AD струна

Ограничения целостности:
Максимальная длина = 500
eventHubConnectionString (Только персонализация) Флаг для включения статистики поиска Bing. струна

Ограничения целостности:
Максимальная длина = 1000
Шаблон = ^( *)Endpoint=sb://(.*);( *)SharedAccessKeyName=(.*);( *)SharedAccessKey=(.*)$
qnaAzureSearchEndpointId (только для QnAMaker) Идентификатор конечной точки поиска Azure QnAMaker. струна
qnaAzureSearchEndpointKey (только для QnAMaker) Ключ конечной точки поиска Azure QnAMaker. струна
Конечная точка qnaRuntimeEndpoint (только QnAMaker) Конечная точка среды выполнения QnAMaker. струна
статистикаВключено (Только поиск Bing) Флаг для включения статистики поиска Bing. булевая переменная (bool)
storageAccountConnectionString (Только персонализация) Строка строка подключения для учетной записи хранилища. струна

Ограничения целостности:
Максимальная длина = 1000
Шаблон = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$
Суперпользователя (Только помощник по метрикам) Супер пользователь помощника по метрикам. струна

Ограничения целостности:
Максимальная длина = 500
имя веб-сайта (Только помощник по метрикам) Имя веб-сайта помощника по метрикам. струна

Ограничения целостности:
Максимальная длина = 500

Шифрование

Имя Описание Ценность
Источник ключа Перечисляет возможное значение keySource для шифрования 'Майкрософт. CognitiveServices'
'Майкрософт. KeyVault
keyVaultProperties Свойства KeyVault Свойства KeyVault

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

Имя Описание Ценность
тип Тип удостоверения. "Нет"
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned
ИдентичностиНазначенныеПользователем Список назначенных пользователем удостоверений, связанных с ресурсом. Ссылки на ключи в словаре идентификации пользователя будут идентификаторами ресурсов ARM в виде: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Майкрософт. ManagedIdentity/userAssignedIdentities/{identityName} IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Имя Описание Ценность

Правило IpRule

Имя Описание Ценность
ценность Диапазон адресов IPv4 в нотации CIDR, например "124.56.78.91" (простой IP-адрес) или "124.56.78.0/24" (все адреса, начинающиеся с 124.56.78). строка (обязательно)

Свойства KeyVault

Имя Описание Ценность
identityClientId струна
keyName Имя ключа из KeyVault струна
keyVaultUri Универсальный код ресурса (URI) keyVault струна
keyVersion Версия ключа из KeyVault струна

MultiRegionSettings

Имя Описание Ценность
регионы RegionSetting[]
маршрутизацияMethod Методы многорегионной маршрутизации. "Производительность"
"Приоритет"
"Взвешанный"

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

Имя Описание Ценность
сценарий Указывает, к каким функциям применяется внедрение сети AI Foundry. В настоящее время поддерживается только агент для сценариев агента. "нет" означает отсутствие внедрения сети. "agent"
"нет"
subnetArmId Укажите подсеть, в которую внедряется клиент агента. струна
useMicrosoftManagedNetwork Boolean позволяет включить Майкрософт Managed Network для делегирования подсети булевая переменная (bool)

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

Имя Описание Ценность
обходить Настройка доверенных служб. AzureServices
"Нет"
defaultAction Действие по умолчанию, если правило из ipRules и из virtualNetworkRules не совпадает. Это используется только после оценки свойства обхода. "Разрешить"
"Запретить"
ipRules Список правил IP-адресов. Правило IpRule[]
virtualNetworkRules Список правил виртуальной сети. Правило VirtualNetwork[]

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

Имя Описание Ценность
adxStorageResourceId Идентификатор ресурса хранилища. струна
identityClientId Идентификатор клиента удостоверений для доступа к хранилищу. струна

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

Имя Описание Ценность
таможенный домен Сопоставляет регион с региональным пользовательским поддоменом. струна
имя Имя региона. струна
ценность Значение для методов маршрутизации с приоритетом или весовым значением. инт

Артикул

Имя Описание Ценность
Емкость Если номер SKU поддерживает горизонтальное масштабирование или в, то целое число емкости должно быть включено. Если горизонтальное масштабирование невозможно для ресурса, это может быть опущено. инт
семья Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. струна
имя Имя номера SKU. Пример - П3. Обычно это код буквы и числа строка (обязательно)
размер Размер номера SKU. Если поле имени является сочетанием уровня и другого значения, это будет автономный код. струна
ярус Это поле необходимо реализовать поставщиком ресурсов, если служба имеет несколько уровней, но не требуется для PUT. "Базовый"
"Enterprise"
"Бесплатный"
"Премиум"
"Стандартный"

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

Имя Описание Ценность

UserOwnedAmlWorkspace

Имя Описание Ценность
identityClientId Идентификатор клиента удостоверения ресурса учетной записи AML. струна
идентификатор ресурса Полный идентификатор ресурса учетной записи AML. струна

UserOwnedStorage

Имя Описание Ценность
identityClientId струна
идентификатор ресурса Полный идентификатор ресурса Майкрософт. Ресурс для хранения. струна

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

Имя Описание Ценность
идентификатор Полный идентификатор ресурса подсети vnet, например, '/subscriptions/subid/resourceGroups/rg1/providers/Майкрософт. Network/virtualNetworks/test-vnet/subnets/subnet1'. строка (обязательно)
ignoreMissingVnetServiceEndpoint Игнорировать недостающую конечную точку службы виртуальной сети или нет. булевая переменная (bool)
государство Возвращает состояние правила виртуальной сети. струна

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

Bicep Samples

Базовый пример развертывания аккаунта когнитивных услуг.

param resourceName string = 'acctest0001'
param location string = 'westus2'

resource account 'Microsoft.CognitiveServices/accounts@2022-10-01' = {
  name: resourceName
  location: location
  kind: 'SpeechServices'
  properties: {
    allowedFqdnList: []
    apiProperties: {}
    customSubDomainName: 'acctest-cogacc-230630032807723157'
    disableLocalAuth: false
    dynamicThrottlingEnabled: false
    publicNetworkAccess: 'Enabled'
    restrictOutboundNetworkAccess: false
  }
  sku: {
    name: 'S0'
    tier: 'Standard'
  }
}

resource userAssignedIdentity 'Microsoft.ManagedIdentity/userAssignedIdentities@2023-01-31' = {
  name: resourceName
  location: location
}

Azure Verified Modules

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

Модуль Описание
Azure Услуги ИИ (когнитивные услуги) AVM Resource Module for Azure AI Services (Cognitive Services)

Azure Quickstart Samples

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

Bicep File Описание
Azure AI Foundry базовая настройка Этот набор шаблонов демонстрирует, как настроить Azure AI Foundry с базовой конфигурацией, то есть с открытым доступом в интернет, ключами с управлением Майкрософт для шифрования и конфигурацией идентификации Майкрософт для AI-ресурса.
Azure AI Foundry базовая настройка Этот набор шаблонов демонстрирует, как настроить Azure AI Foundry с базовой конфигурацией, то есть с открытым доступом в интернет, ключами с управлением Майкрософт для шифрования и конфигурацией идентификации Майкрософт для AI-ресурса.
Azure AI Foundry Сеть ограничена Этот набор шаблонов демонстрирует, как настроить Azure AI Foundry с отключённой приватной линией и выходом, используя ключи, управляемые Майкрософт для шифрования, и конфигурацию идентификации Майкрософт для AI-ресурса.
Azure AI Foundry с Microsoft Entra ID аутентификацией Этот набор шаблонов демонстрирует, как настроить Azure AI Foundry с аутентификацией Microsoft Entra ID для зависимых ресурсов, таких как Azure AI Services и служба хранилища Azure.
Azure базовая настройка AI Studio Этот набор шаблонов демонстрирует, как настроить Azure AI Studio с базовой конфигурацией, то есть с доступом в публичный интернет, ключами с управлением Майкрософт для шифрования и конфигурацией идентификации Майкрософт для AI-ресурса.
Azure Сеть AI Studio ограничена Этот набор шаблонов демонстрирует, как настроить Azure AI Studio с отключёнными приватными каналами и выходом, используя ключи, управляемые Майкрософт для шифрования, и конфигурацию идентификации Майкрософт для ресурса ИИ.
Basic Agent Setup API Keys Этот набор шаблонов демонстрирует, как настроить Azure AI Agent Service с базовой настройкой с использованием аутентификации ключей API для соединения AI Service/AOAI. Агенты используют многоарендованные поисковые и хранилища, полностью управляемые Майкрософт. У вас не ™будет видимости или контроля над этими базовыми ресурсами Azure.
базовая идентификация установки агента Этот набор шаблонов демонстрирует, как настроить Azure AI Agent Service с базовой настройкой с использованием управляемой аутентификации идентификации для соединения AI Service/AOAI. Агенты используют многоарендованные поисковые и хранилища, полностью управляемые Майкрософт. У вас не ™будет видимости или контроля над этими базовыми ресурсами Azure.
Развернуть Azure AI services мультисервисный ресурс Этот шаблон использует ресурс Azure AI services, чтобы сделать ИИ доступным для каждого разработчика без необходимости экспертизы в области машинного обучения. Все, что требуется, — это вызов API для внедрения возможности видеть, слышать, говорить, искать, понимать и ускорить принятие решений в приложения.
Развернуть Переводчик Azure AI ресурс Этот шаблон использует ресурс Переводчик Azure AI, чтобы сделать ИИ доступным для каждого разработчика без необходимости опыта в машинном обучении.
Развернуть Зрение ИИ Azure ресурс Этот шаблон использует ресурс Зрение ИИ Azure, чтобы сделать ИИ доступным для каждого разработчика без необходимости экспертизы в области машинного обучения.
Развернуть Secure AI Foundry с управляемой виртуальной сетью Этот шаблон создаёт безопасную среду Azure AI Foundry с надёжными ограничениями безопасности сети и идентификации.
Сетевой защищённый агент с управляемой пользовательской идентификацией Этот набор шаблонов демонстрирует, как настроить Azure AI Agent Service с виртуальной изоляцией сети с использованием аутентификации User Managed Identity для соединения AI Service/AOAI и частных сетевых каналов для подключения агента к вашим защищённым данным.
Стандартная настройка агента Этот набор шаблонов демонстрирует, как настроить Azure AI Agent Service с помощью стандартной настройки, то есть с управляемой аутентификацией идентичности для подключений проектов и хаба, а также с включенным публичным доступом в интернет. Агенты используют ресурсы поиска и хранилища с одним клиентом. С помощью этой настройки вы можете полностью контролировать и просматривать эти ресурсы, но вы будете нести расходы на основе использования.

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

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

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

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

Создать Майкрософт. Когнитивные сервисы/ресурс аккаунтов, добавьте следующий JSON в свой шаблон.

{
  "type": "Microsoft.CognitiveServices/accounts",
  "apiVersion": "2026-03-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"
  }
}

Значения свойств

Майкрософт. Когнитивные сервисы/аккаунты

Имя Описание Ценность
apiVersion Версия API '2026-03-01'
идентичность Удостоверение ресурса. Идентичность
добрый Тип (тип) учетной записи когнитивной службы. струна
расположение Географическое расположение, в котором находится ресурс струна
имя имя ресурса. струна

Ограничения целостности:
Минимальная длина = 2
Максимальная длина = 64
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ (обязательно)
свойства Свойства учетной записи Cognitive Services. AccountProperties (Свойства аккаунта)
SKU (Единица учета запасов) Определение модели ресурсов, представляющее номер SKU SKU
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса 'Майкрософт. CognitiveServices/аккаунты»

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

Имя Описание Ценность
allowedFqdnList строка[]
allowProjectManagement Указывает, поддерживает ли этот ресурс управление проектами в качестве дочерних ресурсов, используемых в качестве контейнеров для управления доступом, изоляции данных и затрат в AI Foundry. булевая переменная (bool)
amlWorkspace Свойства учетной записи AML, принадлежащие пользователю. UserOwnedAmlWorkspace
apiСвойства Свойства API для специальных API. ApiProperties
ассоциированныеПроекты Указывает проекты по имени проекта, связанные с этим ресурсом. строка[]
customSubDomainName Необязательное имя поддомена, используемое для проверки подлинности на основе маркеров. струна
defaultProject Указывает проект по имени проекта, на который нацелены при вызове конечных точек плоскости данных без параметра project. струна
disableLocalAuth булевая переменная (bool)
dynamicThrottlingEnabled Флаг для включения динамического регулирования. булевая переменная (bool)
шифрование Свойства шифрования для этого ресурса. Шифрование
местоположения Параметры мультирегионирования учетной записи Cognitive Services. MultiRegionSettings
migrationToken Маркер миграции ресурсов. струна
networkAcls Коллекция правил, регулирующих специальные возможности из определенных сетевых расположений. Набор сетевых правил
networkInjections Внедрение в сеть[]
доступ к публичной сети Разрешен доступ к общедоступной конечной точке для этой учетной записи. "Отключено"
"Включено"
Конфигурация raiMonitorConfig Конфигурация монитора Rai в Cognitive Services. Конфигурация RaiMonitorConfig
Восстановление булевая переменная (bool)
restrictOutboundNetworkAccess булевая переменная (bool)
storedCompletionsDisabled Флаг для отключения сохраненных завершений. булевая переменная (bool)
userOwnedStorage Учетные записи хранения для этого ресурса. UserOwnedStorage[]

AccountTags

Имя Описание Ценность

ApiProperties

Имя Описание Ценность
aadClientId (Только для консультанта по метрике) Идентификатор клиента Azure AD (Application Id). струна

Ограничения целостности:
Максимальная длина = 500
aadTenantId (Только для консультанта по метрике) Идентификатор арендатора Azure AD струна

Ограничения целостности:
Максимальная длина = 500
eventHubConnectionString (Только персонализация) Флаг для включения статистики поиска Bing. струна

Ограничения целостности:
Максимальная длина = 1000
Шаблон = ^( *)Endpoint=sb://(.*);( *)SharedAccessKeyName=(.*);( *)SharedAccessKey=(.*)$
qnaAzureSearchEndpointId (только для QnAMaker) Идентификатор конечной точки поиска Azure QnAMaker. струна
qnaAzureSearchEndpointKey (только для QnAMaker) Ключ конечной точки поиска Azure QnAMaker. струна
Конечная точка qnaRuntimeEndpoint (только QnAMaker) Конечная точка среды выполнения QnAMaker. струна
статистикаВключено (Только поиск Bing) Флаг для включения статистики поиска Bing. булевая переменная (bool)
storageAccountConnectionString (Только персонализация) Строка строка подключения для учетной записи хранилища. струна

Ограничения целостности:
Максимальная длина = 1000
Шаблон = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$
Суперпользователя (Только помощник по метрикам) Супер пользователь помощника по метрикам. струна

Ограничения целостности:
Максимальная длина = 500
имя веб-сайта (Только помощник по метрикам) Имя веб-сайта помощника по метрикам. струна

Ограничения целостности:
Максимальная длина = 500

Шифрование

Имя Описание Ценность
Источник ключа Перечисляет возможное значение keySource для шифрования 'Майкрософт. CognitiveServices'
'Майкрософт. KeyVault
keyVaultProperties Свойства KeyVault Свойства KeyVault

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

Имя Описание Ценность
тип Тип удостоверения. "Нет"
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned
ИдентичностиНазначенныеПользователем Список назначенных пользователем удостоверений, связанных с ресурсом. Ссылки на ключи в словаре идентификации пользователя будут идентификаторами ресурсов ARM в виде: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Майкрософт. ManagedIdentity/userAssignedIdentities/{identityName} IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Имя Описание Ценность

Правило IpRule

Имя Описание Ценность
ценность Диапазон адресов IPv4 в нотации CIDR, например "124.56.78.91" (простой IP-адрес) или "124.56.78.0/24" (все адреса, начинающиеся с 124.56.78). строка (обязательно)

Свойства KeyVault

Имя Описание Ценность
identityClientId струна
keyName Имя ключа из KeyVault струна
keyVaultUri Универсальный код ресурса (URI) keyVault струна
keyVersion Версия ключа из KeyVault струна

MultiRegionSettings

Имя Описание Ценность
регионы RegionSetting[]
маршрутизацияMethod Методы многорегионной маршрутизации. "Производительность"
"Приоритет"
"Взвешанный"

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

Имя Описание Ценность
сценарий Указывает, к каким функциям применяется внедрение сети AI Foundry. В настоящее время поддерживается только агент для сценариев агента. "нет" означает отсутствие внедрения сети. "agent"
"нет"
subnetArmId Укажите подсеть, в которую внедряется клиент агента. струна
useMicrosoftManagedNetwork Boolean позволяет включить Майкрософт Managed Network для делегирования подсети булевая переменная (bool)

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

Имя Описание Ценность
обходить Настройка доверенных служб. AzureServices
"Нет"
defaultAction Действие по умолчанию, если правило из ipRules и из virtualNetworkRules не совпадает. Это используется только после оценки свойства обхода. "Разрешить"
"Запретить"
ipRules Список правил IP-адресов. Правило IpRule[]
virtualNetworkRules Список правил виртуальной сети. Правило VirtualNetwork[]

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

Имя Описание Ценность
adxStorageResourceId Идентификатор ресурса хранилища. струна
identityClientId Идентификатор клиента удостоверений для доступа к хранилищу. струна

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

Имя Описание Ценность
таможенный домен Сопоставляет регион с региональным пользовательским поддоменом. струна
имя Имя региона. струна
ценность Значение для методов маршрутизации с приоритетом или весовым значением. инт

Артикул

Имя Описание Ценность
Емкость Если номер SKU поддерживает горизонтальное масштабирование или в, то целое число емкости должно быть включено. Если горизонтальное масштабирование невозможно для ресурса, это может быть опущено. инт
семья Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. струна
имя Имя номера SKU. Пример - П3. Обычно это код буквы и числа строка (обязательно)
размер Размер номера SKU. Если поле имени является сочетанием уровня и другого значения, это будет автономный код. струна
ярус Это поле необходимо реализовать поставщиком ресурсов, если служба имеет несколько уровней, но не требуется для PUT. "Базовый"
"Enterprise"
"Бесплатный"
"Премиум"
"Стандартный"

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

Имя Описание Ценность

UserOwnedAmlWorkspace

Имя Описание Ценность
identityClientId Идентификатор клиента удостоверения ресурса учетной записи AML. струна
идентификатор ресурса Полный идентификатор ресурса учетной записи AML. струна

UserOwnedStorage

Имя Описание Ценность
identityClientId струна
идентификатор ресурса Полный идентификатор ресурса Майкрософт. Ресурс для хранения. струна

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

Имя Описание Ценность
идентификатор Полный идентификатор ресурса подсети vnet, например, '/subscriptions/subid/resourceGroups/rg1/providers/Майкрософт. Network/virtualNetworks/test-vnet/subnets/subnet1'. строка (обязательно)
ignoreMissingVnetServiceEndpoint Игнорировать недостающую конечную точку службы виртуальной сети или нет. булевая переменная (bool)
государство Возвращает состояние правила виртуальной сети. струна

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

Azure Quickstart Templates

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

Шаблон Описание
Azure AI Foundry базовая настройка

Развернуться на Azure
Этот набор шаблонов демонстрирует, как настроить Azure AI Foundry с базовой конфигурацией, то есть с открытым доступом в интернет, ключами с управлением Майкрософт для шифрования и конфигурацией идентификации Майкрософт для AI-ресурса.
Azure AI Foundry базовая настройка

Развернуться на Azure
Этот набор шаблонов демонстрирует, как настроить Azure AI Foundry с базовой конфигурацией, то есть с открытым доступом в интернет, ключами с управлением Майкрософт для шифрования и конфигурацией идентификации Майкрософт для AI-ресурса.
Azure AI Foundry Сеть ограничена

Развернуться на Azure
Этот набор шаблонов демонстрирует, как настроить Azure AI Foundry с отключённой приватной линией и выходом, используя ключи, управляемые Майкрософт для шифрования, и конфигурацию идентификации Майкрософт для AI-ресурса.
Azure AI Foundry с Microsoft Entra ID аутентификацией

Развернуться на Azure
Этот набор шаблонов демонстрирует, как настроить Azure AI Foundry с аутентификацией Microsoft Entra ID для зависимых ресурсов, таких как Azure AI Services и служба хранилища Azure.
Azure базовая настройка AI Studio

Развернуться на Azure
Этот набор шаблонов демонстрирует, как настроить Azure AI Studio с базовой конфигурацией, то есть с доступом в публичный интернет, ключами с управлением Майкрософт для шифрования и конфигурацией идентификации Майкрософт для AI-ресурса.
Azure Сеть AI Studio ограничена

Развернуться на Azure
Этот набор шаблонов демонстрирует, как настроить Azure AI Studio с отключёнными приватными каналами и выходом, используя ключи, управляемые Майкрософт для шифрования, и конфигурацию идентификации Майкрософт для ресурса ИИ.
Basic Agent Setup API Keys

Развернуться на Azure
Этот набор шаблонов демонстрирует, как настроить Azure AI Agent Service с базовой настройкой с использованием аутентификации ключей API для соединения AI Service/AOAI. Агенты используют многоарендованные поисковые и хранилища, полностью управляемые Майкрософт. У вас не ™будет видимости или контроля над этими базовыми ресурсами Azure.
базовая идентификация установки агента

Развернуться на Azure
Этот набор шаблонов демонстрирует, как настроить Azure AI Agent Service с базовой настройкой с использованием управляемой аутентификации идентификации для соединения AI Service/AOAI. Агенты используют многоарендованные поисковые и хранилища, полностью управляемые Майкрософт. У вас не ™будет видимости или контроля над этими базовыми ресурсами Azure.
Развернуть Azure AI services мультисервисный ресурс

Развернуться на Azure
Этот шаблон использует ресурс Azure AI services, чтобы сделать ИИ доступным для каждого разработчика без необходимости экспертизы в области машинного обучения. Все, что требуется, — это вызов API для внедрения возможности видеть, слышать, говорить, искать, понимать и ускорить принятие решений в приложения.
Развернуть Переводчик Azure AI ресурс

Развернуться на Azure
Этот шаблон использует ресурс Переводчик Azure AI, чтобы сделать ИИ доступным для каждого разработчика без необходимости опыта в машинном обучении.
Развернуть Зрение ИИ Azure ресурс

Развернуться на Azure
Этот шаблон использует ресурс Зрение ИИ Azure, чтобы сделать ИИ доступным для каждого разработчика без необходимости экспертизы в области машинного обучения.
Развернуть Secure AI Foundry с управляемой виртуальной сетью

Развернуться на Azure
Этот шаблон создаёт безопасную среду Azure AI Foundry с надёжными ограничениями безопасности сети и идентификации.
Сетевой защищённый агент с управляемой пользовательской идентификацией

Развернуться на Azure
Этот набор шаблонов демонстрирует, как настроить Azure AI Agent Service с виртуальной изоляцией сети с использованием аутентификации User Managed Identity для соединения AI Service/AOAI и частных сетевых каналов для подключения агента к вашим защищённым данным.
Стандартная настройка агента

Развернуться на Azure
Этот набор шаблонов демонстрирует, как настроить Azure AI Agent Service с помощью стандартной настройки, то есть с управляемой аутентификацией идентичности для подключений проектов и хаба, а также с включенным публичным доступом в интернет. Агенты используют ресурсы поиска и хранилища с одним клиентом. С помощью этой настройки вы можете полностью контролировать и просматривать эти ресурсы, но вы будете нести расходы на основе использования.

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

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

  • Группы ресурсов

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

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

Создать Майкрософт. CognitiveServices/accounts resource, добавьте следующий Terraform в ваш шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts@2026-03-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"
    }
  }
}

Значения свойств

Майкрософт. Когнитивные сервисы/аккаунты

Имя Описание Ценность
идентичность Удостоверение ресурса. Идентичность
добрый Тип (тип) учетной записи когнитивной службы. струна
расположение Географическое расположение, в котором находится ресурс струна
имя имя ресурса. струна

Ограничения целостности:
Минимальная длина = 2
Максимальная длина = 64
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ (обязательно)
свойства Свойства учетной записи Cognitive Services. AccountProperties (Свойства аккаунта)
SKU (Единица учета запасов) Определение модели ресурсов, представляющее номер SKU SKU
Теги Теги ресурсов Словарь имен и значений тегов.
тип Тип ресурса «Майкрософт. CognitiveServices/accounts@2026-03-01"

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

Имя Описание Ценность
allowedFqdnList строка[]
allowProjectManagement Указывает, поддерживает ли этот ресурс управление проектами в качестве дочерних ресурсов, используемых в качестве контейнеров для управления доступом, изоляции данных и затрат в AI Foundry. булевая переменная (bool)
amlWorkspace Свойства учетной записи AML, принадлежащие пользователю. UserOwnedAmlWorkspace
apiСвойства Свойства API для специальных API. ApiProperties
ассоциированныеПроекты Указывает проекты по имени проекта, связанные с этим ресурсом. строка[]
customSubDomainName Необязательное имя поддомена, используемое для проверки подлинности на основе маркеров. струна
defaultProject Указывает проект по имени проекта, на который нацелены при вызове конечных точек плоскости данных без параметра project. струна
disableLocalAuth булевая переменная (bool)
dynamicThrottlingEnabled Флаг для включения динамического регулирования. булевая переменная (bool)
шифрование Свойства шифрования для этого ресурса. Шифрование
местоположения Параметры мультирегионирования учетной записи Cognitive Services. MultiRegionSettings
migrationToken Маркер миграции ресурсов. струна
networkAcls Коллекция правил, регулирующих специальные возможности из определенных сетевых расположений. Набор сетевых правил
networkInjections Внедрение в сеть[]
доступ к публичной сети Разрешен доступ к общедоступной конечной точке для этой учетной записи. "Отключено"
"Включено"
Конфигурация raiMonitorConfig Конфигурация монитора Rai в Cognitive Services. Конфигурация RaiMonitorConfig
Восстановление булевая переменная (bool)
restrictOutboundNetworkAccess булевая переменная (bool)
storedCompletionsDisabled Флаг для отключения сохраненных завершений. булевая переменная (bool)
userOwnedStorage Учетные записи хранения для этого ресурса. UserOwnedStorage[]

AccountTags

Имя Описание Ценность

ApiProperties

Имя Описание Ценность
aadClientId (Только для консультанта по метрике) Идентификатор клиента Azure AD (Application Id). струна

Ограничения целостности:
Максимальная длина = 500
aadTenantId (Только для консультанта по метрике) Идентификатор арендатора Azure AD струна

Ограничения целостности:
Максимальная длина = 500
eventHubConnectionString (Только персонализация) Флаг для включения статистики поиска Bing. струна

Ограничения целостности:
Максимальная длина = 1000
Шаблон = ^( *)Endpoint=sb://(.*);( *)SharedAccessKeyName=(.*);( *)SharedAccessKey=(.*)$
qnaAzureSearchEndpointId (только для QnAMaker) Идентификатор конечной точки поиска Azure QnAMaker. струна
qnaAzureSearchEndpointKey (только для QnAMaker) Ключ конечной точки поиска Azure QnAMaker. струна
Конечная точка qnaRuntimeEndpoint (только QnAMaker) Конечная точка среды выполнения QnAMaker. струна
статистикаВключено (Только поиск Bing) Флаг для включения статистики поиска Bing. булевая переменная (bool)
storageAccountConnectionString (Только персонализация) Строка строка подключения для учетной записи хранилища. струна

Ограничения целостности:
Максимальная длина = 1000
Шаблон = ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$
Суперпользователя (Только помощник по метрикам) Супер пользователь помощника по метрикам. струна

Ограничения целостности:
Максимальная длина = 500
имя веб-сайта (Только помощник по метрикам) Имя веб-сайта помощника по метрикам. струна

Ограничения целостности:
Максимальная длина = 500

Шифрование

Имя Описание Ценность
Источник ключа Перечисляет возможное значение keySource для шифрования 'Майкрософт. CognitiveServices'
'Майкрософт. KeyVault
keyVaultProperties Свойства KeyVault Свойства KeyVault

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

Имя Описание Ценность
тип Тип удостоверения. "Нет"
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned
ИдентичностиНазначенныеПользователем Список назначенных пользователем удостоверений, связанных с ресурсом. Ссылки на ключи в словаре идентификации пользователя будут идентификаторами ресурсов ARM в виде: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Майкрософт. ManagedIdentity/userAssignedIdentities/{identityName} IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Имя Описание Ценность

Правило IpRule

Имя Описание Ценность
ценность Диапазон адресов IPv4 в нотации CIDR, например "124.56.78.91" (простой IP-адрес) или "124.56.78.0/24" (все адреса, начинающиеся с 124.56.78). строка (обязательно)

Свойства KeyVault

Имя Описание Ценность
identityClientId струна
keyName Имя ключа из KeyVault струна
keyVaultUri Универсальный код ресурса (URI) keyVault струна
keyVersion Версия ключа из KeyVault струна

MultiRegionSettings

Имя Описание Ценность
регионы RegionSetting[]
маршрутизацияMethod Методы многорегионной маршрутизации. "Производительность"
"Приоритет"
"Взвешанный"

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

Имя Описание Ценность
сценарий Указывает, к каким функциям применяется внедрение сети AI Foundry. В настоящее время поддерживается только агент для сценариев агента. "нет" означает отсутствие внедрения сети. "agent"
"нет"
subnetArmId Укажите подсеть, в которую внедряется клиент агента. струна
useMicrosoftManagedNetwork Boolean позволяет включить Майкрософт Managed Network для делегирования подсети булевая переменная (bool)

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

Имя Описание Ценность
обходить Настройка доверенных служб. AzureServices
"Нет"
defaultAction Действие по умолчанию, если правило из ipRules и из virtualNetworkRules не совпадает. Это используется только после оценки свойства обхода. "Разрешить"
"Запретить"
ipRules Список правил IP-адресов. Правило IpRule[]
virtualNetworkRules Список правил виртуальной сети. Правило VirtualNetwork[]

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

Имя Описание Ценность
adxStorageResourceId Идентификатор ресурса хранилища. струна
identityClientId Идентификатор клиента удостоверений для доступа к хранилищу. струна

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

Имя Описание Ценность
таможенный домен Сопоставляет регион с региональным пользовательским поддоменом. струна
имя Имя региона. струна
ценность Значение для методов маршрутизации с приоритетом или весовым значением. инт

Артикул

Имя Описание Ценность
Емкость Если номер SKU поддерживает горизонтальное масштабирование или в, то целое число емкости должно быть включено. Если горизонтальное масштабирование невозможно для ресурса, это может быть опущено. инт
семья Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. струна
имя Имя номера SKU. Пример - П3. Обычно это код буквы и числа строка (обязательно)
размер Размер номера SKU. Если поле имени является сочетанием уровня и другого значения, это будет автономный код. струна
ярус Это поле необходимо реализовать поставщиком ресурсов, если служба имеет несколько уровней, но не требуется для PUT. "Базовый"
"Enterprise"
"Бесплатный"
"Премиум"
"Стандартный"

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

Имя Описание Ценность

UserOwnedAmlWorkspace

Имя Описание Ценность
identityClientId Идентификатор клиента удостоверения ресурса учетной записи AML. струна
идентификатор ресурса Полный идентификатор ресурса учетной записи AML. струна

UserOwnedStorage

Имя Описание Ценность
identityClientId струна
идентификатор ресурса Полный идентификатор ресурса Майкрософт. Ресурс для хранения. струна

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

Имя Описание Ценность
идентификатор Полный идентификатор ресурса подсети vnet, например, '/subscriptions/subid/resourceGroups/rg1/providers/Майкрософт. Network/virtualNetworks/test-vnet/subnets/subnet1'. строка (обязательно)
ignoreMissingVnetServiceEndpoint Игнорировать недостающую конечную точку службы виртуальной сети или нет. булевая переменная (bool)
государство Возвращает состояние правила виртуальной сети. струна

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

Примеры Terraform

Базовый пример развертывания аккаунта когнитивных услуг.

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 Verified Modules

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

Модуль Описание
Когнитивная служба Модуль ресурсов AVM для учетной записи Cognitive Services (Open AI)