Microsoft.MachineLearningServices 工作區 2023-08-01-preview

Bicep 資源定義

工作區資源類型可以使用目標作業來部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄

資源格式

若要建立 Microsoft.MachineLearningServices/workspaces 資源,請將下列 Bicep 新增至範本。

resource symbolicname 'Microsoft.MachineLearningServices/workspaces@2023-08-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
    {customized property}: 'string'
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  kind: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    allowPublicAccessWhenBehindVnet: bool
    applicationInsights: 'string'
    associatedWorkspaces: [
      'string'
    ]
    containerRegistries: [
      'string'
    ]
    containerRegistry: 'string'
    description: 'string'
    discoveryUrl: 'string'
    enableDataIsolation: 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'
    keyVault: 'string'
    keyVaults: [
      'string'
    ]
    managedNetwork: {
      isolationMode: 'string'
      outboundRules: {
        {customized property}: {
          category: 'string'
          status: 'string'
          type: 'string'
          // For remaining properties, see OutboundRule objects
        }
      }
      status: {
        sparkReady: bool
        status: 'string'
      }
    }
    primaryUserAssignedIdentity: 'string'
    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'
    }
  }
}

OutboundRule 物件

設定 type 屬性以指定物件的類型。

針對 FQDN,請使用:

  type: 'FQDN'
  destination: 'string'

針對 PrivateEndpoint,請使用:

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

針對 ServiceTag,請使用:

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

屬性值

workspaces

名稱 描述
NAME 資源名稱 字串 (必要)

字元限制:3-33

合法字元:
英數字元、連字號和底線。
location 字串
tags {string} 的字典 標記名稱和值的字典。 請參閱 範本中的標記
sku 選擇性。 RP 必須實作此欄位,因為 AML 支援一個以上的層 Sku
kind 字串
身分識別 受控服務識別 (系統指派和/或使用者指派的身分識別) ManagedServiceIdentity
properties 實體的其他屬性。 WorkspaceProperties (必要)

ManagedServiceIdentity

名稱 描述
類型 (允許 SystemAssigned 和 UserAssigned 類型的受控服務識別類型) 。 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (必要)
userAssignedIdentities 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中 () 的空白物件 {} 。 UserAssignedIdentities

UserAssignedIdentities

名稱 描述
{自定義屬性} UserAssignedIdentity

UserAssignedIdentity

此物件不包含部署期間要設定的任何屬性。 所有屬性都是 ReadOnly。

WorkspaceProperties

名稱 描述
allowPublicAccessWhenBehindVnet 旗標,指出是否要在 VNet 後方允許公用存取。 bool
applicationInsights 與此工作區相關聯的 Application Insights ARM 識別碼。 字串
associatedWorkspaces string[]
containerRegistries string[]
containerRegistry 與此工作區相關聯的容器登錄ARM標識碼。 字串
description 此工作區的描述。 字串
discoveryUrl 探索服務的 URL,以識別機器學習測試服務的區域端點 字串
enableDataIsolation bool
加密 EncryptionProperty
existingWorkspaces string[]
featureStoreSettings 功能存放區類型工作區的設定。 FeatureStoreSettings
friendlyName 此工作區的易記名稱。 這個名稱在可變中 字串
hbiWorkspace 指示工作區中 HBI 數據的旗標,並減少服務所收集的診斷數據 bool
hubResourceId 字串
imageBuildCompute 映射組建的計算名稱 字串
keyVault 與此工作區相關聯的密鑰保存庫 ARM 識別碼。 建立工作區之後,就無法變更此專案 字串
keyVaults string[]
managedNetwork 機器學習工作區的受控網路設定。 ManagedNetworkSettings
primaryUserAssignedIdentity 代表工作區身分識別的使用者指派身分識別資源標識符。 字串
publicNetworkAccess 是否允許來自公用網路的要求。 'Disabled'
'Enabled'
serverlessComputeSettings 在工作區中建立的無伺服器計算設定 ServerlessComputeSettings
serviceManagedResourcesSettings 服務受控資源設定。 ServiceManagedResourcesSettings
sharedPrivateLinkResources 此工作區中的共用私人鏈接資源清單。 SharedPrivateLinkResource[]
softDeleteRetentionInDays 工作區虛刪除后的保留時間。 int
storageAccount 與此工作區相關聯的記憶體帳戶 ARM 識別碼。 建立工作區之後,就無法變更此專案 字串
storageAccounts string[]
systemDatastoresAuthMode 用於存取工作區系統數據存放區的驗證模式。 字串
v1LegacyMode 啟用 v1_legacy_mode 可能會防止您使用 v2 API 所提供的功能。 bool
workspaceHubConfig WorkspaceHub 的組態物件。 WorkspaceHubConfig

