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


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

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

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

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

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

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

resource symbolicname 'Microsoft.MachineLearningServices/workspaces@2025-06-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    allowPublicAccessWhenBehindVnet: bool
    applicationInsights: 'string'
    associatedWorkspaces: [
      'string'
    ]
    containerRegistry: 'string'
    description: 'string'
    discoveryUrl: 'string'
    enableDataIsolation: bool
    enableServiceSideCMKEncryption: bool
    encryption: {
      identity: {
        userAssignedIdentity: 'string'
      }
      keyVaultProperties: {
        identityClientId: 'string'
        keyIdentifier: 'string'
        keyVaultArmId: 'string'
      }
      status: 'string'
    }
    featureStoreSettings: {
      computeRuntime: {
        sparkRuntimeVersion: 'string'
      }
      offlineStoreConnectionName: 'string'
      onlineStoreConnectionName: 'string'
    }
    friendlyName: 'string'
    hbiWorkspace: bool
    hubResourceId: 'string'
    imageBuildCompute: 'string'
    keyVault: 'string'
    managedNetwork: {
      firewallPublicIpAddress: 'string'
      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'
      }
    }
    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'
        }
      }
    ]
    storageAccount: '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

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

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

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

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

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

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

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

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

Microsoft.MachineLearningServices/workspaces

Name Description Value
identity Удостоверение ресурса. ManagedServiceIdentity
kind string
location Указывает расположение ресурса. string
name имя ресурса. string

Constraints:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ (обязательно)
properties Свойства рабочей области машинного обучения. WorkspaceProperties
sku SKU рабочей области. Sku
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

ComputeRuntimeDto

Name Description Value
sparkRuntimeVersion string

CosmosDbSettings

Name Description Value
collectionsThroughput Пропускная способность коллекций в базе данных Cosmosdb int

EncryptionKeyVaultProperties

Name Description Value
identityClientId Для дальнейшего использования — идентификатор клиента удостоверения, который будет использоваться для доступа к хранилищу ключей. string
keyIdentifier URI хранилища ключей для доступа к ключу шифрования. строка (обязательно)
keyVaultArmId ArmId ключа, в котором присутствует ключ шифрования клиента. строка (обязательно)

EncryptionProperty

Name Description Value
identity Удостоверение, которое будет использоваться для доступа к хранилищу ключей для шифрования неактивных данных. IdentityForCmk
keyVaultProperties Свойства хранилища ключей клиента. EncryptionKeyVaultProperties (обязательно)
status Указывает, включена ли шифрование для рабочей области. 'Disabled'
"Включено" (обязательно)

FeatureStoreSettings

Name Description Value
computeRuntime Конфигурация среды выполнения вычислений для рабочей области типа хранилища компонентов. ComputeRuntimeDto
offlineStoreConnectionName string
onlineStoreConnectionName string

FqdnOutboundRule

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

IdentityForCmk

Name Description Value
userAssignedIdentity ArmId назначаемого пользователем удостоверения, которое будет использоваться для доступа к управляемому клиенту хранилищу ключей string

ManagedNetworkProvisionStatus

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

ManagedNetworkSettings

Name Description Value
firewallPublicIpAddress Общедоступный IP-адрес, назначенный Брандмауэру Azure. string
firewallSku SKU брандмауэра, используемого для правил FQDN 'Basic'
'Standard'
isolationMode Режим изоляции для управляемой сети рабочей области машинного обучения. 'AllowInternetOutbound'
'AllowOnlyApprovedOutbound'
'Disabled'
managedNetworkKind Вид управляемой сети. Пользователи могут переключаться с V1 на V2 для детального управления доступом, но не могут переключиться обратно на V1 после включения V2. 'V1'
'V2'
outboundRules Словарь <OutboundRule> ManagedNetworkSettingsOutboundRules
status Состояние подготовки для управляемой сети рабочей области машинного обучения. ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

Name Description Value

ManagedServiceIdentity

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

OutboundRule

Name Description Value
category Категория правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Dependency'
'Recommended'
'Required'
'UserDefined'
status Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Active'
'Deleting'
'Failed'
'Inactive'
'Provisioning'
type Задайте значение FQDN для типа FqdnOutboundRule. Установите значение PrivateEndpoint для типа PrivateEndpointOutboundRule. Установите значение ServiceTag для типа ServiceTagoutboundRule. 'FQDN'
'PrivateEndpoint'
ServiceTag (обязательный)

