共用方式為

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

  • 發行項

Bicep 資源定義

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

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

資源格式

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

resource symbolicname 'Microsoft.MachineLearningServices/workspaces@2023-08-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  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'
  }
  tags: {
    {customized property}: 'string'
  }
}

OutboundRule 物件

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

針對 FQDN，請使用：

{
  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'
}

屬性值

ComputeRuntimeDto

名字 描述 價值
sparkRuntimeVersion 字串

CosmosDbSettings

名字 描述 價值
collectionsThroughput int

EncryptionProperty

名字 描述 價值
cosmosDbResourceId 客戶帶來的 byok cosmosdb 帳戶，用來儲存客戶的數據
使用加密		 字串
身份 要與keyVault搭配使用的身分識別 IdentityForCmk
keyVaultProperties 要進行加密的 KeyVault 詳細數據 KeyVaultProperties （必要）
searchAccountResourceId 客戶帶來的 byok 搜尋帳戶來儲存客戶的數據
使用加密		 字串
地位 指出是否為工作區啟用加密。 'Disabled'
'Enabled' （必要）
storageAccountResourceId 客戶帶來的 byok 記憶體帳戶，用來儲存客戶的數據
使用加密		 字串

FeatureStoreSettings

名字 描述 價值
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName 字串
onlineStoreConnectionName 字串

FqdnOutboundRule

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

IdentityForCmk

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

KeyVaultProperties

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

約束：
最小長度 = 1
模式 = [a-zA-Z0-9_] （必要）
keyVaultArmId 包含數據加密金鑰的 KeyVault Arm 識別碼 字串

約束：
最小長度 = 1
模式 = [a-zA-Z0-9_] （必要）

ManagedNetworkProvisionStatus

名字 描述 價值
sparkReady bool
地位 機器學習工作區受控網路的狀態。 'Active'
'Inactive'

ManagedNetworkSettings

名字 描述 價值
isolationMode 機器學習工作區受控網路的隔離模式。 'AllowInternetOutbound'
'AllowOnlyApprovedOutbound'
'Disabled'
outboundRules OutboundRule 的 <字典> ManagedNetworkSettingsOutboundRules
地位 機器學習工作區受控網路的布建狀態。 ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

名字 描述 價值

ManagedServiceIdentity

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

Microsoft.MachineLearningServices/workspaces

名字 描述 價值
身份 受控服務識別（系統指派和/或使用者指派的身分識別） ManagedServiceIdentity
類 字串
位置 字串
名字 資源名稱 字串

約束：
模式 = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ （必要）
性能 實體的其他屬性。 WorkspaceProperties （必要）
sku 自選。 此欄位必須由 RP 實作，因為 AML 支援一個以上的層級 Sku
標籤 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤

OutboundRule

名字 描述 價值
類別 機器學習工作區的受控網路輸出規則類別。 'Recommended'
'Required'
'UserDefined'
地位 機器學習工作區的受控網路輸出規則類型。 'Active'
'Inactive'
類型 將 類型設定為 'FQDN'，FqdnOutboundRule。 針對 type PrivateEndpointOutboundRule，設定為 'PrivateEndpoint'。 針對 serviceTagOutboundRule 類型 設定為 'ServiceTag'，。 'FQDN'
'PrivateEndpoint'
'ServiceTag' （必要）

PrivateEndpointDestination

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

PrivateEndpointOutboundRule

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

ServerlessComputeSettings

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

ServiceManagedResourcesSettings

名字 描述 價值
cosmosDb CosmosDbSettings

ServiceTagDestination

名字 描述 價值
行動 網路規則的動作列舉。 'Allow'
'Deny'
portRanges 字串
協定 字串
serviceTag 字串

ServiceTagOutboundRule

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

SharedPrivateLinkResource

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

SharedPrivateLinkResourceProperty

名字 描述 價值
groupId 私人連結的群組標識碼 字串
privateLinkResourceId 私人連結所連結的資源標識碼 字串
requestMessage 要求訊息 字串
地位 服務取用者與服務提供者的連接狀態 「已核准」
'Disconnected'
'Pending'
'Rejected'
'Timeout'

Sku

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

UserAssignedIdentities

名字 描述 價值

UserAssignedIdentity

名字 描述 價值

WorkspaceHubConfig

名字 描述 價值
additionalWorkspaceStorageAccounts string[]
defaultWorkspaceResourceGroup 字串