EncryptionProperty

名稱 描述
cosmosDbResourceId 客戶帶入的 byok cosmosdb 帳戶來儲存客戶的數據
使用加密
字串
身分識別 要與keyVault搭配使用的身分識別 IdentityForCmk
keyVaultProperties 要執行加密的 KeyVault 詳細數據 需要 KeyVaultProperties ()
searchAccountResourceId 客戶帶入的 byok 搜尋帳戶來儲存客戶的數據
使用加密
字串
status 指出是否已啟用工作區的加密。 'Disabled'
必要 ('Enabled')
storageAccountResourceId 客戶帶入的 byok 記憶體帳戶,用來儲存客戶的數據
使用加密
字串

IdentityForCmk

名稱 描述
userAssignedIdentity 用來從 keyVault 擷取加密密鑰的 UserAssignedIdentity 字串

KeyVaultProperties

名稱 描述
identityClientId 目前,我們僅支援 SystemAssigned MSI。
當我們支援 UserAssignedIdentities 時,我們需要此專案
字串
keyIdentifier 用來加密數據的 KeyVault 金鑰標識碼 需要字串 ()

約束:
最小長度 = 1
模式 = [a-zA-Z0-9_]
keyVaultArmId KeyVault Arm 識別碼,其中包含數據加密密鑰 需要字串 ()

約束:
最小長度 = 1
模式 = [a-zA-Z0-9_]

FeatureStoreSettings

名稱 描述
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName 字串
onlineStoreConnectionName 字串

ComputeRuntimeDto

名稱 描述
sparkRuntimeVersion 字串

ManagedNetworkSettings

名稱 描述
isolationMode 機器學習工作區受控網路的隔離模式。 'AllowInternetOutbound'
'AllowOnlyApprovedOutbound'
'Disabled'
outboundRules {OutboundRule} 的字典 ManagedNetworkSettingsOutboundRules
status 機器學習工作區受控網路的布建狀態。 ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

名稱 描述
{自定義屬性} OutboundRule

OutboundRule

名稱 描述
category 機器學習工作區的受控網路輸出規則類別。 'Recommended'
'Required'
'UserDefined'
status 機器學習工作區的受控網路輸出規則類型。 'Active'
'Inactive'
類型 設定物件類型 FQDN
PrivateEndpoint
需要 ServiceTag ()

FqdnOutboundRule

名稱 描述
類型 機器學習工作區的受控網路輸出規則類型。 'FQDN' (必要)
目的地 字串

PrivateEndpointOutboundRule

名稱 描述
類型 機器學習工作區的受控網路輸出規則類型。 'PrivateEndpoint' (必要)
目的地 機器學習工作區受控網路私人端點輸出規則的私人端點目的地。 PrivateEndpointDestination

PrivateEndpointDestination

名稱 描述
serviceResourceId 字串
sparkEnabled bool
sparkStatus 機器學習工作區的受控網路輸出規則類型。 'Active'
'Inactive'
subresourceTarget 字串

ServiceTagOutboundRule

名稱 描述
類型 機器學習工作區的受控網路輸出規則類型。 'ServiceTag' (必要)
目的地 機器學習工作區受控網路之服務標籤輸出規則的服務標籤目的地。 ServiceTagDestination

ServiceTagDestination

名稱 描述
動作 網路規則的動作列舉。 'Allow'
'Deny'
portRanges 字串
protocol 字串
serviceTag 字串

ManagedNetworkProvisionStatus

名稱 描述
sparkReady bool
status 機器學習工作區的受控網路狀態。 'Active'
'Inactive'

ServerlessComputeSettings

名稱 描述
serverlessComputeCustomSubnet 應該在其中部署無伺服器計算節點的現有虛擬網路子網資源標識符 字串
serverlessComputeNoPublicIP 如果部署在自定義 vNet 中的無伺服器計算節點沒有公用 IP 位址,則表示具有私人端點之工作區的旗標 bool

ServiceManagedResourcesSettings

名稱 描述
cosmosDb CosmosDbSettings

CosmosDbSettings

名稱 描述
collectionsThroughput int

SharedPrivateLinkResource