PrivateEndpointDestination

Name Description Value
serviceResourceId string
sparkEnabled bool
sparkStatus Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Active'
'Deleting'
'Failed'
'Inactive'
'Provisioning'
subresourceTarget string

PrivateEndpointOutboundRule

Name Description Value
destination Назначение частной конечной точки для правила исходящего трафика частной конечной точки для управляемой сети рабочей области машинного обучения. PrivateEndpointDestination
type Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'PrivateEndpoint' (обязательно)

ServerlessComputeSettings

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

ServiceManagedResourcesSettings

Name Description Value
cosmosDb Параметры для управляемой учетной записи Cosmosdb службы. CosmosDbSettings

ServiceTagDestination

Name Description Value
action Перечисление действия для правила сети. 'Allow'
'Deny'
portRanges string
protocol string
serviceTag string

ServiceTagOutboundRule

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

SharedPrivateLinkResource

Name Description Value
name Уникальное имя приватного канала. string
properties Свойства ресурса. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Name Description Value
groupId Идентификатор группы ресурсов приватного канала. string
privateLinkResourceId Идентификатор ресурса, на который ссылается приватный канал. string
requestMessage Запросить сообщение. string
status Указывает, утверждено ли подключение, отклонено или удалено владельцем службы. 'Approved'
'Disconnected'
'Pending'
'Rejected'
'Timeout'

Sku

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

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

WorkspaceHubConfig

Name Description Value
additionalWorkspaceStorageAccounts string[]
defaultWorkspaceResourceGroup string

WorkspaceProperties

Name Description Value
allowPublicAccessWhenBehindVnet Флаг, указывающий, следует ли разрешить общедоступный доступ при использовании виртуальной сети. bool
applicationInsights Идентификатор ARM аналитики приложений, связанной с этой рабочей областью. string
associatedWorkspaces string[]
containerRegistry Идентификатор ARM реестра контейнеров, связанного с этой рабочей областью. string
description Описание этой рабочей области. string
discoveryUrl URL-адрес службы обнаружения для идентификации региональных конечных точек для служб экспериментирования машинного обучения string
enableDataIsolation bool
enableServiceSideCMKEncryption bool
encryption Параметры шифрования рабочей области Машинного обучения Azure. EncryptionProperty
featureStoreSettings Параметры рабочей области типа хранилища компонентов. FeatureStoreSettings
friendlyName Понятное имя для этой рабочей области. Это имя в изменяемом формате string
hbiWorkspace Флаг для сигнала данных HBI в рабочей области и уменьшения диагностических данных, собранных службой. bool
hubResourceId string
imageBuildCompute Имя вычисления для сборки образа string
keyVault Идентификатор ARM хранилища ключей, связанного с этой рабочей областью. Это невозможно изменить после создания рабочей области string
managedNetwork Параметры управляемой сети для рабочей области машинного обучения. ManagedNetworkSettings
primaryUserAssignedIdentity Идентификатор ресурса удостоверения, назначаемого пользователем, который представляет удостоверение рабочей области. string
provisionNetworkNow Установите для активации подготовки управляемой виртуальной сети с параметрами по умолчанию при создании рабочей области с включенной управляемой виртуальной сетью или в противном случае ничего не делает. bool
publicNetworkAccess Разрешены ли запросы из общедоступной сети. 'Disabled'
'Enabled'
serverlessComputeSettings Параметры бессерверных вычислений, созданных в рабочей области ServerlessComputeSettings
serviceManagedResourcesSettings Параметры управляемого ресурса службы. ServiceManagedResourcesSettings
sharedPrivateLinkResources Список общих ресурсов приватного канала в этой рабочей области. SharedPrivateLinkResource[]
storageAccount Идентификатор ARM учетной записи хранения, связанной с этой рабочей областью. Это невозможно изменить после создания рабочей области string
systemDatastoresAuthMode Режим проверки подлинности, используемый для доступа к системным хранилищам данных рабочей области. 'AccessKey'
'Identity'
'UserDelegationSAS'
v1LegacyMode Включение параметра v1_legacy_mode может препятствовать использованию функций, предоставляемых API версии 2. bool
workspaceHubConfig Объект конфигурации WorkspaceHub. WorkspaceHubConfig

WorkspaceTags

Name Description Value

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

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