WorkspaceProperties

名字 描述 價值
allowPublicAccessWhenBehindVnet 旗標，指出是否要在 VNet 後方允許公用存取。 bool
applicationInsights 與此工作區相關聯的 Application Insights ARM 識別碼。 字串
associatedWorkspaces string[]
containerRegistries string[]
containerRegistry 與此工作區相關聯的容器登錄ARM標識碼。 字串
描述 此工作區的描述。 字串
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

WorkspaceTags

名字 描述 價值

快速入門範例

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

Bicep 檔案 描述
Azure AI Studio 基本設定 這組範本示範如何使用基本設定來設定 Azure AI Studio，這表示已啟用公用因特網存取、Microsoft受控密鑰進行加密，以及 AI 資源的Microsoft受控識別設定。
Azure AI Studio 基本設定 這組範本示範如何使用基本設定來設定 Azure AI Studio，這表示已啟用公用因特網存取、Microsoft受控密鑰進行加密，以及 AI 資源的Microsoft受控識別設定。
Azure AI Studio 基本設定 這組範本示範如何使用基本設定來設定 Azure AI Studio，這表示已啟用公用因特網存取、Microsoft受控密鑰進行加密，以及 AI 資源的Microsoft受控識別設定。
Azure AI Studio 網路限制 這組範本示範如何使用Microsoft受控密鑰來加密和 AI 資源的 Microsoft 受控識別組態，來設定已停用私人鏈接和輸出的 Azure AI Studio。
Azure AI Studio 網路限制 這組範本示範如何使用Microsoft受控密鑰來加密和 AI 資源的 Microsoft 受控識別組態，來設定已停用私人鏈接和輸出的 Azure AI Studio。
使用 Microsoft Entra ID Authentication Azure AI Studio 這組範本示範如何使用相依資源的 Microsoft Entra ID 驗證來設定 Azure AI Studio，例如 Azure AI 服務和 Azure 記憶體。
Azure Machine Learning 端對端安全設定 這組 Bicep 範本示範如何在安全設定中設定 Azure Machine Learning 端對端。 此參考實作包括工作區、計算叢集、計算實例和附加的私人 AKS 叢集。
Azure Machine Learning 端對端安全設定 （舊版） 這組 Bicep 範本示範如何在安全設定中設定 Azure Machine Learning 端對端。 此參考實作包括工作區、計算叢集、計算實例和附加的私人 AKS 叢集。
建立具有私人IP位址的 AKS 計算目標 此範本會在具有私人IP位址的指定 Azure Machine Learning 服務工作區中建立 AKS 計算目標。
建立 Azure Machine Learning 服務工作區 此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源，包括 Azure Key Vault、Azure 儲存體、Azure Application Insights 和 Azure Container Registry。 此組態描述開始使用 Azure Machine Learning 所需的最少資源集。
建立 Azure Machine Learning 服務工作區 （CMK） 此部署範本會指定如何使用加密密鑰，建立具有服務端加密的 Azure Machine Learning 工作區。
建立 Azure Machine Learning 服務工作區 （CMK） 此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源，包括 Azure Key Vault、Azure 儲存體、Azure Application Insights 和 Azure Container Registry。 此範例示範如何使用客戶管理的加密密鑰來設定 Azure Machine Learning 進行加密。
建立 Azure Machine Learning 服務工作區 （舊版） 此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源，包括 Azure Key Vault、Azure 儲存體、Azure Application Insights 和 Azure Container Registry。 此組態說明在網路隔離設定中開始使用 Azure Machine Learning 所需的資源集。
建立 Azure Machine Learning 服務工作區 （vnet） 此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源，包括 Azure Key Vault、Azure 儲存體、Azure Application Insights 和 Azure Container Registry。 此組態說明在網路隔離設定中開始使用 Azure Machine Learning 所需的資源集。
使用受控虛擬網路部署安全的 Azure AI Studio 此範本會建立安全的 Azure AI Studio 環境，並具有健全的網路和身分識別安全性限制。

ARM 樣本資源定義

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

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

資源格式

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

{
  "type": "Microsoft.MachineLearningServices/workspaces",
  "apiVersion": "2023-08-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "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"
  },
  "tags": {
    "{customized property}": "string"
  }
}

OutboundRule 物件

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

針對 FQDN，請使用：

{
  "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"
}

屬性值

ComputeRuntimeDto