名稱 描述
NAME 私人連結的唯一名稱 字串
properties 共用私人鏈接資源的屬性。 SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

名稱 描述
groupId 私人連結的群組標識碼 字串
privateLinkResourceId 私人連結連結所連結的資源標識碼 字串
requestMessage 要求訊息 字串
status 服務取用者與服務提供者的連線狀態 'Approved'
'Disconnected'
'Pending'
「已拒絕」
'Timeout'

WorkspaceHubConfig

名稱 描述
additionalWorkspaceStorageAccounts string[]
defaultWorkspaceResourceGroup 字串

SKU

名稱 描述
處理能力 如果 SKU 支援相應放大/縮小,則應該包含容量整數。 如果資源無法相應放大/縮小,可能會省略此專案。 int
family 如果服務有不同的硬體世代,則針對相同的 SKU,則可以在這裡擷取。 字串
NAME SKU 的名稱。 例如 - P3。 通常是字母+數位碼 需要字串 ()
{1}size{2} SKU 大小。 當名稱欄位是階層和其他一些值的組合時,這會是獨立程序代碼。 字串
tier 如果服務有一個以上的層級,但在PUT上則不需要此欄位,才能由資源提供者實作。 'Basic'
'Free'
'Premium'
'Standard'

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
Azure Machine Learning 工作區

部署至 Azure
此範本會建立新的 Azure Machine Learning 工作區,以及加密的記憶體帳戶、KeyVault 和 Applications Insights 記錄
& 數據存放區建立具有多個數據集的 AML 工作區

部署至 Azure
此範本會建立具有多個數據集的 Azure Machine Learning 工作區,& 數據存放區。
Azure Machine Learning 端對端安全設定

部署至 Azure
這組 Bicep 範本示範如何在安全設定中端對端設定 Azure Machine Learning。 此參考實作包括 Workspace、計算叢集、計算實例和附加的私人 AKS 叢集。
Azure Machine Learning 端對端安全設定 (舊版)

部署至 Azure
這組 Bicep 範本示範如何在安全設定中端對端設定 Azure Machine Learning。 此參考實作包括 Workspace、計算叢集、計算實例和附加的私人 AKS 叢集。
使用私人IP位址建立 AKS 計算目標

部署至 Azure
此範本會在具有私人IP位址的指定 Azure Machine Learning 服務工作區中建立 AKS 計算目標。
建立 Azure Machine Learning 服務工作區

部署至 Azure
此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源,包括 Azure 金鑰保存庫、Azure 記憶體、Azure 應用程式 Insights 和 Azure Container Registry。 此組態描述開始使用 Azure Machine Learning 所需的最少資源集。
(CMK) 建立 Azure Machine Learning 服務工作區

部署至 Azure
此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源,包括 Azure 金鑰保存庫、Azure 記憶體、Azure 應用程式 Insights 和 Azure Container Registry。 此範例示範如何設定 Azure Machine Learning 以使用客戶管理的加密密鑰進行加密。
(vnet) 建立 Azure Machine Learning 服務工作區

部署至 Azure
此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源,包括 Azure 金鑰保存庫、Azure 記憶體、Azure 應用程式 Insights 和 Azure Container Registry。 此組態描述在網路隔離設定中開始使用 Azure Machine Learning 所需的一組資源。
(舊版) 建立 Azure Machine Learning 服務工作區

部署至 Azure
此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源,包括 Azure 金鑰保存庫、Azure 記憶體、Azure 應用程式 Insights 和 Azure Container Registry。 此組態描述在網路隔離設定中開始使用 Azure Machine Learning 所需的一組資源。

ARM 範本資源定義

工作區資源類型可以使用目標作業進行部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.MachineLearningServices/workspaces 資源,請將下列 JSON 新增至範本。

{
  "type": "Microsoft.MachineLearningServices/workspaces",
  "apiVersion": "2023-08-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
    "{customized property}": "string"
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "kind": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "allowPublicAccessWhenBehindVnet": "bool",
    "applicationInsights": "string",
    "associatedWorkspaces": [ "string" ],
    "containerRegistries": [ "string" ],
    "containerRegistry": "string",
    "description": "string",
    "discoveryUrl": "string",
    "enableDataIsolation": "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",
    "keyVault": "string",
    "keyVaults": [ "string" ],
    "managedNetwork": {
      "isolationMode": "string",
      "outboundRules": {
        "{customized property}": {
          "category": "string",
          "status": "string",
          "type": "string"
          // For remaining properties, see OutboundRule objects
        }
      },
      "status": {
        "sparkReady": "bool",
        "status": "string"
      }
    },
    "primaryUserAssignedIdentity": "string",
    "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"
    }
  }
}