Module 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-06-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "allowPublicAccessWhenBehindVnet": "bool",
    "applicationInsights": "string",
    "associatedWorkspaces": [ "string" ],
    "containerRegistry": "string",
    "description": "string",
    "discoveryUrl": "string",
    "enableDataIsolation": "bool",
    "enableServiceSideCMKEncryption": "bool",
    "encryption": {
      "identity": {
        "userAssignedIdentity": "string"
      },
      "keyVaultProperties": {
        "identityClientId": "string",
        "keyIdentifier": "string",
        "keyVaultArmId": "string"
      },
      "status": "string"
    },
    "featureStoreSettings": {
      "computeRuntime": {
        "sparkRuntimeVersion": "string"
      },
      "offlineStoreConnectionName": "string",
      "onlineStoreConnectionName": "string"
    },
    "friendlyName": "string",
    "hbiWorkspace": "bool",
    "hubResourceId": "string",
    "imageBuildCompute": "string",
    "keyVault": "string",
    "managedNetwork": {
      "firewallPublicIpAddress": "string",
      "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"
      }
    },
    "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"
        }
      }
    ],
    "storageAccount": "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

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

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

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

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

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

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

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

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

Microsoft.MachineLearningServices/workspaces

Name Description Value
apiVersion Версия API '2025-06-01'
identity Удостоверение ресурса. ManagedServiceIdentity
kind string
location Указывает расположение ресурса. string
name имя ресурса. string

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

ComputeRuntimeDto

Name Description Value
sparkRuntimeVersion string

CosmosDbSettings

Name Description Value
collectionsThroughput Пропускная способность коллекций в базе данных Cosmosdb int

EncryptionKeyVaultProperties

Name Description Value
identityClientId Для дальнейшего использования — идентификатор клиента удостоверения, который будет использоваться для доступа к хранилищу ключей. string
keyIdentifier URI хранилища ключей для доступа к ключу шифрования. строка (обязательно)
keyVaultArmId ArmId ключа, в котором присутствует ключ шифрования клиента. строка (обязательно)

EncryptionProperty

Name Description Value
identity Удостоверение, которое будет использоваться для доступа к хранилищу ключей для шифрования неактивных данных. IdentityForCmk
keyVaultProperties Свойства хранилища ключей клиента. EncryptionKeyVaultProperties (обязательно)
status Указывает, включена ли шифрование для рабочей области. 'Disabled'
"Включено" (обязательно)

FeatureStoreSettings

Name Description Value
computeRuntime Конфигурация среды выполнения вычислений для рабочей области типа хранилища компонентов. ComputeRuntimeDto
offlineStoreConnectionName string
onlineStoreConnectionName string

FqdnOutboundRule

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

IdentityForCmk

Name Description Value
userAssignedIdentity ArmId назначаемого пользователем удостоверения, которое будет использоваться для доступа к управляемому клиенту хранилищу ключей string

ManagedNetworkProvisionStatus

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

ManagedNetworkSettings

Name Description Value
firewallPublicIpAddress Общедоступный IP-адрес, назначенный Брандмауэру Azure. string
firewallSku SKU брандмауэра, используемого для правил FQDN 'Basic'
'Standard'
isolationMode Режим изоляции для управляемой сети рабочей области машинного обучения. 'AllowInternetOutbound'
'AllowOnlyApprovedOutbound'
'Disabled'
managedNetworkKind Вид управляемой сети. Пользователи могут переключаться с V1 на V2 для детального управления доступом, но не могут переключиться обратно на V1 после включения V2. 'V1'
'V2'
outboundRules Словарь <OutboundRule> ManagedNetworkSettingsOutboundRules
status Состояние подготовки для управляемой сети рабочей области машинного обучения. ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

Name Description Value

ManagedServiceIdentity

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

OutboundRule

Name Description Value
category Категория правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Dependency'
'Recommended'
'Required'
'UserDefined'
status Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Active'
'Deleting'
'Failed'
'Inactive'
'Provisioning'
type Задайте значение FQDN для типа FqdnOutboundRule. Установите значение PrivateEndpoint для типа PrivateEndpointOutboundRule. Установите значение ServiceTag для типа ServiceTagoutboundRule. 'FQDN'
'PrivateEndpoint'
ServiceTag (обязательный)

PrivateEndpointDestination

Name Description Value
serviceResourceId string
sparkEnabled bool
sparkStatus Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Active'
'Deleting'
'Failed'
'Inactive'
'Provisioning'
subresourceTarget string

PrivateEndpointOutboundRule