名字 描述 價值
sparkRuntimeVersion 字串

CosmosDbSettings

名字 描述 價值
collectionsThroughput int

EncryptionProperty

名字 描述 價值
cosmosDbResourceId 客戶帶來的 byok cosmosdb 帳戶，用來儲存客戶的數據
使用加密		 字串
身份 要與keyVault搭配使用的身分識別 IdentityForCmk
keyVaultProperties 要進行加密的 KeyVault 詳細數據 KeyVaultProperties （必要）
searchAccountResourceId 客戶帶來的 byok 搜尋帳戶來儲存客戶的數據
使用加密		 字串
地位 指出是否為工作區啟用加密。 'Disabled'
'Enabled' （必要）
storageAccountResourceId 客戶帶來的 byok 記憶體帳戶，用來儲存客戶的數據
使用加密		 字串

FeatureStoreSettings

名字 描述 價值
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName 字串
onlineStoreConnectionName 字串

FqdnOutboundRule

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

IdentityForCmk

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

KeyVaultProperties

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

約束：
最小長度 = 1
模式 = [a-zA-Z0-9_] （必要）
keyVaultArmId 包含數據加密金鑰的 KeyVault Arm 識別碼 字串

約束：
最小長度 = 1
模式 = [a-zA-Z0-9_] （必要）

ManagedNetworkProvisionStatus

名字 描述 價值
sparkReady bool
地位 機器學習工作區受控網路的狀態。 'Active'
'Inactive'

ManagedNetworkSettings

名字 描述 價值
isolationMode 機器學習工作區受控網路的隔離模式。 'AllowInternetOutbound'
'AllowOnlyApprovedOutbound'
'Disabled'
outboundRules OutboundRule 的 <字典> ManagedNetworkSettingsOutboundRules
地位 機器學習工作區受控網路的布建狀態。 ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

名字 描述 價值

ManagedServiceIdentity

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

Microsoft.MachineLearningServices/workspaces

名字 描述 價值
apiVersion API 版本 '2023-08-01-preview'
身份 受控服務識別（系統指派和/或使用者指派的身分識別） ManagedServiceIdentity
類 字串
位置 字串
名字 資源名稱 字串

約束：
模式 = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ （必要）
性能 實體的其他屬性。 WorkspaceProperties （必要）
sku 自選。 此欄位必須由 RP 實作，因為 AML 支援一個以上的層級 Sku
標籤 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤
類型 資源類型 'Microsoft.MachineLearningServices/workspaces'

OutboundRule

名字 描述 價值
類別 機器學習工作區的受控網路輸出規則類別。 'Recommended'
'Required'
'UserDefined'
地位 機器學習工作區的受控網路輸出規則類型。 'Active'
'Inactive'
類型 將 類型設定為 'FQDN'，FqdnOutboundRule。 針對 type PrivateEndpointOutboundRule，設定為 'PrivateEndpoint'。 針對 serviceTagOutboundRule 類型 設定為 'ServiceTag'，。 'FQDN'
'PrivateEndpoint'
'ServiceTag' （必要）

PrivateEndpointDestination

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

PrivateEndpointOutboundRule

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

ServerlessComputeSettings

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

ServiceManagedResourcesSettings

名字 描述 價值
cosmosDb CosmosDbSettings

ServiceTagDestination

名字 描述 價值
行動 網路規則的動作列舉。 'Allow'
'Deny'
portRanges 字串
協定 字串
serviceTag 字串

ServiceTagOutboundRule

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

SharedPrivateLinkResource

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

SharedPrivateLinkResourceProperty

名字 描述 價值
groupId 私人連結的群組標識碼 字串
privateLinkResourceId 私人連結所連結的資源標識碼 字串
requestMessage 要求訊息 字串
地位 服務取用者與服務提供者的連接狀態 「已核准」
'Disconnected'
'Pending'
'Rejected'
'Timeout'

Sku

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

UserAssignedIdentities

名字 描述 價值

UserAssignedIdentity

名字 描述 價值

WorkspaceHubConfig

名字 描述 價值
additionalWorkspaceStorageAccounts string[]
defaultWorkspaceResourceGroup 字串

WorkspaceProperties

名字 描述 價值
allowPublicAccessWhenBehindVnet 旗標，指出是否要在 VNet 後方允許公用存取。 bool
applicationInsights 與此工作區相關聯的 Application Insights ARM 識別碼。 字串
associatedWorkspaces string[]
containerRegistries string[]
containerRegistry 與此工作區相關聯的容器登錄ARM標識碼。 字串
描述 此工作區的描述。 字串
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