OutboundRule 物件

設定 type 屬性以指定物件的類型。

針對 FQDN,請使用:

  "type": "FQDN",
  "destination": "string"

針對 PrivateEndpoint,請使用:

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

針對 ServiceTag,請使用:

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

屬性值

workspaces

名稱 描述
類型 資源類型 'Microsoft.MachineLearningServices/workspaces'
apiVersion 資源 API 版本 '2023-08-01-preview'
NAME 資源名稱 需要字串 ()

字元限制:3-33

合法字元:
英數字元、連字號和底線。
location 字串
tags {string} 的字典 標記名稱和值的字典。 請參閱 範本中的標籤
sku 選擇性。 RP 必須實作此欄位,因為 AML 支援多個層級 Sku
kind 字串
身分識別 受控服務識別 (系統指派和/或使用者指派的身分識別) ManagedServiceIdentity
properties 實體的其他屬性。 需要 WorkspaceProperties ()

ManagedServiceIdentity

名稱 描述
類型 (允許 SystemAssigned 和 UserAssigned 類型的受控服務識別類型) 。 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (必要)
userAssignedIdentities 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中 ({}) 的空白物件。 UserAssignedIdentities

UserAssignedIdentities

名稱 描述
{自定義屬性} UserAssignedIdentity

UserAssignedIdentity

此物件不包含部署期間要設定的任何屬性。 所有屬性都是 ReadOnly。

WorkspaceProperties

名稱 描述
allowPublicAccessWhenBehindVnet 旗標,指出是否要在 VNet 後方允許公用存取。 bool
applicationInsights 與此工作區相關聯的 Application Insights ARM 識別碼。 字串
associatedWorkspaces string[]
containerRegistries string[]
containerRegistry 與此工作區相關聯的容器登錄ARM標識碼。 字串
description 此工作區的描述。 字串
discoveryUrl 探索服務的 URL,用來識別機器學習測試服務的區域端點 字串
enableDataIsolation bool
加密 EncryptionProperty
existingWorkspaces string[]
featureStoreSettings 功能存放區類型工作區的設定。 FeatureStoreSettings
friendlyName 此工作區的易記名稱。 此名稱可變動 字串
hbiWorkspace 向工作區中的 HBI 數據發出訊號的旗標,並減少服務所收集的診斷數據 bool
hubResourceId 字串
imageBuildCompute 映射組建的計算名稱 字串
keyVault 與此工作區相關聯的密鑰保存庫 ARM 識別碼。 建立工作區之後,就無法變更此專案 字串
keyVaults string[]
managedNetwork 機器學習工作區的受控網路設定。 ManagedNetworkSettings
primaryUserAssignedIdentity 代表工作區身分識別的使用者指派身分識別資源標識符。 字串
publicNetworkAccess 是否允許來自公用網路的要求。 'Disabled'
'Enabled'
serverlessComputeSettings 在工作區中建立的無伺服器計算設定 ServerlessComputeSettings
serviceManagedResourcesSettings 服務管理的資源設定。 ServiceManagedResourcesSettings
sharedPrivateLinkResources 此工作區中共用的私人鏈接資源清單。 SharedPrivateLinkResource[]
softDeleteRetentionInDays 工作區虛刪除后的保留時間。 int
storageAccount 與此工作區相關聯的記憶體帳戶 ARM 識別碼。 建立工作區之後,就無法變更此專案 字串
storageAccounts string[]
systemDatastoresAuthMode 用來存取工作區系統數據存放區的驗證模式。 字串
v1LegacyMode 啟用 v1_legacy_mode 可能會防止您使用 v2 API 所提供的功能。 bool
workspaceHubConfig WorkspaceHub 的組態物件。 WorkspaceHubConfig

EncryptionProperty

名稱 描述
cosmosDbResourceId 客戶帶入的 byok cosmosdb 帳戶,用來儲存客戶的數據
使用加密
字串
身分識別 要與keyVault搭配使用的身分識別 IdentityForCmk
keyVaultProperties 執行加密的 KeyVault 詳細數據 需要 KeyVaultProperties ()
searchAccountResourceId 客戶帶入的 byok 搜尋帳戶來儲存客戶的數據
使用加密
字串
status 指出是否已啟用工作區的加密。 'Disabled'
必要 ('Enabled')
storageAccountResourceId 客戶帶入的 byok 記憶體帳戶,用來儲存客戶的數據
使用加密
字串