Name Description Value
destination Назначение частной конечной точки для правила исходящего трафика частной конечной точки для управляемой сети рабочей области машинного обучения. PrivateEndpointDestination
type Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'PrivateEndpoint' (обязательно)

ServerlessComputeSettings

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

ServiceManagedResourcesSettings

Name Description Value
cosmosDb Параметры для управляемой учетной записи Cosmosdb службы. CosmosDbSettings

ServiceTagDestination

Name Description Value
action Перечисление действия для правила сети. 'Allow'
'Deny'
portRanges string
protocol string
serviceTag string

ServiceTagOutboundRule

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

SharedPrivateLinkResource

Name Description Value
name Уникальное имя приватного канала. string
properties Свойства ресурса. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Name Description Value
groupId Идентификатор группы ресурсов приватного канала. string
privateLinkResourceId Идентификатор ресурса, на который ссылается приватный канал. string
requestMessage Запросить сообщение. string
status Указывает, утверждено ли подключение, отклонено или удалено владельцем службы. 'Approved'
'Disconnected'
'Pending'
'Rejected'
'Timeout'

Sku

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

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

WorkspaceHubConfig

Name Description Value
additionalWorkspaceStorageAccounts string[]
defaultWorkspaceResourceGroup string

WorkspaceProperties

Name Description Value
allowPublicAccessWhenBehindVnet Флаг, указывающий, следует ли разрешить общедоступный доступ при использовании виртуальной сети. bool
applicationInsights Идентификатор ARM аналитики приложений, связанной с этой рабочей областью. string
associatedWorkspaces string[]
containerRegistry Идентификатор ARM реестра контейнеров, связанного с этой рабочей областью. string
description Описание этой рабочей области. string
discoveryUrl URL-адрес службы обнаружения для идентификации региональных конечных точек для служб экспериментирования машинного обучения string
enableDataIsolation bool
enableServiceSideCMKEncryption bool
encryption Параметры шифрования рабочей области Машинного обучения Azure. EncryptionProperty
featureStoreSettings Параметры рабочей области типа хранилища компонентов. FeatureStoreSettings
friendlyName Понятное имя для этой рабочей области. Это имя в изменяемом формате string
hbiWorkspace Флаг для сигнала данных HBI в рабочей области и уменьшения диагностических данных, собранных службой. bool
hubResourceId string
imageBuildCompute Имя вычисления для сборки образа string
keyVault Идентификатор ARM хранилища ключей, связанного с этой рабочей областью. Это невозможно изменить после создания рабочей области string
managedNetwork Параметры управляемой сети для рабочей области машинного обучения. ManagedNetworkSettings
primaryUserAssignedIdentity Идентификатор ресурса удостоверения, назначаемого пользователем, который представляет удостоверение рабочей области. string
provisionNetworkNow Установите для активации подготовки управляемой виртуальной сети с параметрами по умолчанию при создании рабочей области с включенной управляемой виртуальной сетью или в противном случае ничего не делает. bool
publicNetworkAccess Разрешены ли запросы из общедоступной сети. 'Disabled'
'Enabled'
serverlessComputeSettings Параметры бессерверных вычислений, созданных в рабочей области ServerlessComputeSettings
serviceManagedResourcesSettings Параметры управляемого ресурса службы. ServiceManagedResourcesSettings
sharedPrivateLinkResources Список общих ресурсов приватного канала в этой рабочей области. SharedPrivateLinkResource[]
storageAccount Идентификатор ARM учетной записи хранения, связанной с этой рабочей областью. Это невозможно изменить после создания рабочей области string
systemDatastoresAuthMode Режим проверки подлинности, используемый для доступа к системным хранилищам данных рабочей области. 'AccessKey'
'Identity'
'UserDelegationSAS'
v1LegacyMode Включение параметра v1_legacy_mode может препятствовать использованию функций, предоставляемых API версии 2. bool
workspaceHubConfig Объект конфигурации WorkspaceHub. WorkspaceHubConfig

WorkspaceTags

Name Description Value

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