WorkspaceTags

名字 描述 價值

快速入門範本

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

範本 描述
Azure AI Studio 基本設定

部署至 Azure 		這組範本示範如何使用基本設定來設定 Azure AI Studio，這表示已啟用公用因特網存取、Microsoft受控密鑰進行加密，以及 AI 資源的Microsoft受控識別設定。
Azure AI Studio 基本設定

部署至 Azure 		這組範本示範如何使用基本設定來設定 Azure AI Studio，這表示已啟用公用因特網存取、Microsoft受控密鑰進行加密，以及 AI 資源的Microsoft受控識別設定。
Azure AI Studio 基本設定

部署至 Azure 		這組範本示範如何使用基本設定來設定 Azure AI Studio，這表示已啟用公用因特網存取、Microsoft受控密鑰進行加密，以及 AI 資源的Microsoft受控識別設定。
Azure AI Studio 網路限制

部署至 Azure 		這組範本示範如何使用Microsoft受控密鑰來加密和 AI 資源的 Microsoft 受控識別組態，來設定已停用私人鏈接和輸出的 Azure AI Studio。
Azure AI Studio 網路限制

部署至 Azure 		這組範本示範如何使用Microsoft受控密鑰來加密和 AI 資源的 Microsoft 受控識別組態，來設定已停用私人鏈接和輸出的 Azure AI Studio。
使用 Microsoft Entra ID Authentication Azure AI Studio

部署至 Azure 		這組範本示範如何使用相依資源的 Microsoft Entra ID 驗證來設定 Azure AI Studio，例如 Azure AI 服務和 Azure 記憶體。
Azure Machine Learning 端對端安全設定

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

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

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

部署至 Azure 		此範本會建立具有多個數據集的 Azure Machine Learning 工作區，& 數據存放區。
建立具有私人IP位址的 AKS 計算目標

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

部署至 Azure 		此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源，包括 Azure Key Vault、Azure 儲存體、Azure Application Insights 和 Azure Container Registry。 此組態描述開始使用 Azure Machine Learning 所需的最少資源集。
建立 Azure Machine Learning 服務工作區 （CMK）

部署至 Azure 		此部署範本會指定如何使用加密密鑰，建立具有服務端加密的 Azure Machine Learning 工作區。
建立 Azure Machine Learning 服務工作區 （CMK）

部署至 Azure 		此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源，包括 Azure Key Vault、Azure 儲存體、Azure Application Insights 和 Azure Container Registry。 此範例示範如何使用客戶管理的加密密鑰來設定 Azure Machine Learning 進行加密。
建立 Azure Machine Learning 服務工作區 （舊版）

部署至 Azure 		此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源，包括 Azure Key Vault、Azure 儲存體、Azure Application Insights 和 Azure Container Registry。 此組態說明在網路隔離設定中開始使用 Azure Machine Learning 所需的資源集。
建立 Azure Machine Learning 服務工作區 （vnet）

部署至 Azure 		此部署範本會指定 Azure Machine Learning 工作區及其相關聯的資源，包括 Azure Key Vault、Azure 儲存體、Azure Application Insights 和 Azure Container Registry。 此組態說明在網路隔離設定中開始使用 Azure Machine Learning 所需的資源集。
使用受控虛擬網路部署安全的 Azure AI Studio

部署至 Azure 		此範本會建立安全的 Azure AI Studio 環境，並具有健全的網路和身分識別安全性限制。

Terraform （AzAPI 提供者） 資源定義

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

  • 資源群組

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

資源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces@2023-08-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  kind = "string"
  location = "string"
  sku = {
    capacity = int
    family = "string"
    name = "string"
    size = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  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"
      }
    }
  })
}

OutboundRule 物件

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

針對 FQDN，請使用：

{
  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"
}

屬性值

ComputeRuntimeDto

名字 描述 價值
sparkRuntimeVersion 字串

CosmosDbSettings

名字 描述 價值
collectionsThroughput int

EncryptionProperty