IdentityForCmk

名稱 描述
userAssignedIdentity 用來從 keyVault 擷取加密密鑰的 UserAssignedIdentity 字串

KeyVaultProperties

名稱 描述
identityClientId 目前,我們僅支援 SystemAssigned MSI。
當我們支援 UserAssignedIdentities 時,我們需要此專案
字串
keyIdentifier 用來加密數據的 KeyVault 金鑰標識碼 需要字串 ()

約束:
最小長度 = 1
模式 = [a-zA-Z0-9_]
keyVaultArmId KeyVault Arm 識別碼,其中包含數據加密密鑰 需要字串 ()

約束:
最小長度 = 1
模式 = [a-zA-Z0-9_]

FeatureStoreSettings

名稱 描述
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName 字串
onlineStoreConnectionName 字串

ComputeRuntimeDto

名稱 描述
sparkRuntimeVersion 字串

ManagedNetworkSettings

名稱 描述
isolationMode 機器學習工作區受控網路的隔離模式。 'AllowInternetOutbound'
'AllowOnlyApprovedOutbound'
'Disabled'
outboundRules {OutboundRule} 的字典 ManagedNetworkSettingsOutboundRules
status 機器學習工作區受控網路的布建狀態。 ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

名稱 描述
{自定義屬性} OutboundRule

OutboundRule

名稱 描述
category 機器學習工作區的受控網路輸出規則類別。 'Recommended'
'Required'
'UserDefined'
status 機器學習工作區的受控網路輸出規則類型。 'Active'
'Inactive'
類型 設定物件類型 FQDN
PrivateEndpoint
需要 ServiceTag ()

FqdnOutboundRule

名稱 描述
類型 機器學習工作區的受控網路輸出規則類型。 'FQDN' (必要)
目的地 字串

PrivateEndpointOutboundRule

名稱 描述
類型 機器學習工作區的受控網路輸出規則類型。 需要 『PrivateEndpoint』 ()
目的地 機器學習工作區受控網路私人端點輸出規則的私人端點目的地。 PrivateEndpointDestination

PrivateEndpointDestination

名稱 描述
serviceResourceId 字串
sparkEnabled bool
sparkStatus 機器學習工作區的受控網路輸出規則類型。 'Active'
'Inactive'
subresourceTarget 字串

ServiceTagOutboundRule

名稱 描述
類型 機器學習工作區的受控網路輸出規則類型。 需要 『ServiceTag』 ()
目的地 機器學習工作區受控網路之服務標籤輸出規則的服務標籤目的地。 ServiceTagDestination

ServiceTagDestination

名稱 描述
動作 網路規則的動作列舉。 'Allow'
'Deny'
portRanges 字串
protocol 字串
serviceTag 字串

ManagedNetworkProvisionStatus

名稱 描述
sparkReady bool
status 機器學習工作區的受控網路狀態。 'Active'
'Inactive'

ServerlessComputeSettings

名稱 描述
serverlessComputeCustomSubnet 應在其中部署無伺服器計算節點的現有虛擬網路子網資源標識碼 字串
serverlessComputeNoPublicIP 如果部署在自定義 vNet 中的無伺服器計算節點沒有具有私人端點之工作區的公用 IP 位址,則會發出訊號的旗標 bool

ServiceManagedResourcesSettings

名稱 描述
cosmosDb CosmosDbSettings

CosmosDbSettings

名稱 描述
collectionsThroughput int

SharedPrivateLinkResource

名稱 描述
NAME 私人連結的唯一名稱 字串
properties 共用私人鏈接資源的屬性。 SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

名稱 描述
groupId 私人連結的群組標識碼 字串
privateLinkResourceId 私人連結連結所連結的資源標識碼 字串
requestMessage 要求訊息 字串
status 服務取用者與服務提供者的連線狀態 'Approved'
'Disconnected'
'Pending'
「已拒絕」
'Timeout'

WorkspaceHubConfig

名稱 描述
additionalWorkspaceStorageAccounts string[]
defaultWorkspaceResourceGroup 字串

SKU

