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


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

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

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

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

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

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

resource symbolicname 'Microsoft.CognitiveServices/accounts/deployments@2025-04-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    capacitySettings: {
      designatedCapacity: int
      priority: int
    }
    currentCapacity: int
    model: {
      format: 'string'
      name: 'string'
      publisher: 'string'
      source: 'string'
      sourceAccount: 'string'
      version: 'string'
    }
    parentDeploymentName: '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 для модели развертывания. струна
sourceAccount Необязательный. Источник модели, другой учетные записи Microsoft.CognitiveServices, идентификатор ресурса ARM. струна
Версия Необязательный. Версия модели развертывания. Если версия не указана, будет назначена версия по умолчанию. Версия по умолчанию отличается для разных моделей и может измениться при наличии новой версии для модели. Версию по умолчанию для модели можно найти в API моделей списков. струна

DeploymentProperties

Имя Описание Ценность
capacitySettings Только внутреннее использование. DeploymentCapacitySettings
currentCapacity Текущая емкость. int
модель Свойства модели развертывания учетной записи Cognitive Services. DeploymentModel
parentDeploymentName Имя родительского развертывания. струна
raiPolicyName Имя политики RAI. струна
scaleSettings Свойства модели развертывания учетной записи Cognitive Services. (Не рекомендуется использовать deployment.sku.) DeploymentScaleSettings
versionUpgradeOption Вариант обновления версии модели развертывания. NoAutoUpgrade
"OnceCurrentVersionExpired"
"OnceNewDefaultVersionAvailable"

DeploymentScaleSettings

Имя Описание Ценность
способность Емкость развертывания. int
scaleType Тип масштабирования развертывания. "Вручную"
"Стандартный"

DeploymentTags

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

Microsoft.CognitiveServices/accounts/deployments

Имя Описание Ценность
имя Имя ресурса строка (обязательно)
родитель В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.
Символьное имя ресурса типа: учетные записи
свойства Свойства развертывания учетной записи Cognitive Services. DeploymentProperties
SKU Определение модели ресурсов, представляющее номер SKU Sku
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

Sku

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

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

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

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

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

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

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

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

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

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

{
  "type": "Microsoft.CognitiveServices/accounts/deployments",
  "apiVersion": "2025-04-01-preview",
  "name": "string",
  "properties": {
    "capacitySettings": {
      "designatedCapacity": "int",
      "priority": "int"
    },
    "currentCapacity": "int",
    "model": {
      "format": "string",
      "name": "string",
      "publisher": "string",
      "source": "string",
      "sourceAccount": "string",
      "version": "string"
    },
    "parentDeploymentName": "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 для модели развертывания. струна
sourceAccount Необязательный. Источник модели, другой учетные записи Microsoft.CognitiveServices, идентификатор ресурса ARM. струна
Версия Необязательный. Версия модели развертывания. Если версия не указана, будет назначена версия по умолчанию. Версия по умолчанию отличается для разных моделей и может измениться при наличии новой версии для модели. Версию по умолчанию для модели можно найти в API моделей списков. струна

DeploymentProperties

Имя Описание Ценность
capacitySettings Только внутреннее использование. DeploymentCapacitySettings
currentCapacity Текущая емкость. int
модель Свойства модели развертывания учетной записи Cognitive Services. DeploymentModel
parentDeploymentName Имя родительского развертывания. струна
raiPolicyName Имя политики RAI. струна
scaleSettings Свойства модели развертывания учетной записи Cognitive Services. (Не рекомендуется использовать deployment.sku.) DeploymentScaleSettings
versionUpgradeOption Вариант обновления версии модели развертывания. NoAutoUpgrade
"OnceCurrentVersionExpired"
"OnceNewDefaultVersionAvailable"

DeploymentScaleSettings

Имя Описание Ценность
способность Емкость развертывания. int
scaleType Тип масштабирования развертывания. "Вручную"
"Стандартный"

DeploymentTags

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

Microsoft.CognitiveServices/accounts/deployments

Имя Описание Ценность
apiVersion Версия API '2025-04-01-preview'
имя Имя ресурса строка (обязательно)
свойства Свойства развертывания учетной записи Cognitive Services. DeploymentProperties
SKU Определение модели ресурсов, представляющее номер SKU Sku
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса "Microsoft.CognitiveServices/accounts/deployments"

Sku

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

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

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

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

Шаблон Описание
ключи API установки базового агента

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

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

развертывание в Azure
Этот шаблон создает безопасную среду Azure AI Studio с надежными ограничениями безопасности сети и удостоверений.
агент с управляемым удостоверением пользователя

развертывание в Azure
Этот набор шаблонов демонстрирует настройку службы агента ИИ Azure с изоляцией виртуальной сети с помощью проверки подлинности управляемого удостоверения пользователей для подключения службы ИИ/AOAI и частных сетевых каналов для подключения агента к защищенным данным.
настройка стандартного агента

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

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

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

  • групп ресурсов

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts/deployments@2025-04-01-preview"
  name = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      capacitySettings = {
        designatedCapacity = int
        priority = int
      }
      currentCapacity = int
      model = {
        format = "string"
        name = "string"
        publisher = "string"
        source = "string"
        sourceAccount = "string"
        version = "string"
      }
      parentDeploymentName = "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 для модели развертывания. струна
sourceAccount Необязательный. Источник модели, другой учетные записи Microsoft.CognitiveServices, идентификатор ресурса ARM. струна
Версия Необязательный. Версия модели развертывания. Если версия не указана, будет назначена версия по умолчанию. Версия по умолчанию отличается для разных моделей и может измениться при наличии новой версии для модели. Версию по умолчанию для модели можно найти в API моделей списков. струна

DeploymentProperties

Имя Описание Ценность
capacitySettings Только внутреннее использование. DeploymentCapacitySettings
currentCapacity Текущая емкость. int
модель Свойства модели развертывания учетной записи Cognitive Services. DeploymentModel
parentDeploymentName Имя родительского развертывания. струна
raiPolicyName Имя политики RAI. струна
scaleSettings Свойства модели развертывания учетной записи Cognitive Services. (Не рекомендуется использовать deployment.sku.) DeploymentScaleSettings
versionUpgradeOption Вариант обновления версии модели развертывания. NoAutoUpgrade
"OnceCurrentVersionExpired"
"OnceNewDefaultVersionAvailable"

DeploymentScaleSettings

Имя Описание Ценность
способность Емкость развертывания. int
scaleType Тип масштабирования развертывания. "Вручную"
"Стандартный"

DeploymentTags

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

Microsoft.CognitiveServices/accounts/deployments

Имя Описание Ценность
имя Имя ресурса строка (обязательно)
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: учетные записи
свойства Свойства развертывания учетной записи Cognitive Services. DeploymentProperties
SKU Определение модели ресурсов, представляющее номер SKU Sku
Теги Теги ресурсов Словарь имен и значений тегов.
тип Тип ресурса "Microsoft.CognitiveServices/accounts/deployments@2025-04-01-preview"

Sku

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