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


Рабочие области Microsoft.MachineLearningServices 2025-10-01-preview

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

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

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

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

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

resource symbolicname 'Microsoft.MachineLearningServices/workspaces@2025-10-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    allowPublicAccessWhenBehindVnet: bool
    allowRoleAssignmentOnRG: bool
    applicationInsights: 'string'
    associatedWorkspaces: [
      'string'
    ]
    containerRegistries: [
      'string'
    ]
    containerRegistry: 'string'
    description: 'string'
    discoveryUrl: 'string'
    enableDataIsolation: bool
    enableServiceSideCMKEncryption: bool
    enableSimplifiedCmk: bool
    enableSoftwareBillOfMaterials: bool
    encryption: {
      cosmosDbResourceId: 'string'
      identity: {
        userAssignedIdentity: 'string'
      }
      keyVaultProperties: {
        identityClientId: 'string'
        keyIdentifier: 'string'
        keyVaultArmId: 'string'
      }
      searchAccountResourceId: 'string'
      status: 'string'
      storageAccountResourceId: 'string'
    }
    existingWorkspaces: [
      'string'
    ]
    featureStoreSettings: {
      computeRuntime: {
        sparkRuntimeVersion: 'string'
      }
      offlineStoreConnectionName: 'string'
      onlineStoreConnectionName: 'string'
    }
    friendlyName: 'string'
    hbiWorkspace: bool
    hubResourceId: 'string'
    imageBuildCompute: 'string'
    ipAllowlist: [
      'string'
    ]
    keyVault: 'string'
    keyVaults: [
      'string'
    ]
    managedNetwork: {
      enableNetworkMonitor: bool
      firewallSku: 'string'
      isolationMode: 'string'
      managedNetworkKind: 'string'
      outboundRules: {
        {customized property}: {
          category: 'string'
          status: 'string'
          type: 'string'
          // For remaining properties, see OutboundRule objects
        }
      }
      status: {
        sparkReady: bool
        status: 'string'
      }
    }
    networkAcls: {
      defaultAction: 'string'
      ipRules: [
        {
          value: 'string'
        }
      ]
    }
    primaryUserAssignedIdentity: 'string'
    provisionNetworkNow: bool
    publicNetworkAccess: 'string'
    serverlessComputeSettings: {
      serverlessComputeCustomSubnet: 'string'
      serverlessComputeNoPublicIP: bool
    }
    serviceManagedResourcesSettings: {
      cosmosDb: {
        collectionsThroughput: int
      }
    }
    sharedPrivateLinkResources: [
      {
        name: 'string'
        properties: {
          groupId: 'string'
          privateLinkResourceId: 'string'
          requestMessage: 'string'
          status: 'string'
        }
      }
    ]
    softDeleteRetentionInDays: int
    storageAccount: 'string'
    storageAccounts: [
      'string'
    ]
    systemDatastoresAuthMode: 'string'
    v1LegacyMode: bool
    workspaceHubConfig: {
      additionalWorkspaceStorageAccounts: [
        'string'
      ]
      defaultWorkspaceResourceGroup: 'string'
    }
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Объекты OutboundRule

Задайте свойство type , чтобы указать тип объекта.

Для полное доменное имяиспользуйте:

{
  destination: 'string'
  type: 'FQDN'
}

Для PrivateEndpointиспользуйте:

{
  destination: {
    serviceResourceId: 'string'
    sparkEnabled: bool
    sparkStatus: 'string'
    subresourceTarget: 'string'
  }
  fqdns: [
    'string'
  ]
  type: 'PrivateEndpoint'
}

Для ServiceTagиспользуйте:

{
  destination: {
    action: 'string'
    addressPrefixes: [
      'string'
    ]
    portRanges: 'string'
    protocol: 'string'
    serviceTag: 'string'
  }
  type: 'ServiceTag'
}

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

Microsoft.MachineLearningServices/workspaces

Имя Description Ценность
identity Удостоверения управляемой службы, назначенные этому ресурсу. ManagedServiceIdentity
добрый струна
location струна
имя имя ресурса. string

Constraints:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ (обязательно)
properties Дополнительные атрибуты сущности. WorkspaceProperties (обязательно)
sku Необязательно. Это поле требуется для реализации RP, так как AML поддерживает несколько уровней. Sku
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

ComputeRuntimeDto

Имя Description Ценность
sparkRuntimeVersion струна

CosmosDbSettings (Настройки CosmosDb)

Имя Description Ценность
collectionsПропускная способность инт

EncryptionProperty

Имя Description Ценность
cosmosDbResourceId Учетная запись byok cosmosdb, которую клиент приносит для хранения данных клиента
с шифрованием
струна
identity Удостоверение для использования с ключомVault IdentityForCmk
keyVaultProperties Сведения о keyVault для шифрования KeyVaultProperties (обязательно)
searchAccountResourceId Учетная запись поиска byok, которую клиент приносит для хранения данных клиента
с шифрованием
струна
статус Указывает, включена ли шифрование для рабочей области. 'Disabled'
«Включено» (обязательно)
storageAccountResourceId Учетная запись хранения byok, которую клиент приносит для хранения данных клиента
с шифрованием
струна

FeatureStoreSettings

Имя Description Ценность
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName струна
onlineStoreConnectionName струна

Правило FqdnOutboundRule

Имя Description Ценность
destination струна
type Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. Полное доменное имя (обязательно)

IdentityForCmk

Имя Description Ценность
userAssignedIdentity UserAssignedIdentity для получения ключа шифрования из keyVault струна

IPRule

Имя Description Ценность
value Диапазон адресов IPv4 в нотации CIDR, например "124.56.78.91" (простой IP-адрес) или "124.56.78.0/24" (все адреса, начинающиеся с 124.56.78). Значение может быть "Разрешить" или "Запретить". струна

Свойства KeyVault

Имя Description Ценность
identityClientId В настоящее время мы поддерживаем только SystemAssigned MSI.
Это необходимо, когда мы поддерживаем UserAssignedIdentities
струна
keyIdentifier Идентификатор ключа KeyVault для шифрования данных string

Constraints:
Минимальная длина = 1
Pattern = [a-zA-Z0-9_] (обязательно)
keyVaultArmId Идентификатор Arm KeyVault, содержащий ключ шифрования данных string

Constraints:
Минимальная длина = 1
Pattern = [a-zA-Z0-9_] (обязательно)

ManagedNetworkProvisionStatus (Статус управляемой сети)

Имя Description Ценность
sparkReady bool
статус Состояние управляемой сети рабочей области машинного обучения. 'Active'
'Inactive'

ManagedNetworkSettings (УправляемыеNetworkSettings)