名稱 描述
處理能力 如果 SKU 支援相應放大/縮小,則應該包含容量整數。 如果資源無法相應放大/縮小,可能會省略此專案。 int
family 如果服務有不同的硬體世代,則針對相同的 SKU,則可以在這裡擷取。 字串
NAME SKU 的名稱。 例如 - P3。 通常是字母+數位碼 需要字串 ()
{1}size{2} SKU 大小。 當名稱欄位是階層和其他一些值的組合時,這會是獨立程序代碼。 字串
tier 如果服務有一個以上的層級,但在PUT上則不需要此欄位,才能由資源提供者實作。 'Basic'
'Free'
'Premium'
'Standard'

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
Azure Machine Learning 工作區

部署至 Azure
此範本會建立新的 Azure Machine Learning 工作區,以及加密的記憶體帳戶、KeyVault 和 Applications Insights 記錄
& 數據存放區建立具有多個數據集的 AML 工作區

部署至 Azure
此範本會建立具有多個數據集 & 數據存放區的 Azure Machine Learning 工作區。
Azure Machine Learning 端對端安全設定

部署至 Azure
這組 Bicep 範本示範如何在安全設定中設定 Azure Machine Learning 端對端。 此參考實作包括工作區、計算叢集、計算實例和連結的私人 AKS 叢集。
Azure Machine Learning 端對端安全設定 (舊版)

部署至 Azure
這組 Bicep 範本示範如何在安全設定中設定 Azure Machine Learning 端對端。 此參考實作包括工作區、計算叢集、計算實例和連結的私人 AKS 叢集。
使用私人IP位址建立 AKS 計算目標

部署至 Azure
此範本會在具有私人IP位址的指定 Azure Machine Learning 服務工作區中建立 AKS 計算目標。
建立 Azure Machine Learning 服務工作區

部署至 Azure
此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源,包括 Azure 金鑰保存庫、Azure 記憶體、Azure 應用程式 Insights 和 Azure Container Registry。 此組態描述開始使用 Azure Machine Learning 所需的最少資源集。
(CMK) 建立 Azure Machine Learning 服務工作區

部署至 Azure
此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源,包括 Azure 金鑰保存庫、Azure 記憶體、Azure 應用程式 Insights 和 Azure Container Registry。 此範例示範如何設定 Azure Machine Learning 以使用客戶管理的加密密鑰進行加密。
(vnet) 建立 Azure Machine Learning 服務工作區

部署至 Azure
此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源,包括 Azure 金鑰保存庫、Azure 記憶體、Azure 應用程式 Insights 和 Azure Container Registry。 此組態描述您在網路隔離設定中開始使用 Azure Machine Learning 所需的資源集。
(舊版) 建立 Azure Machine Learning 服務工作區

部署至 Azure
此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源,包括 Azure 金鑰保存庫、Azure 記憶體、Azure 應用程式 Insights 和 Azure Container Registry。 此組態描述您在網路隔離設定中開始使用 Azure Machine Learning 所需的資源集。

Terraform (AzAPI 提供者) 資源定義

工作區資源類型可以使用目標作業來部署:

  • 資源群組

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄

資源格式

若要建立 Microsoft.MachineLearningServices/workspaces 資源,請將下列 Terraform 新增至您的範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces@2023-08-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
    {customized property} = "string"
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      allowPublicAccessWhenBehindVnet = bool
      applicationInsights = "string"
      associatedWorkspaces = [
        "string"
      ]
      containerRegistries = [
        "string"
      ]
      containerRegistry = "string"
      description = "string"
      discoveryUrl = "string"
      enableDataIsolation = 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"
      keyVault = "string"
      keyVaults = [
        "string"
      ]
      managedNetwork = {
        isolationMode = "string"
        outboundRules = {
          {customized property} = {
            category = "string"
            status = "string"
            type = "string"
            // For remaining properties, see OutboundRule objects
          }
        }
        status = {
          sparkReady = bool
          status = "string"
        }
      }
      primaryUserAssignedIdentity = "string"
      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"
    }
    kind = "string"
  })
}

OutboundRule 物件

設定 type 屬性以指定物件的類型。

針對 FQDN,請使用:

  type = "FQDN"
  destination = "string"

針對 PrivateEndpoint,請使用:

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

針對 ServiceTag,請使用:

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

屬性值

workspaces

名稱 描述
類型 資源類型 “Microsoft.MachineLearningServices/workspaces@2023-08-01-preview”
NAME 資源名稱 字串 (必要)

字元限制:3-33