名字 描述 價值
cosmosDbResourceId 客戶帶來的 byok cosmosdb 帳戶，用來儲存客戶的數據
使用加密		 字串
身份 要與keyVault搭配使用的身分識別 IdentityForCmk
keyVaultProperties 要進行加密的 KeyVault 詳細數據 KeyVaultProperties （必要）
searchAccountResourceId 客戶帶來的 byok 搜尋帳戶來儲存客戶的數據
使用加密		 字串
地位 指出是否為工作區啟用加密。 'Disabled'
'Enabled' （必要）
storageAccountResourceId 客戶帶來的 byok 記憶體帳戶，用來儲存客戶的數據
使用加密		 字串

FeatureStoreSettings

名字 描述 價值
computeRuntime ComputeRuntimeDto
offlineStoreConnectionName 字串
onlineStoreConnectionName 字串

FqdnOutboundRule

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

IdentityForCmk

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

KeyVaultProperties

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

約束：
最小長度 = 1
模式 = [a-zA-Z0-9_] （必要）
keyVaultArmId 包含數據加密金鑰的 KeyVault Arm 識別碼 字串

約束：
最小長度 = 1
模式 = [a-zA-Z0-9_] （必要）

ManagedNetworkProvisionStatus

名字 描述 價值
sparkReady bool
地位 機器學習工作區受控網路的狀態。 'Active'
'Inactive'

ManagedNetworkSettings

名字 描述 價值
isolationMode 機器學習工作區受控網路的隔離模式。 'AllowInternetOutbound'
'AllowOnlyApprovedOutbound'
'Disabled'
outboundRules OutboundRule 的 <字典> ManagedNetworkSettingsOutboundRules
地位 機器學習工作區受控網路的布建狀態。 ManagedNetworkProvisionStatus

ManagedNetworkSettingsOutboundRules

名字 描述 價值

ManagedServiceIdentity

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

Microsoft.MachineLearningServices/workspaces

名字 描述 價值
身份 受控服務識別（系統指派和/或使用者指派的身分識別） ManagedServiceIdentity
類 字串
位置 字串
名字 資源名稱 字串

約束：
模式 = ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ （必要）
性能 實體的其他屬性。 WorkspaceProperties （必要）
sku 自選。 此欄位必須由 RP 實作，因為 AML 支援一個以上的層級 Sku
標籤 資源標籤 標記名稱和值的字典。
類型 資源類型 “Microsoft.MachineLearningServices/workspaces@2023-08-01-preview”

OutboundRule

名字 描述 價值
類別 機器學習工作區的受控網路輸出規則類別。 'Recommended'
'Required'
'UserDefined'
地位 機器學習工作區的受控網路輸出規則類型。 'Active'
'Inactive'
類型 將 類型設定為 'FQDN'，FqdnOutboundRule。 針對 type PrivateEndpointOutboundRule，設定為 'PrivateEndpoint'。 針對 serviceTagOutboundRule 類型 設定為 'ServiceTag'，。 'FQDN'
'PrivateEndpoint'
'ServiceTag' （必要）

PrivateEndpointDestination

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

PrivateEndpointOutboundRule

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

ServerlessComputeSettings

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

ServiceManagedResourcesSettings

名字 描述 價值
cosmosDb CosmosDbSettings

ServiceTagDestination

名字 描述 價值
行動 網路規則的動作列舉。 'Allow'
'Deny'
portRanges 字串
協定 字串
serviceTag 字串

ServiceTagOutboundRule

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

SharedPrivateLinkResource

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

SharedPrivateLinkResourceProperty

名字 描述 價值
groupId 私人連結的群組標識碼 字串
privateLinkResourceId 私人連結所連結的資源標識碼 字串
requestMessage 要求訊息 字串
地位 服務取用者與服務提供者的連接狀態 「已核准」
'Disconnected'
'Pending'
'Rejected'
'Timeout'

Sku

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

UserAssignedIdentities

名字 描述 價值

UserAssignedIdentity

名字 描述 價值

WorkspaceHubConfig

名字 描述 價值
additionalWorkspaceStorageAccounts string[]
defaultWorkspaceResourceGroup 字串

WorkspaceProperties

名字 描述 價值
allowPublicAccessWhenBehindVnet 旗標，指出是否要在 VNet 後方允許公用存取。 bool
applicationInsights 與此工作區相關聯的 Application Insights ARM 識別碼。 字串
associatedWorkspaces string[]
containerRegistries string[]
containerRegistry 與此工作區相關聯的容器登錄ARM標識碼。 字串
描述 此工作區的描述。 字串
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

WorkspaceTags

名字 描述 價值