Имя Description Ценность
enableNetworkMonitor Флаг, указывающий, нужно ли включить мониторинг для управляемой сети. bool
firewallSku SKU брандмауэра, используемого для правил FQDN 'Basic'
'Standard'
режим изоляции Режим изоляции для управляемой сети рабочей области машинного обучения. AllowInternetOutbound
AllowOnlyApprovedOutbound
'Disabled'
managedNetworkKind Вид управляемой сети. Пользователи могут переключаться с V1 на V2 для детального управления доступом, но не могут переключиться обратно на V1 после включения V2. 'V1'
'V2'
outboundRules Словарь <OutboundRule> ManagedNetworkSettingsOutboundRules (УправляемыеNetworkSettingsOutboundRules (УправляемыеNetworkSettingsOutboundRules
статус Состояние подготовки для управляемой сети рабочей области машинного обучения. ManagedNetworkProvisionStatus (Статус управляемой сети)

ManagedNetworkSettingsOutboundRules (УправляемыеNetworkSettingsOutboundRules (УправляемыеNetworkSettingsOutboundRules

Имя Description Ценность

ManagedServiceIdentity

Имя Description Ценность
type Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
UserAssigned (обязательно)
userAssignedIdentities Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. UserAssignedIdentities

NetworkAcls

Имя Description Ценность
defaultAction Действие по умолчанию, если правило из ipRules и из virtualNetworkRules не совпадает. Это используется только после оценки свойства обхода. 'Allow'
'Deny'
ipRules Правила, управляющие специальными возможностями ресурса из определенного IP-адреса или диапазона IP-адресов. IPRule[]

Исходящее правило

Имя Description Ценность
категория Категория правила исходящего трафика управляемой сети рабочей области машинного обучения. "Зависимость"
"Рекомендуется"
"Обязательный"
UserDefined
статус Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Active'
'Deleting'
'Failed'
'Inactive'
Подготовка
type Задайте значение FQDN для типа FqdnOutboundRule. Установите значение PrivateEndpoint для типа PrivateEndpointOutboundRule. Установите значение ServiceTag для типа ServiceTagoutboundRule. Полное доменное имя
PrivateEndpoint
ServiceTag (обязательный)

PrivateEndpointDestination (Частная конечная точкаDestination)

Имя Description Ценность
serviceResourceId Определение типа, которое ссылается на идентификатор ресурса Azure Resource Manager. струна
sparkEnabled bool
sparkStatus Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Active'
'Deleting'
'Failed'
'Inactive'
Подготовка
подресурсЦель струна

Правило PrivateEndpointOutboundRule

Имя Description Ценность
destination Назначение частной конечной точки для правила исходящего трафика частной конечной точки для управляемой сети рабочей области машинного обучения. PrivateEndpointDestination (Частная конечная точкаDestination)
Файловые доменные имена строка[]
type Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. PrivateEndpoint (обязательный)

БессерверныеComputeSettings

Имя Description Ценность
serverlessComputeCustomSubnet Идентификатор ресурса существующей подсети виртуальной сети, в которой должны быть развернуты бессерверные вычислительные узлы. струна
бессерверныйComputeNoPublicIP Флаг для сигнала, если бессерверные вычислительные узлы, развернутые в пользовательской виртуальной сети, не будут иметь общедоступных IP-адресов для рабочей области с частной конечной точкой bool

ServiceManagedResourcesSettings

Имя Description Ценность
cosmosDb CosmosDbSettings (Настройки CosmosDb)

ServiceTagDestination

Имя Description Ценность
действие Перечисление действия для правила сети. 'Allow'
'Deny'
addressПрефиксы Необязательный, если он указан, свойство ServiceTag будет игнорироваться. строка[]
Диапазоны портов струна
protocol струна
ServiceTag струна

ServiceTagOutboundRule

Имя Description Ценность
destination Назначение тега службы для правила исходящего трафика тега службы для управляемой сети рабочей области машинного обучения. ServiceTagDestination
type Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. ServiceTag (обязательный)

SharedPrivateLinkResource

Имя Description Ценность
имя Уникальное имя приватного канала струна
properties Свойства общего ресурса приватного канала. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Имя Description Ценность
groupId идентификатор группы приватного канала струна
privateLinkResourceId Идентификатор ресурса, на который ссылается приватный канал струна
requestMessage Запрос на сообщение струна
статус Статус соединения потребителя сервиса с провайдером\r\nВозможные переходы состояния\r\nОжидается -> Одобрено (провайдер одобряет запрос на соединение)\r\nОжидает -> Отклонено (провайдер отклоняет запрос на соединение)\r\nОжидает -> Отключено (провайдер удаляет соединение)\r\nОдобрено -> Отклонено (оператор отклоняет одобренное соединение)\r\nОдобрено -> Отключено (провайдер удаляет соединение)\r\nОтклонено - > Ожидание (пользователь сервиса повторно инициирует отклонённый запрос на соединение)\r\nОтклонён -> Отключение (провайдер удаляет соединение) "Утверждено"
"Отключено"
"Ожидание"
"Отклонено"
"Время ожидания"

Sku

Имя Description Ценность
capacity Если номер SKU поддерживает горизонтальное масштабирование или в, то целое число емкости должно быть включено. Если горизонтальное масштабирование невозможно для ресурса, это может быть опущено. инт
family Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. струна
имя Имя номера SKU. Пример - П3. Обычно это код буквы и числа строка (обязательно)
size Размер номера SKU. Если поле имени является сочетанием уровня и другого значения, это будет автономный код. струна
tier Это поле необходимо реализовать поставщиком ресурсов, если служба имеет несколько уровней, но не требуется для PUT. 'Basic'
'Free'
'Premium'
'Standard'

UserAssignedIdentities

Имя Description Ценность

UserAssignedIdentity

Имя Description Ценность

WorkspaceHubConfig (Конфигурация для WorkspaceHubConfig)

Имя Description Ценность
additionalWorkspaceStorageAccounts строка[]
defaultWorkspaceResourceGroup струна

Свойства рабочего пространства

Имя Description Ценность
allowPublicAccessWhenBehindVnet Флаг, указывающий, следует ли разрешить общедоступный доступ при использовании виртуальной сети. bool
allowRoleAssignmentOnRG Флаг, указывающий, будет ли выполняться назначение ролей для MSI рабочей области на уровне группы ресурсов. bool
аналитика приложений Идентификатор ARM аналитики приложений, связанной с этой рабочей областью. струна
АссоциированныеРабочие пространства строка[]
containerRegistries строка[]
containerRegistry Идентификатор ARM реестра контейнеров, связанного с этой рабочей областью. струна
описание Описание этой рабочей области. струна
discoveryUrl URL-адрес службы обнаружения для идентификации региональных конечных точек для служб экспериментирования машинного обучения струна
enableDataIsolation bool
enableServiceSideCMKEncryption bool
enableSimplifiedCmk Пометка, чтобы определить, следует ли включить упрощенную cmK для этой рабочей области. bool
enableSoftwareBill ofMaterials Пометка, чтобы определить, следует ли включить SoftwareBillOfMaterials для этой рабочей области. bool
encryption EncryptionProperty
существующие пространстваWorkspaces строка[]
featureStoreSettings Параметры рабочей области типа хранилища компонентов. FeatureStoreSettings
friendlyName Понятное имя для этой рабочей области. Это имя в изменяемом формате струна
hbiWorkspace Флаг для сигнала данных HBI в рабочей области и уменьшения диагностических данных, собранных службой. bool
hubResourceId струна
imageBuildCompute Имя вычисления для сборки образа струна
Список ipAllowlist Список адресов IPv4, разрешенных для доступа к рабочей области. строка[]
Приложение keyVault Идентификатор ARM хранилища ключей, связанного с этой рабочей областью. Это невозможно изменить после создания рабочей области струна
Хранилища ключей строка[]
управляемая сеть Параметры управляемой сети для рабочей области машинного обучения. ManagedNetworkSettings (УправляемыеNetworkSettings)
networkAcls Набор правил, определяющих доступность сети рабочей области. NetworkAcls
primaryUserAssignedIdentity Идентификатор ресурса удостоверения, назначаемого пользователем, который представляет удостоверение рабочей области. струна
provisionNetworkNow Установите для активации подготовки управляемой виртуальной сети с параметрами по умолчанию при создании рабочей области с включенной управляемой виртуальной сетью или в противном случае ничего не делает. bool
доступ к публичной сети Разрешены ли запросы из общедоступной сети. 'Disabled'
'Enabled'
бессерверныеComputeSettings Параметры бессерверных вычислений в рабочей области БессерверныеComputeSettings
serviceManagedResourcesSettings Параметры управляемого ресурса службы. ServiceManagedResourcesSettings
sharedPrivateLinkResources Список общих ресурсов приватного канала в этой рабочей области. SharedPrivateLinkResource[]
softDeleteRetentionInDays Время хранения в днях после того, как рабочая область будет удалена обратимо. инт
storageAccount Идентификатор ARM учетной записи хранения, связанной с этой рабочей областью. Это невозможно изменить после создания рабочей области струна
storageAccounts строка[]
systemDatastoresAuthMode Режим проверки подлинности, используемый для доступа к системным хранилищам данных рабочей области. AccessKey
"Удостоверение"
UserDelegationSAS
v1LegacyMode Включение параметра v1_legacy_mode может препятствовать использованию функций, предоставляемых API версии 2. bool
workspaceHubConfig Объект конфигурации WorkspaceHub. WorkspaceHubConfig

Рабочие теги

Имя Description Ценность

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

Примеры Bicep

Простой пример развертывания рабочей области Машинного обучения Azure.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource component 'Microsoft.Insights/components@2020-02-02' = {
  name: resourceName
  location: location
  kind: 'web'
  properties: {
    Application_Type: 'web'
    DisableIpMasking: false
    DisableLocalAuth: false
    ForceCustomerStorageForProfiler: false
    RetentionInDays: 90
    SamplingPercentage: 100
    publicNetworkAccessForIngestion: 'Enabled'
    publicNetworkAccessForQuery: 'Enabled'
  }
}

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-09-01' = {
  name: resourceName
  location: location
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
    allowBlobPublicAccess: true
    allowCrossTenantReplication: true
    allowSharedKeyAccess: true
    defaultToOAuthAuthentication: false
    encryption: {
      keySource: 'Microsoft.Storage'
      services: {
        queue: {
          keyType: 'Service'
        }
        table: {
          keyType: 'Service'
        }
      }
    }
    isHnsEnabled: false
    isNfsV3Enabled: false
    isSftpEnabled: false
    minimumTlsVersion: 'TLS1_2'
    networkAcls: {
      defaultAction: 'Allow'
    }
    publicNetworkAccess: 'Enabled'
    supportsHttpsTrafficOnly: true
  }
  sku: {
    name: 'Standard_LRS'
  }
}

resource vault 'Microsoft.KeyVault/vaults@2021-10-01' = {
  name: resourceName
  location: location
  properties: {
    accessPolicies: [
      {
        objectId: '45a2d1ea-488a-44b0-bb2e-3cd8e485ebef'
        permissions: {
          certificates: [
            'all'
          ]
          keys: [
            'all'
          ]
          secrets: [
            'all'
          ]
          storage: []
        }
        tenantId: deployer().tenantId
      }
    ]
    createMode: 'default'
    enablePurgeProtection: true
    enableRbacAuthorization: false
    enableSoftDelete: true
    enabledForDeployment: false
    enabledForDiskEncryption: false
    enabledForTemplateDeployment: false
    publicNetworkAccess: 'Enabled'
    sku: {
      family: 'A'
      name: 'standard'
    }
    tenantId: deployer().tenantId
  }
}

resource workspace 'Microsoft.MachineLearningServices/workspaces@2022-05-01' = {
  name: resourceName
  location: location
  properties: {
    applicationInsights: component.id
    keyVault: vault.id
    publicNetworkAccess: 'Disabled'
    storageAccount: storageAccount.id
    v1LegacyMode: false
  }
  sku: {
    name: 'Basic'
    tier: 'Basic'
  }
}

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

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

Модуль Description
рабочей области служб машинного обучения Модуль ресурсов AVM для рабочей области служб машинного обучения

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

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

Файл Bicep Description
Базовая настройка 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 с закрытым каналом и отключением исходящего трафика с помощью ключей, управляемых Корпорацией Майкрософт, для шифрования и конфигурации управляемых корпорацией Майкрософт удостоверений для ресурса искусственного интеллекта.
сквозной настройке машинного обучения Azure В этом наборе шаблонов Bicep показано, как настроить сквозную настройку Машинного обучения Azure. Эта эталонная реализация включает рабочую область, вычислительный кластер, вычислительный экземпляр и присоединенный частный кластер AKS.
сквозной настройке машинного обучения Azure (устаревшая версия) В этом наборе шаблонов Bicep показано, как настроить сквозную настройку Машинного обучения Azure. Эта эталонная реализация включает рабочую область, вычислительный кластер, вычислительный экземпляр и присоединенный частный кластер AKS.
ключи API установки базового агента В этом наборе шаблонов показано, как настроить службу агента ИИ Azure с базовой настройкой с помощью проверки подлинности ключей API для подключения службы ИИ/AOAI. Агенты используют ресурсы поиска в нескольких клиентах и хранилища, полностью управляемые корпорацией Майкрософт. У вас не ™будет видимости или контроля над этими базовыми ресурсами Azure.
базовый идентификатор установки агента В этом наборе шаблонов показано, как настроить службу агента ИИ Azure с базовой настройкой с помощью проверки подлинности управляемого удостоверения для подключения службы ИИ/AOAI. Агенты используют ресурсы поиска в нескольких клиентах и хранилища, полностью управляемые корпорацией Майкрософт. У вас не ™будет видимости или контроля над этими базовыми ресурсами Azure.
создание целевого объекта вычислений AKS с частным IP-адресом Этот шаблон создает целевой объект вычислений AKS в данной рабочей области службы машинного обучения Azure с частным IP-адресом.
создание рабочей области службы машинного обучения Azure Этот шаблон развертывания указывает рабочую область машинного обучения Azure и связанные с ней ресурсы, включая Azure Key Vault, службу хранилища Azure, Azure Application Insights и реестр контейнеров Azure. В этой конфигурации описывается минимальный набор ресурсов, необходимых для начала работы с Машинным обучением Azure.
Создание рабочей области службы машинного обучения Azure (CMK) Этот шаблон развертывания указывает, как создать рабочую область Машинного обучения Azure с шифрованием на стороне службы с помощью ключей шифрования.
Создание рабочей области службы машинного обучения Azure (CMK) Этот шаблон развертывания указывает рабочую область машинного обучения Azure и связанные с ней ресурсы, включая Azure Key Vault, службу хранилища Azure, Azure Application Insights и реестр контейнеров Azure. В примере показано, как настроить машинное обучение Azure для шифрования с помощью ключа шифрования, управляемого клиентом.
Создание рабочей области службы машинного обучения Azure (устаревшая версия) Этот шаблон развертывания указывает рабочую область машинного обучения Azure и связанные с ней ресурсы, включая Azure Key Vault, службу хранилища Azure, Azure Application Insights и реестр контейнеров Azure. Эта конфигурация описывает набор ресурсов, необходимых для начала работы с Машинным обучением Azure в изолированной сети.
создание рабочей области службы машинного обучения Azure (vnet) Этот шаблон развертывания указывает рабочую область машинного обучения Azure и связанные с ней ресурсы, включая Azure Key Vault, службу хранилища Azure, Azure Application Insights и реестр контейнеров Azure. Эта конфигурация описывает набор ресурсов, необходимых для начала работы с Машинным обучением Azure в изолированной сети.
Развертывание Secure AI Foundry с помощью управляемой виртуальной сети Этот шаблон создает безопасную среду Azure AI Foundry с надежными ограничениями безопасности сети и удостоверений.
агент с управляемым удостоверением пользователя Этот набор шаблонов демонстрирует настройку службы агента ИИ Azure с изоляцией виртуальной сети с помощью проверки подлинности управляемого удостоверения пользователей для подключения службы ИИ/AOAI и частных сетевых каналов для подключения агента к защищенным данным.
настройка стандартного агента В этом наборе шаблонов показано, как настроить службу агента ИИ Azure со стандартной настройкой, то есть с проверкой подлинности управляемого удостоверения для подключений к проекту или концентратору и общедоступного доступа к Интернету. Агенты используют ресурсы поиска и хранилища с одним клиентом. С помощью этой настройки вы можете полностью контролировать и просматривать эти ресурсы, но вы будете нести расходы на основе использования.

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

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

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

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

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

{
  "type": "Microsoft.MachineLearningServices/workspaces",
  "apiVersion": "2025-10-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "allowPublicAccessWhenBehindVnet": "bool",
    "allowRoleAssignmentOnRG": "bool",
    "applicationInsights": "string",
    "associatedWorkspaces": [ "string" ],
    "containerRegistries": [ "string" ],
    "containerRegistry": "string",
    "description": "string",
    "discoveryUrl": "string",
    "enableDataIsolation": "bool",
    "enableServiceSideCMKEncryption": "bool",
    "enableSimplifiedCmk": "bool",
    "enableSoftwareBillOfMaterials": "bool",
    "encryption": {
      "cosmosDbResourceId": "string",
      "identity": {
        "userAssignedIdentity": "string"
      },
      "keyVaultProperties": {
        "identityClientId": "string",
        "keyIdentifier": "string",
        "keyVaultArmId": "string"
      },
      "searchAccountResourceId": "string",
      "status": "string",
      "storageAccountResourceId": "string"
    },
    "existingWorkspaces": [ "string" ],
    "featureStoreSettings": {
      "computeRuntime": {
        "sparkRuntimeVersion": "string"
      },
      "offlineStoreConnectionName": "string",
      "onlineStoreConnectionName": "string"
    },
    "friendlyName": "string",
    "hbiWorkspace": "bool",
    "hubResourceId": "string",
    "imageBuildCompute": "string",
    "ipAllowlist": [ "string" ],
    "keyVault": "string",
    "keyVaults": [ "string" ],
    "managedNetwork": {
      "enableNetworkMonitor": "bool",
      "firewallSku": "string",
      "isolationMode": "string",
      "managedNetworkKind": "string",
      "outboundRules": {
        "{customized property}": {
          "category": "string",
          "status": "string",
          "type": "string"
          // For remaining properties, see OutboundRule objects
        }
      },
      "status": {
        "sparkReady": "bool",
        "status": "string"
      }
    },
    "networkAcls": {
      "defaultAction": "string",
      "ipRules": [
        {
          "value": "string"
        }
      ]
    },
    "primaryUserAssignedIdentity": "string",
    "provisionNetworkNow": "bool",
    "publicNetworkAccess": "string",
    "serverlessComputeSettings": {
      "serverlessComputeCustomSubnet": "string",
      "serverlessComputeNoPublicIP": "bool"
    },
    "serviceManagedResourcesSettings": {
      "cosmosDb": {
        "collectionsThroughput": "int"
      }
    },
    "sharedPrivateLinkResources": [
      {
        "name": "string",
        "properties": {
          "groupId": "string",
          "privateLinkResourceId": "string",
          "requestMessage": "string",
          "status": "string"
        }
      }
    ],
    "softDeleteRetentionInDays": "int",
    "storageAccount": "string",
    "storageAccounts": [ "string" ],
    "systemDatastoresAuthMode": "string",
    "v1LegacyMode": "bool",
    "workspaceHubConfig": {
      "additionalWorkspaceStorageAccounts": [ "string" ],
      "defaultWorkspaceResourceGroup": "string"
    }
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Объекты OutboundRule

Задайте свойство type , чтобы указать тип объекта.

Для полное доменное имяиспользуйте:

{
  "destination": "string",
  "type": "FQDN"
}

Для PrivateEndpointиспользуйте:

{
  "destination": {
    "serviceResourceId": "string",
    "sparkEnabled": "bool",
    "sparkStatus": "string",
    "subresourceTarget": "string"
  },
  "fqdns": [ "string" ],
  "type": "PrivateEndpoint"
}

Для ServiceTagиспользуйте:

{
  "destination": {
    "action": "string",
    "addressPrefixes": [ "string" ],
    "portRanges": "string",
    "protocol": "string",
    "serviceTag": "string"
  },
  "type": "ServiceTag"
}

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

Microsoft.MachineLearningServices/workspaces

Имя Description Ценность
apiVersion Версия API «2025-10-01-превью»
identity Удостоверения управляемой службы, назначенные этому ресурсу. ManagedServiceIdentity
добрый струна
location струна
имя имя ресурса. string

Constraints:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ (обязательно)
properties Дополнительные атрибуты сущности. WorkspaceProperties (обязательно)
sku Необязательно. Это поле требуется для реализации RP, так как AML поддерживает несколько уровней. Sku
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
type Тип ресурса "Microsoft.MachineLearningServices/workspaces"

ComputeRuntimeDto

Имя Description Ценность
sparkRuntimeVersion струна

CosmosDbSettings (Настройки CosmosDb)

Имя Description Ценность
collectionsПропускная способность инт

EncryptionProperty

Имя Description Ценность
cosmosDbResourceId Учетная запись byok cosmosdb, которую клиент приносит для хранения данных клиента
с шифрованием
струна
identity Удостоверение для использования с ключомVault IdentityForCmk
keyVaultProperties Сведения о keyVault для шифрования KeyVaultProperties (обязательно)
searchAccountResourceId Учетная запись поиска byok, которую клиент приносит для хранения данных клиента
с шифрованием
струна
статус Указывает, включена ли шифрование для рабочей области. 'Disabled'
«Включено» (обязательно)
storageAccountResourceId Учетная запись хранения byok, которую клиент приносит для хранения данных клиента
с шифрованием
струна

FeatureStoreSettings

Имя Description Ценность
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName струна
onlineStoreConnectionName струна

Правило FqdnOutboundRule

Имя Description Ценность
destination струна
type Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. Полное доменное имя (обязательно)

IdentityForCmk

Имя Description Ценность
userAssignedIdentity UserAssignedIdentity для получения ключа шифрования из keyVault струна

IPRule

Имя Description Ценность
value Диапазон адресов IPv4 в нотации CIDR, например "124.56.78.91" (простой IP-адрес) или "124.56.78.0/24" (все адреса, начинающиеся с 124.56.78). Значение может быть "Разрешить" или "Запретить". струна

Свойства KeyVault

Имя Description Ценность
identityClientId В настоящее время мы поддерживаем только SystemAssigned MSI.
Это необходимо, когда мы поддерживаем UserAssignedIdentities
струна
keyIdentifier Идентификатор ключа KeyVault для шифрования данных string

Constraints:
Минимальная длина = 1
Pattern = [a-zA-Z0-9_] (обязательно)
keyVaultArmId Идентификатор Arm KeyVault, содержащий ключ шифрования данных string

Constraints:
Минимальная длина = 1
Pattern = [a-zA-Z0-9_] (обязательно)

ManagedNetworkProvisionStatus (Статус управляемой сети)

Имя Description Ценность
sparkReady bool
статус Состояние управляемой сети рабочей области машинного обучения. 'Active'
'Inactive'

ManagedNetworkSettings (УправляемыеNetworkSettings)

Имя Description Ценность
enableNetworkMonitor Флаг, указывающий, нужно ли включить мониторинг для управляемой сети. bool
firewallSku SKU брандмауэра, используемого для правил FQDN 'Basic'
'Standard'
режим изоляции Режим изоляции для управляемой сети рабочей области машинного обучения. AllowInternetOutbound
AllowOnlyApprovedOutbound
'Disabled'
managedNetworkKind Вид управляемой сети. Пользователи могут переключаться с V1 на V2 для детального управления доступом, но не могут переключиться обратно на V1 после включения V2. 'V1'
'V2'
outboundRules Словарь <OutboundRule> ManagedNetworkSettingsOutboundRules (УправляемыеNetworkSettingsOutboundRules (УправляемыеNetworkSettingsOutboundRules
статус Состояние подготовки для управляемой сети рабочей области машинного обучения. ManagedNetworkProvisionStatus (Статус управляемой сети)

ManagedNetworkSettingsOutboundRules (УправляемыеNetworkSettingsOutboundRules (УправляемыеNetworkSettingsOutboundRules

Имя Description Ценность

ManagedServiceIdentity

Имя Description Ценность
type Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
UserAssigned (обязательно)
userAssignedIdentities Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. UserAssignedIdentities

NetworkAcls

Имя Description Ценность
defaultAction Действие по умолчанию, если правило из ipRules и из virtualNetworkRules не совпадает. Это используется только после оценки свойства обхода. 'Allow'
'Deny'
ipRules Правила, управляющие специальными возможностями ресурса из определенного IP-адреса или диапазона IP-адресов. IPRule[]

Исходящее правило

Имя Description Ценность
категория Категория правила исходящего трафика управляемой сети рабочей области машинного обучения. "Зависимость"
"Рекомендуется"
"Обязательный"
UserDefined
статус Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Active'
'Deleting'
'Failed'
'Inactive'
Подготовка
type Задайте значение FQDN для типа FqdnOutboundRule. Установите значение PrivateEndpoint для типа PrivateEndpointOutboundRule. Установите значение ServiceTag для типа ServiceTagoutboundRule. Полное доменное имя
PrivateEndpoint
ServiceTag (обязательный)

PrivateEndpointDestination (Частная конечная точкаDestination)

Имя Description Ценность
serviceResourceId Определение типа, которое ссылается на идентификатор ресурса Azure Resource Manager. струна
sparkEnabled bool
sparkStatus Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Active'
'Deleting'
'Failed'
'Inactive'
Подготовка
подресурсЦель струна

Правило PrivateEndpointOutboundRule

Имя Description Ценность
destination Назначение частной конечной точки для правила исходящего трафика частной конечной точки для управляемой сети рабочей области машинного обучения. PrivateEndpointDestination (Частная конечная точкаDestination)
Файловые доменные имена строка[]
type Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. PrivateEndpoint (обязательный)

БессерверныеComputeSettings

Имя Description Ценность
serverlessComputeCustomSubnet Идентификатор ресурса существующей подсети виртуальной сети, в которой должны быть развернуты бессерверные вычислительные узлы. струна
бессерверныйComputeNoPublicIP Флаг для сигнала, если бессерверные вычислительные узлы, развернутые в пользовательской виртуальной сети, не будут иметь общедоступных IP-адресов для рабочей области с частной конечной точкой bool

ServiceManagedResourcesSettings

Имя Description Ценность
cosmosDb CosmosDbSettings (Настройки CosmosDb)

ServiceTagDestination

Имя Description Ценность
действие Перечисление действия для правила сети. 'Allow'
'Deny'
addressПрефиксы Необязательный, если он указан, свойство ServiceTag будет игнорироваться. строка[]
Диапазоны портов струна
protocol струна
ServiceTag струна

ServiceTagOutboundRule

Имя Description Ценность
destination Назначение тега службы для правила исходящего трафика тега службы для управляемой сети рабочей области машинного обучения. ServiceTagDestination
type Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. ServiceTag (обязательный)

SharedPrivateLinkResource

Имя Description Ценность
имя Уникальное имя приватного канала струна
properties Свойства общего ресурса приватного канала. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Имя Description Ценность
groupId идентификатор группы приватного канала струна
privateLinkResourceId Идентификатор ресурса, на который ссылается приватный канал струна
requestMessage Запрос на сообщение струна
статус Статус соединения потребителя сервиса с провайдером\r\nВозможные переходы состояния\r\nОжидается -> Одобрено (провайдер одобряет запрос на соединение)\r\nОжидает -> Отклонено (провайдер отклоняет запрос на соединение)\r\nОжидает -> Отключено (провайдер удаляет соединение)\r\nОдобрено -> Отклонено (оператор отклоняет одобренное соединение)\r\nОдобрено -> Отключено (провайдер удаляет соединение)\r\nОтклонено - > Ожидание (пользователь сервиса повторно инициирует отклонённый запрос на соединение)\r\nОтклонён -> Отключение (провайдер удаляет соединение) "Утверждено"
"Отключено"
"Ожидание"
"Отклонено"
"Время ожидания"

Sku

Имя Description Ценность
capacity Если номер SKU поддерживает горизонтальное масштабирование или в, то целое число емкости должно быть включено. Если горизонтальное масштабирование невозможно для ресурса, это может быть опущено. инт
family Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. струна
имя Имя номера SKU. Пример - П3. Обычно это код буквы и числа строка (обязательно)
size Размер номера SKU. Если поле имени является сочетанием уровня и другого значения, это будет автономный код. струна
tier Это поле необходимо реализовать поставщиком ресурсов, если служба имеет несколько уровней, но не требуется для PUT. 'Basic'
'Free'
'Premium'
'Standard'

UserAssignedIdentities

Имя Description Ценность

UserAssignedIdentity

Имя Description Ценность

WorkspaceHubConfig (Конфигурация для WorkspaceHubConfig)

Имя Description Ценность
additionalWorkspaceStorageAccounts строка[]
defaultWorkspaceResourceGroup струна

Свойства рабочего пространства

Имя Description Ценность
allowPublicAccessWhenBehindVnet Флаг, указывающий, следует ли разрешить общедоступный доступ при использовании виртуальной сети. bool
allowRoleAssignmentOnRG Флаг, указывающий, будет ли выполняться назначение ролей для MSI рабочей области на уровне группы ресурсов. bool
аналитика приложений Идентификатор ARM аналитики приложений, связанной с этой рабочей областью. струна
АссоциированныеРабочие пространства строка[]
containerRegistries строка[]
containerRegistry Идентификатор ARM реестра контейнеров, связанного с этой рабочей областью. струна
описание Описание этой рабочей области. струна
discoveryUrl URL-адрес службы обнаружения для идентификации региональных конечных точек для служб экспериментирования машинного обучения струна
enableDataIsolation bool
enableServiceSideCMKEncryption bool
enableSimplifiedCmk Пометка, чтобы определить, следует ли включить упрощенную cmK для этой рабочей области. bool
enableSoftwareBill ofMaterials Пометка, чтобы определить, следует ли включить SoftwareBillOfMaterials для этой рабочей области. bool
encryption EncryptionProperty
существующие пространстваWorkspaces строка[]
featureStoreSettings Параметры рабочей области типа хранилища компонентов. FeatureStoreSettings
friendlyName Понятное имя для этой рабочей области. Это имя в изменяемом формате струна
hbiWorkspace Флаг для сигнала данных HBI в рабочей области и уменьшения диагностических данных, собранных службой. bool
hubResourceId струна
imageBuildCompute Имя вычисления для сборки образа струна
Список ipAllowlist Список адресов IPv4, разрешенных для доступа к рабочей области. строка[]
Приложение keyVault Идентификатор ARM хранилища ключей, связанного с этой рабочей областью. Это невозможно изменить после создания рабочей области струна
Хранилища ключей строка[]
управляемая сеть Параметры управляемой сети для рабочей области машинного обучения. ManagedNetworkSettings (УправляемыеNetworkSettings)
networkAcls Набор правил, определяющих доступность сети рабочей области. NetworkAcls
primaryUserAssignedIdentity Идентификатор ресурса удостоверения, назначаемого пользователем, который представляет удостоверение рабочей области. струна
provisionNetworkNow Установите для активации подготовки управляемой виртуальной сети с параметрами по умолчанию при создании рабочей области с включенной управляемой виртуальной сетью или в противном случае ничего не делает. bool
доступ к публичной сети Разрешены ли запросы из общедоступной сети. 'Disabled'
'Enabled'
бессерверныеComputeSettings Параметры бессерверных вычислений в рабочей области БессерверныеComputeSettings
serviceManagedResourcesSettings Параметры управляемого ресурса службы. ServiceManagedResourcesSettings
sharedPrivateLinkResources Список общих ресурсов приватного канала в этой рабочей области. SharedPrivateLinkResource[]
softDeleteRetentionInDays Время хранения в днях после того, как рабочая область будет удалена обратимо. инт
storageAccount Идентификатор ARM учетной записи хранения, связанной с этой рабочей областью. Это невозможно изменить после создания рабочей области струна
storageAccounts строка[]
systemDatastoresAuthMode Режим проверки подлинности, используемый для доступа к системным хранилищам данных рабочей области. AccessKey
"Удостоверение"
UserDelegationSAS
v1LegacyMode Включение параметра v1_legacy_mode может препятствовать использованию функций, предоставляемых API версии 2. bool
workspaceHubConfig Объект конфигурации WorkspaceHub. WorkspaceHubConfig

Рабочие теги

Имя Description Ценность

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

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

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

Template Description
Базовая настройка Azure AI Foundry

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

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

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

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

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

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

Развертывание в Azure
В этом наборе шаблонов Bicep показано, как настроить сквозную настройку Машинного обучения Azure. Эта эталонная реализация включает рабочую область, вычислительный кластер, вычислительный экземпляр и присоединенный частный кластер AKS.
сквозной настройке машинного обучения Azure (устаревшая версия)

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

Развертывание в Azure
Этот шаблон создает новую рабочую область машинного обучения Azure, а также зашифрованную учетную запись хранения, ведение журнала KeyVault и Application Insights
ключи API установки базового агента

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

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

Развертывание в Azure
Этот шаблон создает рабочую область Машинного обучения Azure с несколькими наборами данных & хранилищами данных.
создание целевого объекта вычислений AKS с частным IP-адресом

Развертывание в Azure
Этот шаблон создает целевой объект вычислений AKS в данной рабочей области службы машинного обучения Azure с частным IP-адресом.
создание рабочей области службы машинного обучения Azure

Развертывание в Azure
Этот шаблон развертывания указывает рабочую область машинного обучения Azure и связанные с ней ресурсы, включая Azure Key Vault, службу хранилища Azure, Azure Application Insights и реестр контейнеров Azure. В этой конфигурации описывается минимальный набор ресурсов, необходимых для начала работы с Машинным обучением Azure.
Создание рабочей области службы машинного обучения Azure (CMK)

Развертывание в Azure
Этот шаблон развертывания указывает, как создать рабочую область Машинного обучения Azure с шифрованием на стороне службы с помощью ключей шифрования.
Создание рабочей области службы машинного обучения Azure (CMK)

Развертывание в Azure
Этот шаблон развертывания указывает рабочую область машинного обучения Azure и связанные с ней ресурсы, включая Azure Key Vault, службу хранилища Azure, Azure Application Insights и реестр контейнеров Azure. В примере показано, как настроить машинное обучение Azure для шифрования с помощью ключа шифрования, управляемого клиентом.
Создание рабочей области службы машинного обучения Azure (устаревшая версия)

Развертывание в Azure
Этот шаблон развертывания указывает рабочую область машинного обучения Azure и связанные с ней ресурсы, включая Azure Key Vault, службу хранилища Azure, Azure Application Insights и реестр контейнеров Azure. Эта конфигурация описывает набор ресурсов, необходимых для начала работы с Машинным обучением Azure в изолированной сети.
создание рабочей области службы машинного обучения Azure (vnet)

Развертывание в Azure
Этот шаблон развертывания указывает рабочую область машинного обучения Azure и связанные с ней ресурсы, включая Azure Key Vault, службу хранилища Azure, Azure Application Insights и реестр контейнеров Azure. Эта конфигурация описывает набор ресурсов, необходимых для начала работы с Машинным обучением Azure в изолированной сети.
Развертывание Secure AI Foundry с помощью управляемой виртуальной сети

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

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

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

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

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

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

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces@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 = {
      allowPublicAccessWhenBehindVnet = bool
      allowRoleAssignmentOnRG = bool
      applicationInsights = "string"
      associatedWorkspaces = [
        "string"
      ]
      containerRegistries = [
        "string"
      ]
      containerRegistry = "string"
      description = "string"
      discoveryUrl = "string"
      enableDataIsolation = bool
      enableServiceSideCMKEncryption = bool
      enableSimplifiedCmk = bool
      enableSoftwareBillOfMaterials = bool
      encryption = {
        cosmosDbResourceId = "string"
        identity = {
          userAssignedIdentity = "string"
        }
        keyVaultProperties = {
          identityClientId = "string"
          keyIdentifier = "string"
          keyVaultArmId = "string"
        }
        searchAccountResourceId = "string"
        status = "string"
        storageAccountResourceId = "string"
      }
      existingWorkspaces = [
        "string"
      ]
      featureStoreSettings = {
        computeRuntime = {
          sparkRuntimeVersion = "string"
        }
        offlineStoreConnectionName = "string"
        onlineStoreConnectionName = "string"
      }
      friendlyName = "string"
      hbiWorkspace = bool
      hubResourceId = "string"
      imageBuildCompute = "string"
      ipAllowlist = [
        "string"
      ]
      keyVault = "string"
      keyVaults = [
        "string"
      ]
      managedNetwork = {
        enableNetworkMonitor = bool
        firewallSku = "string"
        isolationMode = "string"
        managedNetworkKind = "string"
        outboundRules = {
          {customized property} = {
            category = "string"
            status = "string"
            type = "string"
            // For remaining properties, see OutboundRule objects
          }
        }
        status = {
          sparkReady = bool
          status = "string"
        }
      }
      networkAcls = {
        defaultAction = "string"
        ipRules = [
          {
            value = "string"
          }
        ]
      }
      primaryUserAssignedIdentity = "string"
      provisionNetworkNow = bool
      publicNetworkAccess = "string"
      serverlessComputeSettings = {
        serverlessComputeCustomSubnet = "string"
        serverlessComputeNoPublicIP = bool
      }
      serviceManagedResourcesSettings = {
        cosmosDb = {
          collectionsThroughput = int
        }
      }
      sharedPrivateLinkResources = [
        {
          name = "string"
          properties = {
            groupId = "string"
            privateLinkResourceId = "string"
            requestMessage = "string"
            status = "string"
          }
        }
      ]
      softDeleteRetentionInDays = int
      storageAccount = "string"
      storageAccounts = [
        "string"
      ]
      systemDatastoresAuthMode = "string"
      v1LegacyMode = bool
      workspaceHubConfig = {
        additionalWorkspaceStorageAccounts = [
          "string"
        ]
        defaultWorkspaceResourceGroup = "string"
      }
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Объекты OutboundRule

Задайте свойство type , чтобы указать тип объекта.

Для полное доменное имяиспользуйте:

{
  destination = "string"
  type = "FQDN"
}

Для PrivateEndpointиспользуйте:

{
  destination = {
    serviceResourceId = "string"
    sparkEnabled = bool
    sparkStatus = "string"
    subresourceTarget = "string"
  }
  fqdns = [
    "string"
  ]
  type = "PrivateEndpoint"
}

Для ServiceTagиспользуйте:

{
  destination = {
    action = "string"
    addressPrefixes = [
      "string"
    ]
    portRanges = "string"
    protocol = "string"
    serviceTag = "string"
  }
  type = "ServiceTag"
}

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

Microsoft.MachineLearningServices/workspaces

Имя Description Ценность
identity Удостоверения управляемой службы, назначенные этому ресурсу. ManagedServiceIdentity
добрый струна
location струна
имя имя ресурса. string

Constraints:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ (обязательно)
properties Дополнительные атрибуты сущности. WorkspaceProperties (обязательно)
sku Необязательно. Это поле требуется для реализации RP, так как AML поддерживает несколько уровней. Sku
tags Теги ресурсов Словарь имен и значений тегов.
type Тип ресурса "Microsoft.MachineLearningServices/workspaces@2025-10-01-preview"

ComputeRuntimeDto

Имя Description Ценность
sparkRuntimeVersion струна

CosmosDbSettings (Настройки CosmosDb)

Имя Description Ценность
collectionsПропускная способность инт

EncryptionProperty

Имя Description Ценность
cosmosDbResourceId Учетная запись byok cosmosdb, которую клиент приносит для хранения данных клиента
с шифрованием
струна
identity Удостоверение для использования с ключомVault IdentityForCmk
keyVaultProperties Сведения о keyVault для шифрования KeyVaultProperties (обязательно)
searchAccountResourceId Учетная запись поиска byok, которую клиент приносит для хранения данных клиента
с шифрованием
струна
статус Указывает, включена ли шифрование для рабочей области. 'Disabled'
«Включено» (обязательно)
storageAccountResourceId Учетная запись хранения byok, которую клиент приносит для хранения данных клиента
с шифрованием
струна

FeatureStoreSettings

Имя Description Ценность
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName струна
onlineStoreConnectionName струна

Правило FqdnOutboundRule

Имя Description Ценность
destination струна
type Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. Полное доменное имя (обязательно)

IdentityForCmk

Имя Description Ценность
userAssignedIdentity UserAssignedIdentity для получения ключа шифрования из keyVault струна

IPRule

Имя Description Ценность
value Диапазон адресов IPv4 в нотации CIDR, например "124.56.78.91" (простой IP-адрес) или "124.56.78.0/24" (все адреса, начинающиеся с 124.56.78). Значение может быть "Разрешить" или "Запретить". струна

Свойства KeyVault

Имя Description Ценность
identityClientId В настоящее время мы поддерживаем только SystemAssigned MSI.
Это необходимо, когда мы поддерживаем UserAssignedIdentities
струна
keyIdentifier Идентификатор ключа KeyVault для шифрования данных string

Constraints:
Минимальная длина = 1
Pattern = [a-zA-Z0-9_] (обязательно)
keyVaultArmId Идентификатор Arm KeyVault, содержащий ключ шифрования данных string

Constraints:
Минимальная длина = 1
Pattern = [a-zA-Z0-9_] (обязательно)

ManagedNetworkProvisionStatus (Статус управляемой сети)

Имя Description Ценность
sparkReady bool
статус Состояние управляемой сети рабочей области машинного обучения. 'Active'
'Inactive'

ManagedNetworkSettings (УправляемыеNetworkSettings)

Имя Description Ценность
enableNetworkMonitor Флаг, указывающий, нужно ли включить мониторинг для управляемой сети. bool
firewallSku SKU брандмауэра, используемого для правил FQDN 'Basic'
'Standard'
режим изоляции Режим изоляции для управляемой сети рабочей области машинного обучения. AllowInternetOutbound
AllowOnlyApprovedOutbound
'Disabled'
managedNetworkKind Вид управляемой сети. Пользователи могут переключаться с V1 на V2 для детального управления доступом, но не могут переключиться обратно на V1 после включения V2. 'V1'
'V2'
outboundRules Словарь <OutboundRule> ManagedNetworkSettingsOutboundRules (УправляемыеNetworkSettingsOutboundRules (УправляемыеNetworkSettingsOutboundRules
статус Состояние подготовки для управляемой сети рабочей области машинного обучения. ManagedNetworkProvisionStatus (Статус управляемой сети)

ManagedNetworkSettingsOutboundRules (УправляемыеNetworkSettingsOutboundRules (УправляемыеNetworkSettingsOutboundRules

Имя Description Ценность

ManagedServiceIdentity

Имя Description Ценность
type Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned). 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
UserAssigned (обязательно)
userAssignedIdentities Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. UserAssignedIdentities

NetworkAcls

Имя Description Ценность
defaultAction Действие по умолчанию, если правило из ipRules и из virtualNetworkRules не совпадает. Это используется только после оценки свойства обхода. 'Allow'
'Deny'
ipRules Правила, управляющие специальными возможностями ресурса из определенного IP-адреса или диапазона IP-адресов. IPRule[]

Исходящее правило

Имя Description Ценность
категория Категория правила исходящего трафика управляемой сети рабочей области машинного обучения. "Зависимость"
"Рекомендуется"
"Обязательный"
UserDefined
статус Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Active'
'Deleting'
'Failed'
'Inactive'
Подготовка
type Задайте значение FQDN для типа FqdnOutboundRule. Установите значение PrivateEndpoint для типа PrivateEndpointOutboundRule. Установите значение ServiceTag для типа ServiceTagoutboundRule. Полное доменное имя
PrivateEndpoint
ServiceTag (обязательный)

PrivateEndpointDestination (Частная конечная точкаDestination)

Имя Description Ценность
serviceResourceId Определение типа, которое ссылается на идентификатор ресурса Azure Resource Manager. струна
sparkEnabled bool
sparkStatus Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Active'
'Deleting'
'Failed'
'Inactive'
Подготовка
подресурсЦель струна

Правило PrivateEndpointOutboundRule

Имя Description Ценность
destination Назначение частной конечной точки для правила исходящего трафика частной конечной точки для управляемой сети рабочей области машинного обучения. PrivateEndpointDestination (Частная конечная точкаDestination)
Файловые доменные имена строка[]
type Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. PrivateEndpoint (обязательный)

БессерверныеComputeSettings

Имя Description Ценность
serverlessComputeCustomSubnet Идентификатор ресурса существующей подсети виртуальной сети, в которой должны быть развернуты бессерверные вычислительные узлы. струна
бессерверныйComputeNoPublicIP Флаг для сигнала, если бессерверные вычислительные узлы, развернутые в пользовательской виртуальной сети, не будут иметь общедоступных IP-адресов для рабочей области с частной конечной точкой bool

ServiceManagedResourcesSettings

Имя Description Ценность
cosmosDb CosmosDbSettings (Настройки CosmosDb)

ServiceTagDestination

Имя Description Ценность
действие Перечисление действия для правила сети. 'Allow'
'Deny'
addressПрефиксы Необязательный, если он указан, свойство ServiceTag будет игнорироваться. строка[]
Диапазоны портов струна
protocol струна
ServiceTag струна

ServiceTagOutboundRule

Имя Description Ценность
destination Назначение тега службы для правила исходящего трафика тега службы для управляемой сети рабочей области машинного обучения. ServiceTagDestination
type Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. ServiceTag (обязательный)

SharedPrivateLinkResource

Имя Description Ценность
имя Уникальное имя приватного канала струна
properties Свойства общего ресурса приватного канала. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Имя Description Ценность
groupId идентификатор группы приватного канала струна
privateLinkResourceId Идентификатор ресурса, на который ссылается приватный канал струна
requestMessage Запрос на сообщение струна
статус Статус соединения потребителя сервиса с провайдером\r\nВозможные переходы состояния\r\nОжидается -> Одобрено (провайдер одобряет запрос на соединение)\r\nОжидает -> Отклонено (провайдер отклоняет запрос на соединение)\r\nОжидает -> Отключено (провайдер удаляет соединение)\r\nОдобрено -> Отклонено (оператор отклоняет одобренное соединение)\r\nОдобрено -> Отключено (провайдер удаляет соединение)\r\nОтклонено - > Ожидание (пользователь сервиса повторно инициирует отклонённый запрос на соединение)\r\nОтклонён -> Отключение (провайдер удаляет соединение) "Утверждено"
"Отключено"
"Ожидание"
"Отклонено"
"Время ожидания"

Sku

Имя Description Ценность
capacity Если номер SKU поддерживает горизонтальное масштабирование или в, то целое число емкости должно быть включено. Если горизонтальное масштабирование невозможно для ресурса, это может быть опущено. инт
family Если служба имеет разные поколения оборудования для одного номера SKU, это можно записать здесь. струна
имя Имя номера SKU. Пример - П3. Обычно это код буквы и числа строка (обязательно)
size Размер номера SKU. Если поле имени является сочетанием уровня и другого значения, это будет автономный код. струна
tier Это поле необходимо реализовать поставщиком ресурсов, если служба имеет несколько уровней, но не требуется для PUT. 'Basic'
'Free'
'Premium'
'Standard'

UserAssignedIdentities

Имя Description Ценность

UserAssignedIdentity

Имя Description Ценность

WorkspaceHubConfig (Конфигурация для WorkspaceHubConfig)

Имя Description Ценность
additionalWorkspaceStorageAccounts строка[]
defaultWorkspaceResourceGroup струна

Свойства рабочего пространства

Имя Description Ценность
allowPublicAccessWhenBehindVnet Флаг, указывающий, следует ли разрешить общедоступный доступ при использовании виртуальной сети. bool
allowRoleAssignmentOnRG Флаг, указывающий, будет ли выполняться назначение ролей для MSI рабочей области на уровне группы ресурсов. bool
аналитика приложений Идентификатор ARM аналитики приложений, связанной с этой рабочей областью. струна
АссоциированныеРабочие пространства строка[]
containerRegistries строка[]
containerRegistry Идентификатор ARM реестра контейнеров, связанного с этой рабочей областью. струна
описание Описание этой рабочей области. струна
discoveryUrl URL-адрес службы обнаружения для идентификации региональных конечных точек для служб экспериментирования машинного обучения струна
enableDataIsolation bool
enableServiceSideCMKEncryption bool
enableSimplifiedCmk Пометка, чтобы определить, следует ли включить упрощенную cmK для этой рабочей области. bool
enableSoftwareBill ofMaterials Пометка, чтобы определить, следует ли включить SoftwareBillOfMaterials для этой рабочей области. bool
encryption EncryptionProperty
существующие пространстваWorkspaces строка[]
featureStoreSettings Параметры рабочей области типа хранилища компонентов. FeatureStoreSettings
friendlyName Понятное имя для этой рабочей области. Это имя в изменяемом формате струна
hbiWorkspace Флаг для сигнала данных HBI в рабочей области и уменьшения диагностических данных, собранных службой. bool
hubResourceId струна
imageBuildCompute Имя вычисления для сборки образа струна
Список ipAllowlist Список адресов IPv4, разрешенных для доступа к рабочей области. строка[]
Приложение keyVault Идентификатор ARM хранилища ключей, связанного с этой рабочей областью. Это невозможно изменить после создания рабочей области струна
Хранилища ключей строка[]
управляемая сеть Параметры управляемой сети для рабочей области машинного обучения. ManagedNetworkSettings (УправляемыеNetworkSettings)
networkAcls Набор правил, определяющих доступность сети рабочей области. NetworkAcls
primaryUserAssignedIdentity Идентификатор ресурса удостоверения, назначаемого пользователем, который представляет удостоверение рабочей области. струна
provisionNetworkNow Установите для активации подготовки управляемой виртуальной сети с параметрами по умолчанию при создании рабочей области с включенной управляемой виртуальной сетью или в противном случае ничего не делает. bool
доступ к публичной сети Разрешены ли запросы из общедоступной сети. 'Disabled'
'Enabled'
бессерверныеComputeSettings Параметры бессерверных вычислений в рабочей области БессерверныеComputeSettings
serviceManagedResourcesSettings Параметры управляемого ресурса службы. ServiceManagedResourcesSettings
sharedPrivateLinkResources Список общих ресурсов приватного канала в этой рабочей области. SharedPrivateLinkResource[]
softDeleteRetentionInDays Время хранения в днях после того, как рабочая область будет удалена обратимо. инт
storageAccount Идентификатор ARM учетной записи хранения, связанной с этой рабочей областью. Это невозможно изменить после создания рабочей области струна
storageAccounts строка[]
systemDatastoresAuthMode Режим проверки подлинности, используемый для доступа к системным хранилищам данных рабочей области. AccessKey
"Удостоверение"
UserDelegationSAS
v1LegacyMode Включение параметра v1_legacy_mode может препятствовать использованию функций, предоставляемых API версии 2. bool
workspaceHubConfig Объект конфигурации WorkspaceHub. WorkspaceHubConfig

Рабочие теги

Имя Description Ценность

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

Примеры Terraform

Простой пример развертывания рабочей области Машинного обучения Azure.

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

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

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

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

data "azurerm_client_config" "current" {
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
  body = {
    tags = {
      stage = "test"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "storageAccount" {
  type      = "Microsoft.Storage/storageAccounts@2021-09-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "StorageV2"
    properties = {
      accessTier                   = "Hot"
      allowBlobPublicAccess        = true
      allowCrossTenantReplication  = true
      allowSharedKeyAccess         = true
      defaultToOAuthAuthentication = false
      encryption = {
        keySource = "Microsoft.Storage"
        services = {
          queue = {
            keyType = "Service"
          }
          table = {
            keyType = "Service"
          }
        }
      }
      isHnsEnabled      = false
      isNfsV3Enabled    = false
      isSftpEnabled     = false
      minimumTlsVersion = "TLS1_2"
      networkAcls = {
        defaultAction = "Allow"
      }
      publicNetworkAccess      = "Enabled"
      supportsHttpsTrafficOnly = true
    }
    sku = {
      name = "Standard_LRS"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "component" {
  type      = "Microsoft.Insights/components@2020-02-02"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "web"
    properties = {
      Application_Type                = "web"
      DisableIpMasking                = false
      DisableLocalAuth                = false
      ForceCustomerStorageForProfiler = false
      RetentionInDays                 = 90
      SamplingPercentage              = 100
      publicNetworkAccessForIngestion = "Enabled"
      publicNetworkAccessForQuery     = "Enabled"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "vault" {
  type      = "Microsoft.KeyVault/vaults@2021-10-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      accessPolicies = [
        {
          objectId = "45a2d1ea-488a-44b0-bb2e-3cd8e485ebef"
          permissions = {
            certificates = [
              "all",
            ]
            keys = [
              "all",
            ]
            secrets = [
              "all",
            ]
            storage = []
          }
          tenantId = data.azurerm_client_config.current.tenant_id
        }
      ]
      createMode                   = "default"
      enablePurgeProtection        = true
      enableRbacAuthorization      = false
      enableSoftDelete             = true
      enabledForDeployment         = false
      enabledForDiskEncryption     = false
      enabledForTemplateDeployment = false
      publicNetworkAccess          = "Enabled"
      sku = {
        family = "A"
        name   = "standard"
      }
      tenantId = data.azurerm_client_config.current.tenant_id
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "workspace" {
  type      = "Microsoft.MachineLearningServices/workspaces@2022-05-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  identity {
    type         = "SystemAssigned"
    identity_ids = []
  }
  body = {
    properties = {
      applicationInsights = azapi_resource.component.id
      keyVault            = azapi_resource.vault.id
      publicNetworkAccess = "Disabled"
      storageAccount      = azapi_resource.storageAccount.id
      v1LegacyMode        = false
    }
    sku = {
      name = "Basic"
      tier = "Basic"
    }
  }
  ignore_casing             = true
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

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

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

Модуль Description
рабочей области служб машинного обучения Модуль ресурсов AVM для рабочей области служб машинного обучения