合法字元:
英數字元、連字號和底線。
location 字串
parent_id 若要部署至資源群組,請使用該資源群組的標識碼。 字串 (必要)
tags {string} 的字典 標記名稱和值的字典。
sku 選擇性。 RP 必須實作此欄位,因為 AML 支援一個以上的層 Sku
kind 字串
身分識別 受控服務識別 (系統指派和/或使用者指派的身分識別) ManagedServiceIdentity
properties 實體的其他屬性。 WorkspaceProperties (必要)

ManagedServiceIdentity

名稱 描述
類型 (允許 SystemAssigned 和 UserAssigned 類型的受控服務識別類型) 。 “SystemAssigned”
“SystemAssigned,UserAssigned”
) 所需的 「UserAssigned」 (
identity_ids 與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是要求中 () 的空白物件 {} 。 使用者身分識別標識碼的陣列。

UserAssignedIdentities

名稱 描述
{自定義屬性} UserAssignedIdentity

UserAssignedIdentity

此物件不包含部署期間要設定的任何屬性。 所有屬性都是 ReadOnly。

WorkspaceProperties

名稱 描述
allowPublicAccessWhenBehindVnet 旗標,指出是否要在 VNet 後方允許公用存取。 bool
applicationInsights 與此工作區相關聯的 Application Insights ARM 識別碼。 字串
associatedWorkspaces string[]
containerRegistries string[]
containerRegistry 與此工作區相關聯的容器登錄ARM標識碼。 字串
description 此工作區的描述。 字串
discoveryUrl 探索服務的 URL,用來識別機器學習測試服務的區域端點 字串
enableDataIsolation bool
加密 EncryptionProperty
existingWorkspaces string[]
featureStoreSettings 功能存放區類型工作區的設定。 FeatureStoreSettings
friendlyName 此工作區的易記名稱。 此名稱可變動 字串
hbiWorkspace 向工作區中的 HBI 數據發出訊號的旗標,並減少服務所收集的診斷數據 bool
hubResourceId 字串
imageBuildCompute 映射組建的計算名稱 字串
keyVault 與此工作區相關聯的密鑰保存庫 ARM 識別碼。 建立工作區之後,就無法變更此專案 字串
keyVaults string[]
managedNetwork 機器學習工作區的受控網路設定。 ManagedNetworkSettings
primaryUserAssignedIdentity 代表工作區身分識別的使用者指派身分識別資源標識符。 字串
publicNetworkAccess 是否允許來自公用網路的要求。 “Disabled”
“Enabled”
serverlessComputeSettings 在工作區中建立的無伺服器計算設定 ServerlessComputeSettings
serviceManagedResourcesSettings 服務管理的資源設定。 ServiceManagedResourcesSettings
sharedPrivateLinkResources 此工作區中共用的私人鏈接資源清單。 SharedPrivateLinkResource[]
softDeleteRetentionInDays 工作區虛刪除后的保留時間。 int
storageAccount 與此工作區相關聯的記憶體帳戶 ARM 識別碼。 建立工作區之後,就無法變更此專案 字串
storageAccounts string[]
systemDatastoresAuthMode 用來存取工作區系統數據存放區的驗證模式。 字串
v1LegacyMode 啟用 v1_legacy_mode 可能會防止您使用 v2 API 所提供的功能。 bool
workspaceHubConfig WorkspaceHub 的組態物件。 WorkspaceHubConfig

EncryptionProperty

名稱 描述
cosmosDbResourceId 客戶帶入的 byok cosmosdb 帳戶,用來儲存客戶的數據
使用加密
字串
身分識別 要與keyVault搭配使用的身分識別 IdentityForCmk
keyVaultProperties 執行加密的 KeyVault 詳細數據 需要 KeyVaultProperties ()
searchAccountResourceId 客戶帶入的 byok 搜尋帳戶來儲存客戶的數據
使用加密
字串
status 指出是否已啟用工作區的加密。 “Disabled”
「已啟用」 (必要)
storageAccountResourceId 客戶帶入的 byok 記憶體帳戶,用來儲存客戶的數據
使用加密
字串

IdentityForCmk

名稱 描述
userAssignedIdentity 用來從 keyVault 擷取加密密鑰的 UserAssignedIdentity 字串

KeyVaultProperties

名稱 描述
identityClientId 目前,我們僅支援 SystemAssigned MSI。
當我們支援 UserAssignedIdentities 時,我們需要此專案
字串
keyIdentifier 用來加密數據的 KeyVault 金鑰標識碼 需要字串 ()

約束:
最小長度 = 1
模式 = [a-zA-Z0-9_]
keyVaultArmId KeyVault Arm 識別碼,其中包含數據加密密鑰 需要字串 ()

約束:
最小長度 = 1
模式 = [a-zA-Z0-9_]

FeatureStoreSettings

名稱 描述
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName 字串
onlineStoreConnectionName 字串

ComputeRuntimeDto

名稱 描述
sparkRuntimeVersion 字串

ManagedNetworkSettings

名稱 描述
isolationMode 機器學習工作區受控網路的隔離模式。 “AllowInternetOutbound”
“AllowOnlyApprovedOutbound”
“Disabled”
outboundRules {OutboundRule} 的字典 ManagedNetworkSettingsOutboundRules
status 機器學習工作區受控網路的布建狀態。 ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

名稱 描述
{自定義屬性} OutboundRule

OutboundRule

名稱 描述
category 機器學習工作區的受控網路輸出規則類別。 “建議”
“必要”
“UserDefined”
status 機器學習工作區的受控網路輸出規則類型。 作用中”
“非使用中”
類型 設定物件類型 FQDN
PrivateEndpoint
ServiceTag (必要)

FqdnOutboundRule

名稱 描述
類型 機器學習工作區的受控網路輸出規則類型。 必要) “FQDN” (
目的地 字串

PrivateEndpointOutboundRule

名稱 描述
類型 機器學習工作區的受控網路輸出規則類型。 “PrivateEndpoint” (必要)
目的地 機器學習工作區受控網路私人端點輸出規則的私人端點目的地。 PrivateEndpointDestination

PrivateEndpointDestination

名稱 描述
serviceResourceId 字串
sparkEnabled bool
sparkStatus 機器學習工作區的受控網路輸出規則類型。 “Active”
“Inactive”
subresourceTarget 字串

ServiceTagOutboundRule

名稱 描述
類型 機器學習工作區的受控網路輸出規則類型。 “ServiceTag” (必要)
目的地 機器學習工作區受控網路之服務標籤輸出規則的服務標籤目的地。 ServiceTagDestination

ServiceTagDestination

名稱 描述
動作 網路規則的動作列舉。 “Allow”
“Deny”
portRanges 字串
protocol 字串
serviceTag 字串

ManagedNetworkProvisionStatus

名稱 描述
sparkReady bool
status 機器學習工作區的受控網路狀態。 “Active”
“Inactive”

ServerlessComputeSettings

名稱 描述
serverlessComputeCustomSubnet 應該在其中部署無伺服器計算節點的現有虛擬網路子網資源標識符 字串
serverlessComputeNoPublicIP 如果部署在自定義 vNet 中的無伺服器計算節點沒有公用 IP 位址,則表示具有私人端點之工作區的旗標 bool

ServiceManagedResourcesSettings

名稱 描述
cosmosDb CosmosDbSettings

CosmosDbSettings

名稱 描述
collectionsThroughput int

SharedPrivateLinkResource

名稱 描述
NAME 私人連結的唯一名稱 字串
properties 共用私人鏈接資源的屬性。 SharedPrivateLinkResourceProperty

SharedPrivateLinkResourceProperty

名稱 描述
groupId 私人連結的群組標識碼 字串
privateLinkResourceId 私人連結連結所連結的資源標識碼 字串
requestMessage 要求訊息 字串
status 服務取用者與服務提供者的連線狀態 「已核准」
“Disconnected”
“Pending”
「已拒絕」
“Timeout”

WorkspaceHubConfig

名稱 描述
additionalWorkspaceStorageAccounts string[]
defaultWorkspaceResourceGroup 字串

SKU

名稱 描述
處理能力 如果 SKU 支援相應放大/縮小,則應該包含容量整數。 如果資源無法相應放大/縮小,可能會省略此專案。 int
family 如果服務有不同的硬體世代,則針對相同的 SKU,則可以在這裡擷取。 字串
NAME SKU 的名稱。 例如 - P3。 通常是字母+數位碼 需要字串 ()
{1}size{2} SKU 大小。 當名稱欄位是階層和其他一些值的組合時,這會是獨立程序代碼。 字串
tier 如果服務有一個以上的層級,但在PUT上則不需要此欄位,才能由資源提供者實作。 "Basic"
“Free”
“Premium”
“標準”