Шаблоны быстрого запуска 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-06-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    kind = "string"
    properties = {
      allowPublicAccessWhenBehindVnet = bool
      applicationInsights = "string"
      associatedWorkspaces = [
        "string"
      ]
      containerRegistry = "string"
      description = "string"
      discoveryUrl = "string"
      enableDataIsolation = bool
      enableServiceSideCMKEncryption = bool
      encryption = {
        identity = {
          userAssignedIdentity = "string"
        }
        keyVaultProperties = {
          identityClientId = "string"
          keyIdentifier = "string"
          keyVaultArmId = "string"
        }
        status = "string"
      }
      featureStoreSettings = {
        computeRuntime = {
          sparkRuntimeVersion = "string"
        }
        offlineStoreConnectionName = "string"
        onlineStoreConnectionName = "string"
      }
      friendlyName = "string"
      hbiWorkspace = bool
      hubResourceId = "string"
      imageBuildCompute = "string"
      keyVault = "string"
      managedNetwork = {
        firewallPublicIpAddress = "string"
        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"
        }
      }
      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"
          }
        }
      ]
      storageAccount = "string"
      systemDatastoresAuthMode = "string"
      v1LegacyMode = bool
      workspaceHubConfig = {
        additionalWorkspaceStorageAccounts = [
          "string"
        ]
        defaultWorkspaceResourceGroup = "string"
      }
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  }
}

Объекты OutboundRule

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

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

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

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

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

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

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

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

Microsoft.MachineLearningServices/workspaces

Name Description Value
identity Удостоверение ресурса. ManagedServiceIdentity
kind string
location Указывает расположение ресурса. string
name имя ресурса. string

Constraints:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ (обязательно)
properties Свойства рабочей области машинного обучения. WorkspaceProperties
sku SKU рабочей области. Sku
tags Теги ресурсов Словарь имен и значений тегов.
type Тип ресурса "Microsoft.MachineLearningServices/workspaces@2025-06-01"

ComputeRuntimeDto

Name Description Value
sparkRuntimeVersion string

CosmosDbSettings

Name Description Value
collectionsThroughput Пропускная способность коллекций в базе данных Cosmosdb int

EncryptionKeyVaultProperties

Name Description Value
identityClientId Для дальнейшего использования — идентификатор клиента удостоверения, который будет использоваться для доступа к хранилищу ключей. string
keyIdentifier URI хранилища ключей для доступа к ключу шифрования. строка (обязательно)
keyVaultArmId ArmId ключа, в котором присутствует ключ шифрования клиента. строка (обязательно)

EncryptionProperty

Name Description Value
identity Удостоверение, которое будет использоваться для доступа к хранилищу ключей для шифрования неактивных данных. IdentityForCmk
keyVaultProperties Свойства хранилища ключей клиента. EncryptionKeyVaultProperties (обязательно)
status Указывает, включена ли шифрование для рабочей области. 'Disabled'
"Включено" (обязательно)

FeatureStoreSettings

Name Description Value
computeRuntime Конфигурация среды выполнения вычислений для рабочей области типа хранилища компонентов. ComputeRuntimeDto
offlineStoreConnectionName string
onlineStoreConnectionName string

FqdnOutboundRule

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

IdentityForCmk

Name Description Value
userAssignedIdentity ArmId назначаемого пользователем удостоверения, которое будет использоваться для доступа к управляемому клиенту хранилищу ключей string

ManagedNetworkProvisionStatus

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

ManagedNetworkSettings

Name Description Value
firewallPublicIpAddress Общедоступный IP-адрес, назначенный Брандмауэру Azure. string
firewallSku SKU брандмауэра, используемого для правил FQDN 'Basic'
'Standard'
isolationMode Режим изоляции для управляемой сети рабочей области машинного обучения. 'AllowInternetOutbound'
'AllowOnlyApprovedOutbound'
'Disabled'
managedNetworkKind Вид управляемой сети. Пользователи могут переключаться с V1 на V2 для детального управления доступом, но не могут переключиться обратно на V1 после включения V2. 'V1'
'V2'
outboundRules Словарь <OutboundRule> ManagedNetworkSettingsOutboundRules
status Состояние подготовки для управляемой сети рабочей области машинного обучения. ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

Name Description Value

ManagedServiceIdentity

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

OutboundRule

Name Description Value
category Категория правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Dependency'
'Recommended'
'Required'
'UserDefined'
status Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Active'
'Deleting'
'Failed'
'Inactive'
'Provisioning'
type Задайте значение FQDN для типа FqdnOutboundRule. Установите значение PrivateEndpoint для типа PrivateEndpointOutboundRule. Установите значение ServiceTag для типа ServiceTagoutboundRule. 'FQDN'
'PrivateEndpoint'
ServiceTag (обязательный)

PrivateEndpointDestination

Name Description Value
serviceResourceId string
sparkEnabled bool
sparkStatus Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'Active'
'Deleting'
'Failed'
'Inactive'
'Provisioning'
subresourceTarget string

PrivateEndpointOutboundRule

Name Description Value
destination Назначение частной конечной точки для правила исходящего трафика частной конечной точки для управляемой сети рабочей области машинного обучения. PrivateEndpointDestination
type Тип правила исходящего трафика управляемой сети рабочей области машинного обучения. 'PrivateEndpoint' (обязательно)

ServerlessComputeSettings

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

ServiceManagedResourcesSettings

Name Description Value
cosmosDb Параметры для управляемой учетной записи Cosmosdb службы. CosmosDbSettings

ServiceTagDestination

Name Description Value
action Перечисление действия для правила сети. 'Allow'
'Deny'
portRanges string
protocol string
serviceTag string

ServiceTagOutboundRule

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

SharedPrivateLinkResource

Name Description Value
name Уникальное имя приватного канала. string
properties Свойства ресурса. SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

Name Description Value
groupId Идентификатор группы ресурсов приватного канала. string
privateLinkResourceId Идентификатор ресурса, на который ссылается приватный канал. string
requestMessage Запросить сообщение. string
status Указывает, утверждено ли подключение, отклонено или удалено владельцем службы. 'Approved'
'Disconnected'
'Pending'
'Rejected'
'Timeout'

Sku

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

UserAssignedIdentities

Name Description Value

UserAssignedIdentity

Name Description Value

WorkspaceHubConfig

Name Description Value
additionalWorkspaceStorageAccounts string[]
defaultWorkspaceResourceGroup string

WorkspaceProperties

Name Description Value
allowPublicAccessWhenBehindVnet Флаг, указывающий, следует ли разрешить общедоступный доступ при использовании виртуальной сети. bool
applicationInsights Идентификатор ARM аналитики приложений, связанной с этой рабочей областью. string
associatedWorkspaces string[]
containerRegistry Идентификатор ARM реестра контейнеров, связанного с этой рабочей областью. string
description Описание этой рабочей области. string
discoveryUrl URL-адрес службы обнаружения для идентификации региональных конечных точек для служб экспериментирования машинного обучения string
enableDataIsolation bool
enableServiceSideCMKEncryption bool
encryption Параметры шифрования рабочей области Машинного обучения Azure. EncryptionProperty
featureStoreSettings Параметры рабочей области типа хранилища компонентов. FeatureStoreSettings
friendlyName Понятное имя для этой рабочей области. Это имя в изменяемом формате string
hbiWorkspace Флаг для сигнала данных HBI в рабочей области и уменьшения диагностических данных, собранных службой. bool
hubResourceId string
imageBuildCompute Имя вычисления для сборки образа string
keyVault Идентификатор ARM хранилища ключей, связанного с этой рабочей областью. Это невозможно изменить после создания рабочей области string
managedNetwork Параметры управляемой сети для рабочей области машинного обучения. ManagedNetworkSettings
primaryUserAssignedIdentity Идентификатор ресурса удостоверения, назначаемого пользователем, который представляет удостоверение рабочей области. string
provisionNetworkNow Установите для активации подготовки управляемой виртуальной сети с параметрами по умолчанию при создании рабочей области с включенной управляемой виртуальной сетью или в противном случае ничего не делает. bool
publicNetworkAccess Разрешены ли запросы из общедоступной сети. 'Disabled'
'Enabled'
serverlessComputeSettings Параметры бессерверных вычислений, созданных в рабочей области ServerlessComputeSettings
serviceManagedResourcesSettings Параметры управляемого ресурса службы. ServiceManagedResourcesSettings
sharedPrivateLinkResources Список общих ресурсов приватного канала в этой рабочей области. SharedPrivateLinkResource[]
storageAccount Идентификатор ARM учетной записи хранения, связанной с этой рабочей областью. Это невозможно изменить после создания рабочей области string
systemDatastoresAuthMode Режим проверки подлинности, используемый для доступа к системным хранилищам данных рабочей области. 'AccessKey'
'Identity'
'UserDelegationSAS'
v1LegacyMode Включение параметра v1_legacy_mode может препятствовать использованию функций, предоставляемых API версии 2. bool
workspaceHubConfig Объект конфигурации WorkspaceHub. WorkspaceHubConfig

WorkspaceTags

Name Description Value

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

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

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