Microsoft.MachineLearningServices 工作區/計算 2022-10-01

• 最新
• 2024-07-01-preview
• 2024-04-01
• 2024-04-01-preview
• 2024-01-01-preview
• 2023-10-01
• 2023-08-01-preview
• 2023-06-01-preview
• 2023-04-01
• 2023-04-01-preview
• 2023-02-01-preview
• 2022-12-01-preview
• 2022-10-01
• 2022-10-01-preview
• 2022-06-01-preview
• 2022-05-01
• 2022-02-01-preview
• 2022-01-01-preview
• 2021-07-01
• 2021-04-01
• 2021-03-01-preview
• 2021-01-01
• 2020-09-01-preview
• 2020-08-01
• 2020-06-01
• 2020-05-15-preview
• 2020-05-01-preview
• 2020-04-01
• 2020-03-01
• 2020-02-18-preview
• 2020-01-01
• 2019-11-01
• 2019-06-01
• 2019-05-01
• 2018-11-19
• 2018-03-01-preview

Bicep 資源定義

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

• 資源群組 - 請參閱 資源群組部署命令

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

資源格式

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

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/computes@2022-10-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    computeLocation: 'string'
    description: 'string'
    disableLocalAuth: bool
    resourceId: 'string'
    computeType: 'string'
    // For remaining properties, see Compute objects
  }
}

計算物件

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

針對 AKS，請使用：

  computeType: 'AKS'
  properties: {
    agentCount: int
    agentVmSize: 'string'
    aksNetworkingConfiguration: {
      dnsServiceIP: 'string'
      dockerBridgeCidr: 'string'
      serviceCidr: 'string'
      subnetId: 'string'
    }
    clusterFqdn: 'string'
    clusterPurpose: 'string'
    loadBalancerSubnet: 'string'
    loadBalancerType: 'string'
    sslConfiguration: {
      cert: 'string'
      cname: 'string'
      key: 'string'
      leafDomainLabel: 'string'
      overwriteExistingDomain: bool
      status: 'string'
    }
  }

針對 AmlCompute，請使用：

  computeType: 'AmlCompute'
  properties: {
    enableNodePublicIp: bool
    isolatedNetwork: bool
    osType: 'string'
    propertyBag: any()
    remoteLoginPortPublicAccess: 'string'
    scaleSettings: {
      maxNodeCount: int
      minNodeCount: int
      nodeIdleTimeBeforeScaleDown: 'string'
    }
    subnet: {
      id: 'string'
    }
    userAccountCredentials: {
      adminUserName: 'string'
      adminUserPassword: 'string'
      adminUserSshPublicKey: 'string'
    }
    virtualMachineImage: {
      id: 'string'
    }
    vmPriority: 'string'
    vmSize: 'string'
  }

針對 ComputeInstance，請使用：

  computeType: 'ComputeInstance'
  properties: {
    applicationSharingPolicy: 'string'
    computeInstanceAuthorizationType: 'personal'
    enableNodePublicIp: bool
    personalComputeInstanceSettings: {
      assignedUser: {
        objectId: 'string'
        tenantId: 'string'
      }
    }
    schedules: {
      computeStartStop: [
        {
          action: 'string'
          cron: {
            expression: 'string'
            startTime: 'string'
            timeZone: 'string'
          }
          recurrence: {
            frequency: 'string'
            interval: int
            schedule: {
              hours: [
                int
              ]
              minutes: [
                int
              ]
              monthDays: [
                int
              ]
              weekDays: [
                'string'
              ]
            }
            startTime: 'string'
            timeZone: 'string'
          }
          schedule: {
            id: 'string'
            provisioningStatus: 'string'
            status: 'string'
          }
          status: 'string'
          triggerType: 'string'
        }
      ]
    }
    setupScripts: {
      scripts: {
        creationScript: {
          scriptArguments: 'string'
          scriptData: 'string'
          scriptSource: 'string'
          timeout: 'string'
        }
        startupScript: {
          scriptArguments: 'string'
          scriptData: 'string'
          scriptSource: 'string'
          timeout: 'string'
        }
      }
    }
    sshSettings: {
      adminPublicKey: 'string'
      sshPublicAccess: 'string'
    }
    subnet: {
      id: 'string'
    }
    vmSize: 'string'
  }

針對 Databricks，請使用：

  computeType: 'Databricks'
  properties: {
    databricksAccessToken: 'string'
    workspaceUrl: 'string'
  }

針對 DataFactory，請使用：

  computeType: 'DataFactory'

針對 DataLakeAnalytics，請使用：

  computeType: 'DataLakeAnalytics'
  properties: {
    dataLakeStoreAccountName: 'string'
  }

針對 HDInsight，請使用：

  computeType: 'HDInsight'
  properties: {
    address: 'string'
    administratorAccount: {
      password: 'string'
      privateKeyData: 'string'
      publicKeyData: 'string'
      username: 'string'
    }
    sshPort: int
  }

針對 Kubernetes，請使用：

  computeType: 'Kubernetes'
  properties: {
    defaultInstanceType: 'string'
    extensionInstanceReleaseTrain: 'string'
    extensionPrincipalId: 'string'
    instanceTypes: {
      {customized property}: {
        nodeSelector: {
          {customized property}: 'string'
        }
        resources: {
          limits: {
            {customized property}: 'string'
          }
          requests: {
            {customized property}: 'string'
          }
        }
      }
    }
    namespace: 'string'
    relayConnectionString: 'string'
    serviceBusConnectionString: 'string'
    vcName: 'string'
  }

針對 SynapseSpark，請使用：

  computeType: 'SynapseSpark'
  properties: {
    autoPauseProperties: {
      delayInMinutes: int
      enabled: bool
    }
    autoScaleProperties: {
      enabled: bool
      maxNodeCount: int
      minNodeCount: int
    }
    nodeCount: int
    nodeSize: 'string'
    nodeSizeFamily: 'string'
    poolName: 'string'
    resourceGroup: 'string'
    sparkVersion: 'string'
    subscriptionId: 'string'
    workspaceName: 'string'
  }

針對 VirtualMachine，請使用：

  computeType: 'VirtualMachine'
  properties: {
    address: 'string'
    administratorAccount: {
      password: 'string'
      privateKeyData: 'string'
      publicKeyData: 'string'
      username: 'string'
    }
    isNotebookInstanceCompute: bool
    notebookServerPort: int
    sshPort: int
    virtualMachineSize: 'string'
  }

屬性值

workspaces/computes

名字	描述	價值
名字	資源名稱 請參閱如何在 Bicep 中設定子資源的名稱和類型。	字串 （必要） 字元限制：計算實例 3-24 適用於 AML 計算的 3-32 其他計算類型的 2-16 合法字元： 英數位元和連字元。
位置	指定資源的位置。	字串
標籤	包含定義為索引鍵/值組的資源標記。	標記名稱和值的字典。 請參閱範本中的 標籤
sku	工作區的 SKU。	Sku
父母	在 Bicep 中，您可以指定子資源的父資源。 只有在父資源外部宣告子資源時，才需要新增這個屬性。 如需詳細資訊，請參閱 父資源外部的子資源。	類型的資源符號名稱：工作區
身份	資源的身分識別。	ManagedServiceIdentity
性能	計算屬性	計算

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。

計算

名字	描述	價值
computeLocation	基礎計算的位置	字串
描述	Machine Learning 計算的描述。	字串
disableLocalAuth	退出宣告本機驗證，並確保客戶只能只使用 MSI 和 AAD 進行驗證。	bool
resourceId	基礎計算的 ARM 資源識別碼	字串
computeType	設定物件類型	AKS AmlCompute ComputeInstance Databricks DataFactory DataLakeAnalytics HDInsight Kubernetes SynapseSpark VirtualMachine （必要）

AKS

名字	描述	價值
computeType	計算的類型	'AKS' （必要）
性能	AKS 屬性	AKSSchemaProperties

AKSSchemaProperties

名字	描述	價值
agentCount	代理程式數目	int 約束： 最小值 = 0
agentVmSize	代理程式虛擬機大小	字串
aksNetworkingConfiguration	vnet 的 AKS 網路設定	AksNetworkingConfiguration
clusterFqdn	叢集完整功能變數名稱	字串
clusterPurpose	叢集的預期使用方式	'DenseProd' 'DevTest' 'FastProd'
loadBalancerSubnet	Load Balancer 子網	字串
loadBalancerType	Load Balancer 類型	'InternalLoadBalancer' 'PublicIp'
sslConfiguration	SSL 組態	SslConfiguration

AksNetworkingConfiguration

名字	描述	價值
dnsServiceIP	指派給 Kubernetes DNS 服務的 IP 位址。 它必須位於 serviceCidr 中指定的 Kubernetes 服務地址範圍內。	字串 約束： Pattern = ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
dockerBridgeCidr	指派給 Docker 網橋網路的 CIDR 表示法 IP 範圍。 它不得與任何子網 IP 範圍或 Kubernetes 服務地址範圍重疊。	字串 約束： Pattern = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidr	要從中指派服務叢集IP的CIDR表示法IP範圍。 它不得與任何子網IP範圍重疊。	字串 約束： Pattern = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
subnetId	計算節點所屬的虛擬網路子網資源標識碼	字串

SslConfiguration

名字	描述	價值
證書	憑證數據	字串 約束： 敏感性值。 以安全參數的形式傳入。
cname	憑證的 CNAME	字串
鑰匙	索引鍵數據	字串 約束： 敏感性值。 以安全參數的形式傳入。
leafDomainLabel	公用端點的分葉網域標籤	字串
overwriteExistingDomain	指出是否要覆寫現有的網域卷標。	bool
地位	啟用或停用 SSL 以進行評分	'Auto' 'Disabled' 'Enabled'

AmlCompute

名字	描述	價值
computeType	計算的類型	'AmlCompute' （必要）
性能	AmlCompute 的屬性	AmlComputeProperties

AmlComputeProperties

名字	描述	價值
enableNodePublicIp	啟用或停用節點公用IP位址布建。 可能的值為：可能的值為：true - 表示計算節點會布建公用IP。 false - 表示計算節點會有私人端點，而且沒有公用IP。	bool
isolatedNetwork	網路已隔離或未隔離	bool
osType	計算 OS 類型	'Linux' 'Windows'
propertyBag	包含其他屬性的屬性包。	針對 Bicep，您可以使用 any（） 函式。
remoteLoginPortPublicAccess	公用 SSH 埠的狀態。 可能的值為：已停用 - 指出叢集所有節點上的公用 SSH 埠已關閉。 已啟用 - 指出叢集的所有節點上已開啟公用 SSH 埠。 NotSpecified - 指出如果已定義 VNet，則叢集的所有節點上都會關閉公用 SSH 埠，否則會開啟所有公用節點。 它只能在叢集建立期間預設，建立之後才會啟用或停用。	'Disabled' 'Enabled' 'NotSpecified'
scaleSettings	AML 計算的調整設定	ScaleSettings
子	計算節點所屬的虛擬網路子網資源標識碼。	ResourceId
userAccountCredentials	將在每個計算節點上建立之系統管理員用戶帳戶的認證。	UserAccountCredentials
virtualMachineImage	AML 計算的虛擬機映射 - 僅限視窗	VirtualMachineImage
vmPriority	虛擬機優先順序	'Dedicated' 'LowPriority'
vmSize	虛擬機大小	字串

ScaleSettings

名字	描述	價值
maxNodeCount	要使用的節點數目上限	int （必要）
minNodeCount	要使用的節點數目下限	int
nodeIdleTimeBeforeScaleDown	相應減少 amlCompute 之前的節點空閒時間。 此字串必須是 RFC 格式。	字串

ResourceId

名字	描述	價值
id	資源的標識碼	字串 （必要）

UserAccountCredentials

名字	描述	價值
adminUserName	可用來透過 SSH 連線到節點的系統管理員用戶帳戶名稱。	字串 （必要）
adminUserPassword	系統管理員用戶帳戶的密碼。	字串 約束： 敏感性值。 以安全參數的形式傳入。
adminUserSshPublicKey	系統管理員用戶帳戶的 SSH 公鑰。	字串 約束： 敏感性值。 以安全參數的形式傳入。

VirtualMachineImage

名字	描述	價值
id	虛擬機映像路徑	字串 （必要）

ComputeInstance

名字	描述	價值
computeType	計算的類型	'ComputeInstance' （必要）
性能	ComputeInstance 的屬性	ComputeInstanceProperties

ComputeInstanceProperties

名字	描述	價值
applicationSharingPolicy	在父工作區用戶之間共用此計算實例上應用程式的原則。 如果為 Personal，則只有建立者可以存取此計算實例上的應用程式。 當共用時，任何工作區使用者都可以根據指派的角色存取此實例上的應用程式。	'Personal' 'Shared'
computeInstanceAuthorizationType	計算實例授權類型。 可用的值為個人值（預設值）。	'personal'
enableNodePublicIp	啟用或停用節點公用IP位址布建。 可能的值為：可能的值為：true - 表示計算節點會布建公用IP。 false - 表示計算節點會有私人端點，而且沒有公用IP。	bool
personalComputeInstanceSettings	個人計算實例的設定。	PersonalComputeInstanceSettings
附表	要套用至計算的排程清單。	ComputeSchedules
setupScripts	用來設定叢集的自定義腳本詳細數據。	SetupScripts
sshSettings	指定 SSH 存取的原則和設定。	ComputeInstanceSshSettings
子	計算節點所屬的虛擬網路子網資源標識碼。	ResourceId
vmSize	虛擬機大小	字串

PersonalComputeInstanceSettings

名字	描述	價值
assignedUser	明確指派給個人計算實例的使用者。	AssignedUser

AssignedUser

名字	描述	價值
objectId	使用者的 AAD 物件識別碼。	字串 （必要）
tenantId	使用者的 AAD 租使用者識別碼。	字串 （必要）

ComputeSchedules

名字	描述	價值
computeStartStop	要套用的計算啟動停止排程清單。	ComputeStartStopSchedule[]

ComputeStartStopSchedule

名字	描述	價值
行動	[必要]計算能力動作。	'Start' 'Stop'
cron	如果 triggerType 為 Cron，則為必要項。	Cron
復發	如果 triggerType 為 Recurrence，則為必要項。	循環
附表	[已淘汰]不再使用。	ScheduleBase
地位	排程已啟用或停用嗎？	'Disabled' 'Enabled'
triggerType	[必要]排程觸發程序類型。	'Cron' 'Recurrence'

Cron

名字	描述	價值
表達	[必要]指定排程的cron運算式。 表達式應遵循 NCronTab 格式。	字串
startTime	yyyy-MM-ddTHH：mm：ss 格式的開始時間。	字串
timeZone	指定排程執行所在的時區。 TimeZone應遵循 Windows 時區格式。 請參閱：/windows-hardware/manufacture/desktop/default-time-zones />	字串

復發

名字	描述	價值
頻率	[必要]觸發排程的頻率。	'Day' 'Hour' 'Minute' 'Month' 'Week'
間隔	[必要]指定排程間隔與頻率	int
附表	[必要]週期排程。	RecurrenceSchedule
startTime	yyyy-MM-ddTHH：mm：ss 格式的開始時間。	字串
timeZone	指定排程執行所在的時區。 TimeZone應遵循 Windows 時區格式。 請參閱：/windows-hardware/manufacture/desktop/default-time-zones />	字串

RecurrenceSchedule

名字	描述	價值
小時	[必要]排程的時數清單。	int[] （必要）
紀要	[必要]排程的分鐘數清單。	int[] （必要）
monthDays	排程的月份天數清單	int[]
平日	排程的天數清單。	包含任何的字串數組： 'Friday' 'Monday' 'Saturday' 'Sunday' 'Thursday' 'Tuesday' 'Wednesday'

ScheduleBase

名字	描述	價值
id	排程的系統指派標識碼。	字串
provisioningStatus	排程的目前部署狀態。	'Completed' 'Failed' 'Provisioning'
地位	排程已啟用或停用嗎？	'Disabled' 'Enabled'

SetupScripts

名字	描述	價值
腳本	自訂設定文稿	ScriptsToExecute

ScriptsToExecute

名字	描述	價值
creationScript	在布建計算期間只執行一次的腳本。	ScriptReference
startupScript	每次機器啟動時都會執行的腳本。	ScriptReference

ScriptReference

名字	描述	價值
scriptArguments	傳遞至腳本以執行的選擇性命令行自變數。	字串
scriptData	掛接磁碟區中的腳本位置。	字串
scriptSource	腳本的儲存來源：工作區。	字串
超時	傳遞至逾時命令的選擇性時段。	字串

ComputeInstanceSshSettings

名字	描述	價值
adminPublicKey	將 SSH rsa 公鑰檔案指定為字串。 使用 「ssh-keygen -t rsa -b 2048」 來產生 SSH 密鑰組。	字串
sshPublicAccess	公用 SSH 埠的狀態。 可能的值為：Disabled - 指出此實例上的公用 SSH 埠已關閉。 已啟用 - 指出如果適用，公用 SSH 埠已開啟且可依 VNet/子網原則存取。	'Disabled' 'Enabled'

Databricks

名字	描述	價值
computeType	計算的類型	'Databricks' （必要）
性能	Databricks 的屬性	DatabricksProperties

DatabricksProperties

名字	描述	價值
databricksAccessToken	Databricks 存取令牌	字串
workspaceUrl	工作區 URL	字串

DataFactory

名字	描述	價值
computeType	計算的類型	'DataFactory' （必要）

DataLakeAnalytics

名字	描述	價值
computeType	計算的類型	'DataLakeAnalytics' （必要）
性能		DataLakeAnalyticsSchemaProperties

DataLakeAnalyticsSchemaProperties

名字	描述	價值
dataLakeStoreAccountName	DataLake Store 帳戶名稱	字串

HDInsight

名字	描述	價值
computeType	計算的類型	'HDInsight' （必要）
性能	HDInsight 計算屬性	HDInsightProperties

HDInsightProperties

名字	描述	價值
位址	叢集主要節點的公用IP位址。	字串
administratorAccount	叢集主要節點的管理員認證	VirtualMachineSshCredentials
sshPort	針對叢集主要節點上的SSH連線開啟埠。	int

VirtualMachineSshCredentials

名字	描述	價值
密碼	系統管理員帳戶的密碼	字串
privateKeyData	私鑰資料	字串 約束： 敏感性值。 以安全參數的形式傳入。
publicKeyData	公鑰資料	字串 約束： 敏感性值。 以安全參數的形式傳入。
username	系統管理員帳戶的用戶名稱	字串

Kubernetes

名字	描述	價值
computeType	計算的類型	'Kubernetes' （必要）
性能	Kubernetes 的屬性	KubernetesProperties

KubernetesProperties

名字	描述	價值
defaultInstanceType	默認實例類型	字串
extensionInstanceReleaseTrain	擴充實例發行定型。	字串
extensionPrincipalId	擴充主體標識碼。	字串
instanceTypes	實例類型架構	KubernetesPropertiesInstanceTypes
namespace	計算命名空間	字串
relayConnectionString	轉寄連接字串。	字串 約束： 敏感性值。 以安全參數的形式傳入。
serviceBusConnectionString	ServiceBus 連接字串。	字串 約束： 敏感性值。 以安全參數的形式傳入。
vcName	VC 名稱。	字串

KubernetesPropertiesInstanceTypes

名字	描述	價值
{自定義屬性}		InstanceTypeSchema

InstanceTypeSchema

名字	描述	價值
nodeSelector	節點選取器	InstanceTypeSchemaNodeSelector
資源	此實例類型的資源要求/限制	InstanceTypeSchemaResources

InstanceTypeSchemaNodeSelector

名字	描述	價值
{自定義屬性}		字串

InstanceTypeSchemaResources

名字	描述	價值
限制	此實例類型的資源限制	InstanceResourceSchema
請求	此實例類型的資源要求	InstanceResourceSchema

InstanceResourceSchema

名字	描述	價值
{自定義屬性}		字串

SynapseSpark

名字	描述	價值
computeType	計算的類型	'SynapseSpark' （必要）
性能		SynapseSparkProperties

SynapseSparkProperties

名字	描述	價值
autoPauseProperties	自動暫停屬性。	AutoPauseProperties
autoScaleProperties	自動調整屬性。	AutoScaleProperties
nodeCount	目前指派給計算的計算節點數目。	int
nodeSize	節點大小。	字串
nodeSizeFamily	節點大小系列。	字串
poolName	集區名稱。	字串
resourceGroup	工作區所在的資源群組名稱。	字串
sparkVersion	Spark 版本。	字串
subscriptionId	Azure 訂用帳戶標識碼。	字串
workspaceName	Azure Machine Learning 工作區的名稱。	字串

AutoPauseProperties

名字	描述	價值
delayInMinutes		int
啟用		bool

AutoScaleProperties

名字	描述	價值
啟用		bool
maxNodeCount		int
minNodeCount		int

VirtualMachine

名字	描述	價值
computeType	計算的類型	'VirtualMachine' （必要）
性能		VirtualMachineSchemaProperties

VirtualMachineSchemaProperties

名字	描述	價值
位址	虛擬機的公用IP位址。	字串
administratorAccount	虛擬機的管理員認證	VirtualMachineSshCredentials
isNotebookInstanceCompute	指出此計算是否將用於執行筆記本。	bool
notebookServerPort	針對SSH連線開啟的筆記本伺服器埠。	int
sshPort	針對SSH連線開啟埠。	int
virtualMachineSize	虛擬機大小	字串

Sku

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

快速入門範本

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

範本	描述
建立機器學習服務 ADLA 計算	此範本會建立 Machine Learning 服務 ADLA Compute。
建立 Machine Learning 服務 Aks 計算	此範本會建立 Machine Learning 服務 Aks Compute。
建立機器學習服務 DSVM 計算	此範本會建立機器學習服務 DSVM 計算。
建立機器學習服務 HDInsight 叢集	此範本會建立機器學習服務 HDInsight 叢集
建立 Azure Machine Learning aks 計算	此範本會建立 Azure Machine Learning aks 計算。
建立 Azure Machine Learning 計算叢集	此範本會建立 Azure Machine Learning 計算叢集。
建立 Azure Machine Learning 計算實例	此範本會代表另一位具有範例內嵌設定腳本的使用者建立 Azure Machine Learning 計算實例
在 Azure Machine Learning 工作區中建立 LinkedService	此範本會在現有的 Azure Machine Learning 工作區中建立 LinkedService。
建立具有私人IP位址的 AKS 計算目標	此範本會在具有私人IP位址的指定 Azure Machine Learning 服務工作區中建立 AKS 計算目標。

ARM 樣本資源定義

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

• 資源群組 - 請參閱 資源群組部署命令

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

資源格式

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

{
  "type": "Microsoft.MachineLearningServices/workspaces/computes",
  "apiVersion": "2022-10-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "computeLocation": "string",
    "description": "string",
    "disableLocalAuth": "bool",
    "resourceId": "string",
    "computeType": "string"
    // For remaining properties, see Compute objects
  }
}

計算物件

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

針對 AKS，請使用：

  "computeType": "AKS",
  "properties": {
    "agentCount": "int",
    "agentVmSize": "string",
    "aksNetworkingConfiguration": {
      "dnsServiceIP": "string",
      "dockerBridgeCidr": "string",
      "serviceCidr": "string",
      "subnetId": "string"
    },
    "clusterFqdn": "string",
    "clusterPurpose": "string",
    "loadBalancerSubnet": "string",
    "loadBalancerType": "string",
    "sslConfiguration": {
      "cert": "string",
      "cname": "string",
      "key": "string",
      "leafDomainLabel": "string",
      "overwriteExistingDomain": "bool",
      "status": "string"
    }
  }

針對 AmlCompute，請使用：

  "computeType": "AmlCompute",
  "properties": {
    "enableNodePublicIp": "bool",
    "isolatedNetwork": "bool",
    "osType": "string",
    "propertyBag": {},
    "remoteLoginPortPublicAccess": "string",
    "scaleSettings": {
      "maxNodeCount": "int",
      "minNodeCount": "int",
      "nodeIdleTimeBeforeScaleDown": "string"
    },
    "subnet": {
      "id": "string"
    },
    "userAccountCredentials": {
      "adminUserName": "string",
      "adminUserPassword": "string",
      "adminUserSshPublicKey": "string"
    },
    "virtualMachineImage": {
      "id": "string"
    },
    "vmPriority": "string",
    "vmSize": "string"
  }

針對 ComputeInstance，請使用：

  "computeType": "ComputeInstance",
  "properties": {
    "applicationSharingPolicy": "string",
    "computeInstanceAuthorizationType": "personal",
    "enableNodePublicIp": "bool",
    "personalComputeInstanceSettings": {
      "assignedUser": {
        "objectId": "string",
        "tenantId": "string"
      }
    },
    "schedules": {
      "computeStartStop": [
        {
          "action": "string",
          "cron": {
            "expression": "string",
            "startTime": "string",
            "timeZone": "string"
          },
          "recurrence": {
            "frequency": "string",
            "interval": "int",
            "schedule": {
              "hours": [ "int" ],
              "minutes": [ "int" ],
              "monthDays": [ "int" ],
              "weekDays": [ "string" ]
            },
            "startTime": "string",
            "timeZone": "string"
          },
          "schedule": {
            "id": "string",
            "provisioningStatus": "string",
            "status": "string"
          },
          "status": "string",
          "triggerType": "string"
        }
      ]
    },
    "setupScripts": {
      "scripts": {
        "creationScript": {
          "scriptArguments": "string",
          "scriptData": "string",
          "scriptSource": "string",
          "timeout": "string"
        },
        "startupScript": {
          "scriptArguments": "string",
          "scriptData": "string",
          "scriptSource": "string",
          "timeout": "string"
        }
      }
    },
    "sshSettings": {
      "adminPublicKey": "string",
      "sshPublicAccess": "string"
    },
    "subnet": {
      "id": "string"
    },
    "vmSize": "string"
  }

針對 Databricks，請使用：

  "computeType": "Databricks",
  "properties": {
    "databricksAccessToken": "string",
    "workspaceUrl": "string"
  }

針對 DataFactory，請使用：

  "computeType": "DataFactory"

針對 DataLakeAnalytics，請使用：

  "computeType": "DataLakeAnalytics",
  "properties": {
    "dataLakeStoreAccountName": "string"
  }

針對 HDInsight，請使用：

  "computeType": "HDInsight",
  "properties": {
    "address": "string",
    "administratorAccount": {
      "password": "string",
      "privateKeyData": "string",
      "publicKeyData": "string",
      "username": "string"
    },
    "sshPort": "int"
  }

針對 Kubernetes，請使用：

  "computeType": "Kubernetes",
  "properties": {
    "defaultInstanceType": "string",
    "extensionInstanceReleaseTrain": "string",
    "extensionPrincipalId": "string",
    "instanceTypes": {
      "{customized property}": {
        "nodeSelector": {
          "{customized property}": "string"
        },
        "resources": {
          "limits": {
            "{customized property}": "string"
          },
          "requests": {
            "{customized property}": "string"
          }
        }
      }
    },
    "namespace": "string",
    "relayConnectionString": "string",
    "serviceBusConnectionString": "string",
    "vcName": "string"
  }

針對 SynapseSpark，請使用：

  "computeType": "SynapseSpark",
  "properties": {
    "autoPauseProperties": {
      "delayInMinutes": "int",
      "enabled": "bool"
    },
    "autoScaleProperties": {
      "enabled": "bool",
      "maxNodeCount": "int",
      "minNodeCount": "int"
    },
    "nodeCount": "int",
    "nodeSize": "string",
    "nodeSizeFamily": "string",
    "poolName": "string",
    "resourceGroup": "string",
    "sparkVersion": "string",
    "subscriptionId": "string",
    "workspaceName": "string"
  }

針對 VirtualMachine，請使用：

  "computeType": "VirtualMachine",
  "properties": {
    "address": "string",
    "administratorAccount": {
      "password": "string",
      "privateKeyData": "string",
      "publicKeyData": "string",
      "username": "string"
    },
    "isNotebookInstanceCompute": "bool",
    "notebookServerPort": "int",
    "sshPort": "int",
    "virtualMachineSize": "string"
  }

屬性值

workspaces/computes

名字	描述	價值
類型	資源類型	'Microsoft.MachineLearningServices/workspaces/computes'
apiVersion	資源 API 版本	'2022-10-01'
名字	資源名稱 請參閱如何在JSON ARM 範本中設定子資源的名稱和類型。	字串 （必要） 字元限制：計算實例 3-24 適用於 AML 計算的 3-32 其他計算類型的 2-16 合法字元： 英數位元和連字元。
位置	指定資源的位置。	字串
標籤	包含定義為索引鍵/值組的資源標記。	標記名稱和值的字典。 請參閱範本中的 標籤
sku	工作區的 SKU。	Sku
身份	資源的身分識別。	ManagedServiceIdentity
性能	計算屬性	計算

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。

計算

名字	描述	價值
computeLocation	基礎計算的位置	字串
描述	Machine Learning 計算的描述。	字串
disableLocalAuth	退出宣告本機驗證，並確保客戶只能只使用 MSI 和 AAD 進行驗證。	bool
resourceId	基礎計算的 ARM 資源識別碼	字串
computeType	設定物件類型	AKS AmlCompute ComputeInstance Databricks DataFactory DataLakeAnalytics HDInsight Kubernetes SynapseSpark VirtualMachine （必要）

AKS

名字	描述	價值
computeType	計算的類型	'AKS' （必要）
性能	AKS 屬性	AKSSchemaProperties

AKSSchemaProperties

名字	描述	價值
agentCount	代理程式數目	int 約束： 最小值 = 0
agentVmSize	代理程式虛擬機大小	字串
aksNetworkingConfiguration	vnet 的 AKS 網路設定	AksNetworkingConfiguration
clusterFqdn	叢集完整功能變數名稱	字串
clusterPurpose	叢集的預期使用方式	'DenseProd' 'DevTest' 'FastProd'
loadBalancerSubnet	Load Balancer 子網	字串
loadBalancerType	Load Balancer 類型	'InternalLoadBalancer' 'PublicIp'
sslConfiguration	SSL 組態	SslConfiguration

AksNetworkingConfiguration

名字	描述	價值
dnsServiceIP	指派給 Kubernetes DNS 服務的 IP 位址。 它必須位於 serviceCidr 中指定的 Kubernetes 服務地址範圍內。	字串 約束： Pattern = ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
dockerBridgeCidr	指派給 Docker 網橋網路的 CIDR 表示法 IP 範圍。 它不得與任何子網 IP 範圍或 Kubernetes 服務地址範圍重疊。	字串 約束： Pattern = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidr	要從中指派服務叢集IP的CIDR表示法IP範圍。 它不得與任何子網IP範圍重疊。	字串 約束： Pattern = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
subnetId	計算節點所屬的虛擬網路子網資源標識碼	字串

SslConfiguration

名字	描述	價值
證書	憑證數據	字串 約束： 敏感性值。 以安全參數的形式傳入。
cname	憑證的 CNAME	字串
鑰匙	索引鍵數據	字串 約束： 敏感性值。 以安全參數的形式傳入。
leafDomainLabel	公用端點的分葉網域標籤	字串
overwriteExistingDomain	指出是否要覆寫現有的網域卷標。	bool
地位	啟用或停用 SSL 以進行評分	'Auto' 'Disabled' 'Enabled'

AmlCompute

名字	描述	價值
computeType	計算的類型	'AmlCompute' （必要）
性能	AmlCompute 的屬性	AmlComputeProperties

AmlComputeProperties

名字	描述	價值
enableNodePublicIp	啟用或停用節點公用IP位址布建。 可能的值為：可能的值為：true - 表示計算節點會布建公用IP。 false - 表示計算節點會有私人端點，而且沒有公用IP。	bool
isolatedNetwork	網路已隔離或未隔離	bool
osType	計算 OS 類型	'Linux' 'Windows'
propertyBag	包含其他屬性的屬性包。
remoteLoginPortPublicAccess	公用 SSH 埠的狀態。 可能的值為：已停用 - 指出叢集所有節點上的公用 SSH 埠已關閉。 已啟用 - 指出叢集的所有節點上已開啟公用 SSH 埠。 NotSpecified - 指出如果已定義 VNet，則叢集的所有節點上都會關閉公用 SSH 埠，否則會開啟所有公用節點。 它只能在叢集建立期間預設，建立之後才會啟用或停用。	'Disabled' 'Enabled' 'NotSpecified'
scaleSettings	AML 計算的調整設定	ScaleSettings
子	計算節點所屬的虛擬網路子網資源標識碼。	ResourceId
userAccountCredentials	將在每個計算節點上建立之系統管理員用戶帳戶的認證。	UserAccountCredentials
virtualMachineImage	AML 計算的虛擬機映射 - 僅限視窗	VirtualMachineImage
vmPriority	虛擬機優先順序	'Dedicated' 'LowPriority'
vmSize	虛擬機大小	字串

ScaleSettings

名字	描述	價值
maxNodeCount	要使用的節點數目上限	int （必要）
minNodeCount	要使用的節點數目下限	int
nodeIdleTimeBeforeScaleDown	相應減少 amlCompute 之前的節點空閒時間。 此字串必須是 RFC 格式。	字串

ResourceId

名字	描述	價值
id	資源的標識碼	字串 （必要）

UserAccountCredentials

名字	描述	價值
adminUserName	可用來透過 SSH 連線到節點的系統管理員用戶帳戶名稱。	字串 （必要）
adminUserPassword	系統管理員用戶帳戶的密碼。	字串 約束： 敏感性值。 以安全參數的形式傳入。
adminUserSshPublicKey	系統管理員用戶帳戶的 SSH 公鑰。	字串 約束： 敏感性值。 以安全參數的形式傳入。

VirtualMachineImage

名字	描述	價值
id	虛擬機映像路徑	字串 （必要）

ComputeInstance

名字	描述	價值
computeType	計算的類型	'ComputeInstance' （必要）
性能	ComputeInstance 的屬性	ComputeInstanceProperties

ComputeInstanceProperties

名字	描述	價值
applicationSharingPolicy	在父工作區用戶之間共用此計算實例上應用程式的原則。 如果為 Personal，則只有建立者可以存取此計算實例上的應用程式。 當共用時，任何工作區使用者都可以根據指派的角色存取此實例上的應用程式。	'Personal' 'Shared'
computeInstanceAuthorizationType	計算實例授權類型。 可用的值為個人值（預設值）。	'personal'
enableNodePublicIp	啟用或停用節點公用IP位址布建。 可能的值為：可能的值為：true - 表示計算節點會布建公用IP。 false - 表示計算節點會有私人端點，而且沒有公用IP。	bool
personalComputeInstanceSettings	個人計算實例的設定。	PersonalComputeInstanceSettings
附表	要套用至計算的排程清單。	ComputeSchedules
setupScripts	用來設定叢集的自定義腳本詳細數據。	SetupScripts
sshSettings	指定 SSH 存取的原則和設定。	ComputeInstanceSshSettings
子	計算節點所屬的虛擬網路子網資源標識碼。	ResourceId
vmSize	虛擬機大小	字串

PersonalComputeInstanceSettings

名字	描述	價值
assignedUser	明確指派給個人計算實例的使用者。	AssignedUser

AssignedUser

名字	描述	價值
objectId	使用者的 AAD 物件識別碼。	字串 （必要）
tenantId	使用者的 AAD 租使用者識別碼。	字串 （必要）

ComputeSchedules

名字	描述	價值
computeStartStop	要套用的計算啟動停止排程清單。	ComputeStartStopSchedule[]

ComputeStartStopSchedule

名字	描述	價值
行動	[必要]計算能力動作。	'Start' 'Stop'
cron	如果 triggerType 為 Cron，則為必要項。	Cron
復發	如果 triggerType 為 Recurrence，則為必要項。	循環
附表	[已淘汰]不再使用。	ScheduleBase
地位	排程已啟用或停用嗎？	'Disabled' 'Enabled'
triggerType	[必要]排程觸發程序類型。	'Cron' 'Recurrence'

Cron

名字	描述	價值
表達	[必要]指定排程的cron運算式。 表達式應遵循 NCronTab 格式。	字串
startTime	yyyy-MM-ddTHH：mm：ss 格式的開始時間。	字串
timeZone	指定排程執行所在的時區。 TimeZone應遵循 Windows 時區格式。 請參閱：/windows-hardware/manufacture/desktop/default-time-zones />	字串

復發

名字	描述	價值
頻率	[必要]觸發排程的頻率。	'Day' 'Hour' 'Minute' 'Month' 'Week'
間隔	[必要]指定排程間隔與頻率	int
附表	[必要]週期排程。	RecurrenceSchedule
startTime	yyyy-MM-ddTHH：mm：ss 格式的開始時間。	字串
timeZone	指定排程執行所在的時區。 TimeZone應遵循 Windows 時區格式。 請參閱：/windows-hardware/manufacture/desktop/default-time-zones />	字串

RecurrenceSchedule

名字	描述	價值
小時	[必要]排程的時數清單。	int[] （必要）
紀要	[必要]排程的分鐘數清單。	int[] （必要）
monthDays	排程的月份天數清單	int[]
平日	排程的天數清單。	包含任何的字串數組： 'Friday' 'Monday' 'Saturday' 'Sunday' 'Thursday' 'Tuesday' 'Wednesday'

ScheduleBase

名字	描述	價值
id	排程的系統指派標識碼。	字串
provisioningStatus	排程的目前部署狀態。	'Completed' 'Failed' 'Provisioning'
地位	排程已啟用或停用嗎？	'Disabled' 'Enabled'

SetupScripts

名字	描述	價值
腳本	自訂設定文稿	ScriptsToExecute

ScriptsToExecute

名字	描述	價值
creationScript	在布建計算期間只執行一次的腳本。	ScriptReference
startupScript	每次機器啟動時都會執行的腳本。	ScriptReference

ScriptReference

名字	描述	價值
scriptArguments	傳遞至腳本以執行的選擇性命令行自變數。	字串
scriptData	掛接磁碟區中的腳本位置。	字串
scriptSource	腳本的儲存來源：工作區。	字串
超時	傳遞至逾時命令的選擇性時段。	字串

ComputeInstanceSshSettings

名字	描述	價值
adminPublicKey	將 SSH rsa 公鑰檔案指定為字串。 使用 「ssh-keygen -t rsa -b 2048」 來產生 SSH 密鑰組。	字串
sshPublicAccess	公用 SSH 埠的狀態。 可能的值為：Disabled - 指出此實例上的公用 SSH 埠已關閉。 已啟用 - 指出如果適用，公用 SSH 埠已開啟且可依 VNet/子網原則存取。	'Disabled' 'Enabled'

Databricks

名字	描述	價值
computeType	計算的類型	'Databricks' （必要）
性能	Databricks 的屬性	DatabricksProperties

DatabricksProperties

名字	描述	價值
databricksAccessToken	Databricks 存取令牌	字串
workspaceUrl	工作區 URL	字串

DataFactory

名字	描述	價值
computeType	計算的類型	'DataFactory' （必要）

DataLakeAnalytics

名字	描述	價值
computeType	計算的類型	'DataLakeAnalytics' （必要）
性能		DataLakeAnalyticsSchemaProperties

DataLakeAnalyticsSchemaProperties

名字	描述	價值
dataLakeStoreAccountName	DataLake Store 帳戶名稱	字串

HDInsight

名字	描述	價值
computeType	計算的類型	'HDInsight' （必要）
性能	HDInsight 計算屬性	HDInsightProperties

HDInsightProperties

名字	描述	價值
位址	叢集主要節點的公用IP位址。	字串
administratorAccount	叢集主要節點的管理員認證	VirtualMachineSshCredentials
sshPort	針對叢集主要節點上的SSH連線開啟埠。	int

VirtualMachineSshCredentials

名字	描述	價值
密碼	系統管理員帳戶的密碼	字串
privateKeyData	私鑰資料	字串 約束： 敏感性值。 以安全參數的形式傳入。
publicKeyData	公鑰資料	字串 約束： 敏感性值。 以安全參數的形式傳入。
username	系統管理員帳戶的用戶名稱	字串

Kubernetes

名字	描述	價值
computeType	計算的類型	'Kubernetes' （必要）
性能	Kubernetes 的屬性	KubernetesProperties

KubernetesProperties

名字	描述	價值
defaultInstanceType	默認實例類型	字串
extensionInstanceReleaseTrain	擴充實例發行定型。	字串
extensionPrincipalId	擴充主體標識碼。	字串
instanceTypes	實例類型架構	KubernetesPropertiesInstanceTypes
namespace	計算命名空間	字串
relayConnectionString	轉寄連接字串。	字串 約束： 敏感性值。 以安全參數的形式傳入。
serviceBusConnectionString	ServiceBus 連接字串。	字串 約束： 敏感性值。 以安全參數的形式傳入。
vcName	VC 名稱。	字串

KubernetesPropertiesInstanceTypes

名字	描述	價值
{自定義屬性}		InstanceTypeSchema

InstanceTypeSchema

名字	描述	價值
nodeSelector	節點選取器	InstanceTypeSchemaNodeSelector
資源	此實例類型的資源要求/限制	InstanceTypeSchemaResources

InstanceTypeSchemaNodeSelector

名字	描述	價值
{自定義屬性}		字串

InstanceTypeSchemaResources

名字	描述	價值
限制	此實例類型的資源限制	InstanceResourceSchema
請求	此實例類型的資源要求	InstanceResourceSchema

InstanceResourceSchema

名字	描述	價值
{自定義屬性}		字串

SynapseSpark

名字	描述	價值
computeType	計算的類型	'SynapseSpark' （必要）
性能		SynapseSparkProperties

SynapseSparkProperties

名字	描述	價值
autoPauseProperties	自動暫停屬性。	AutoPauseProperties
autoScaleProperties	自動調整屬性。	AutoScaleProperties
nodeCount	目前指派給計算的計算節點數目。	int
nodeSize	節點大小。	字串
nodeSizeFamily	節點大小系列。	字串
poolName	集區名稱。	字串
resourceGroup	工作區所在的資源群組名稱。	字串
sparkVersion	Spark 版本。	字串
subscriptionId	Azure 訂用帳戶標識碼。	字串
workspaceName	Azure Machine Learning 工作區的名稱。	字串

AutoPauseProperties

名字	描述	價值
delayInMinutes		int
啟用		bool

AutoScaleProperties

名字	描述	價值
啟用		bool
maxNodeCount		int
minNodeCount		int

VirtualMachine

名字	描述	價值
computeType	計算的類型	'VirtualMachine' （必要）
性能		VirtualMachineSchemaProperties

VirtualMachineSchemaProperties

名字	描述	價值
位址	虛擬機的公用IP位址。	字串
administratorAccount	虛擬機的管理員認證	VirtualMachineSshCredentials
isNotebookInstanceCompute	指出此計算是否將用於執行筆記本。	bool
notebookServerPort	針對SSH連線開啟的筆記本伺服器埠。	int
sshPort	針對SSH連線開啟埠。	int
virtualMachineSize	虛擬機大小	字串

Sku

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

快速入門範本

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

範本	描述
建立機器學習服務 ADLA 計算	此範本會建立 Machine Learning 服務 ADLA Compute。
建立 Machine Learning 服務 Aks 計算	此範本會建立 Machine Learning 服務 Aks Compute。
建立機器學習服務 DSVM 計算	此範本會建立機器學習服務 DSVM 計算。
建立機器學習服務 HDInsight 叢集	此範本會建立機器學習服務 HDInsight 叢集
建立 Azure Machine Learning aks 計算	此範本會建立 Azure Machine Learning aks 計算。
建立 Azure Machine Learning 計算叢集	此範本會建立 Azure Machine Learning 計算叢集。
建立 Azure Machine Learning 計算實例	此範本會代表另一位具有範例內嵌設定腳本的使用者建立 Azure Machine Learning 計算實例
在 Azure Machine Learning 工作區中建立 LinkedService	此範本會在現有的 Azure Machine Learning 工作區中建立 LinkedService。
建立具有私人IP位址的 AKS 計算目標	此範本會在具有私人IP位址的指定 Azure Machine Learning 服務工作區中建立 AKS 計算目標。

Terraform （AzAPI 提供者） 資源定義

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

• 資源群組

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

資源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/computes@2022-10-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      computeLocation = "string"
      description = "string"
      disableLocalAuth = bool
      resourceId = "string"
      computeType = "string"
      // For remaining properties, see Compute objects
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  })
}

計算物件

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

針對 AKS，請使用：

  computeType = "AKS"
  properties = {
    agentCount = int
    agentVmSize = "string"
    aksNetworkingConfiguration = {
      dnsServiceIP = "string"
      dockerBridgeCidr = "string"
      serviceCidr = "string"
      subnetId = "string"
    }
    clusterFqdn = "string"
    clusterPurpose = "string"
    loadBalancerSubnet = "string"
    loadBalancerType = "string"
    sslConfiguration = {
      cert = "string"
      cname = "string"
      key = "string"
      leafDomainLabel = "string"
      overwriteExistingDomain = bool
      status = "string"
    }
  }

針對 AmlCompute，請使用：

  computeType = "AmlCompute"
  properties = {
    enableNodePublicIp = bool
    isolatedNetwork = bool
    osType = "string"
    remoteLoginPortPublicAccess = "string"
    scaleSettings = {
      maxNodeCount = int
      minNodeCount = int
      nodeIdleTimeBeforeScaleDown = "string"
    }
    subnet = {
      id = "string"
    }
    userAccountCredentials = {
      adminUserName = "string"
      adminUserPassword = "string"
      adminUserSshPublicKey = "string"
    }
    virtualMachineImage = {
      id = "string"
    }
    vmPriority = "string"
    vmSize = "string"
  }

針對 ComputeInstance，請使用：

  computeType = "ComputeInstance"
  properties = {
    applicationSharingPolicy = "string"
    computeInstanceAuthorizationType = "personal"
    enableNodePublicIp = bool
    personalComputeInstanceSettings = {
      assignedUser = {
        objectId = "string"
        tenantId = "string"
      }
    }
    schedules = {
      computeStartStop = [
        {
          action = "string"
          cron = {
            expression = "string"
            startTime = "string"
            timeZone = "string"
          }
          recurrence = {
            frequency = "string"
            interval = int
            schedule = {
              hours = [
                int
              ]
              minutes = [
                int
              ]
              monthDays = [
                int
              ]
              weekDays = [
                "string"
              ]
            }
            startTime = "string"
            timeZone = "string"
          }
          schedule = {
            id = "string"
            provisioningStatus = "string"
            status = "string"
          }
          status = "string"
          triggerType = "string"
        }
      ]
    }
    setupScripts = {
      scripts = {
        creationScript = {
          scriptArguments = "string"
          scriptData = "string"
          scriptSource = "string"
          timeout = "string"
        }
        startupScript = {
          scriptArguments = "string"
          scriptData = "string"
          scriptSource = "string"
          timeout = "string"
        }
      }
    }
    sshSettings = {
      adminPublicKey = "string"
      sshPublicAccess = "string"
    }
    subnet = {
      id = "string"
    }
    vmSize = "string"
  }

針對 Databricks，請使用：

  computeType = "Databricks"
  properties = {
    databricksAccessToken = "string"
    workspaceUrl = "string"
  }

針對 DataFactory，請使用：

  computeType = "DataFactory"

針對 DataLakeAnalytics，請使用：

  computeType = "DataLakeAnalytics"
  properties = {
    dataLakeStoreAccountName = "string"
  }

針對 HDInsight，請使用：

  computeType = "HDInsight"
  properties = {
    address = "string"
    administratorAccount = {
      password = "string"
      privateKeyData = "string"
      publicKeyData = "string"
      username = "string"
    }
    sshPort = int
  }

針對 Kubernetes，請使用：

  computeType = "Kubernetes"
  properties = {
    defaultInstanceType = "string"
    extensionInstanceReleaseTrain = "string"
    extensionPrincipalId = "string"
    instanceTypes = {
      {customized property} = {
        nodeSelector = {
          {customized property} = "string"
        }
        resources = {
          limits = {
            {customized property} = "string"
          }
          requests = {
            {customized property} = "string"
          }
        }
      }
    }
    namespace = "string"
    relayConnectionString = "string"
    serviceBusConnectionString = "string"
    vcName = "string"
  }

針對 SynapseSpark，請使用：

  computeType = "SynapseSpark"
  properties = {
    autoPauseProperties = {
      delayInMinutes = int
      enabled = bool
    }
    autoScaleProperties = {
      enabled = bool
      maxNodeCount = int
      minNodeCount = int
    }
    nodeCount = int
    nodeSize = "string"
    nodeSizeFamily = "string"
    poolName = "string"
    resourceGroup = "string"
    sparkVersion = "string"
    subscriptionId = "string"
    workspaceName = "string"
  }

針對 VirtualMachine，請使用：

  computeType = "VirtualMachine"
  properties = {
    address = "string"
    administratorAccount = {
      password = "string"
      privateKeyData = "string"
      publicKeyData = "string"
      username = "string"
    }
    isNotebookInstanceCompute = bool
    notebookServerPort = int
    sshPort = int
    virtualMachineSize = "string"
  }

屬性值

workspaces/computes

名字	描述	價值
類型	資源類型	“Microsoft.MachineLearningServices/workspaces/computes@2022-10-01”
名字	資源名稱	字串 （必要） 字元限制：計算實例 3-24 適用於 AML 計算的 3-32 其他計算類型的 2-16 合法字元： 英數位元和連字元。
位置	指定資源的位置。	字串
parent_id	此資源為父系之資源的標識碼。	類型資源的標識碼：工作區
標籤	包含定義為索引鍵/值組的資源標記。	標記名稱和值的字典。
sku	工作區的 SKU。	Sku
身份	資源的身分識別。	ManagedServiceIdentity
性能	計算屬性	計算

ManagedServiceIdentity

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

UserAssignedIdentities

名字	描述	價值
{自定義屬性}		UserAssignedIdentity

UserAssignedIdentity

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

計算

名字	描述	價值
computeLocation	基礎計算的位置	字串
描述	Machine Learning 計算的描述。	字串
disableLocalAuth	退出宣告本機驗證，並確保客戶只能只使用 MSI 和 AAD 進行驗證。	bool
resourceId	基礎計算的 ARM 資源識別碼	字串
computeType	設定物件類型	AKS AmlCompute ComputeInstance Databricks DataFactory DataLakeAnalytics HDInsight Kubernetes SynapseSpark VirtualMachine （必要）

AKS

名字	描述	價值
computeType	計算的類型	“AKS” （必要）
性能	AKS 屬性	AKSSchemaProperties

AKSSchemaProperties

名字	描述	價值
agentCount	代理程式數目	int 約束： 最小值 = 0
agentVmSize	代理程式虛擬機大小	字串
aksNetworkingConfiguration	vnet 的 AKS 網路設定	AksNetworkingConfiguration
clusterFqdn	叢集完整功能變數名稱	字串
clusterPurpose	叢集的預期使用方式	“DenseProd” “DevTest” “FastProd”
loadBalancerSubnet	Load Balancer 子網	字串
loadBalancerType	Load Balancer 類型	“InternalLoadBalancer” “PublicIp”
sslConfiguration	SSL 組態	SslConfiguration

AksNetworkingConfiguration

名字	描述	價值
dnsServiceIP	指派給 Kubernetes DNS 服務的 IP 位址。 它必須位於 serviceCidr 中指定的 Kubernetes 服務地址範圍內。	字串 約束： Pattern = ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
dockerBridgeCidr	指派給 Docker 網橋網路的 CIDR 表示法 IP 範圍。 它不得與任何子網 IP 範圍或 Kubernetes 服務地址範圍重疊。	字串 約束： Pattern = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidr	要從中指派服務叢集IP的CIDR表示法IP範圍。 它不得與任何子網IP範圍重疊。	字串 約束： Pattern = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
subnetId	計算節點所屬的虛擬網路子網資源標識碼	字串

SslConfiguration

名字	描述	價值
證書	憑證數據	字串 約束： 敏感性值。 以安全參數的形式傳入。
cname	憑證的 CNAME	字串
鑰匙	索引鍵數據	字串 約束： 敏感性值。 以安全參數的形式傳入。
leafDomainLabel	公用端點的分葉網域標籤	字串
overwriteExistingDomain	指出是否要覆寫現有的網域卷標。	bool
地位	啟用或停用 SSL 以進行評分	“Auto” “Disabled” “Enabled”

AmlCompute

名字	描述	價值
computeType	計算的類型	“AmlCompute” （必要）
性能	AmlCompute 的屬性	AmlComputeProperties

AmlComputeProperties

名字	描述	價值
enableNodePublicIp	啟用或停用節點公用IP位址布建。 可能的值為：可能的值為：true - 表示計算節點會布建公用IP。 false - 表示計算節點會有私人端點，而且沒有公用IP。	bool
isolatedNetwork	網路已隔離或未隔離	bool
osType	計算 OS 類型	“Linux” “Windows”
propertyBag	包含其他屬性的屬性包。
remoteLoginPortPublicAccess	公用 SSH 埠的狀態。 可能的值為：已停用 - 指出叢集所有節點上的公用 SSH 埠已關閉。 已啟用 - 指出叢集的所有節點上已開啟公用 SSH 埠。 NotSpecified - 指出如果已定義 VNet，則叢集的所有節點上都會關閉公用 SSH 埠，否則會開啟所有公用節點。 它只能在叢集建立期間預設，建立之後才會啟用或停用。	“Disabled” “Enabled” “NotSpecified”
scaleSettings	AML 計算的調整設定	ScaleSettings
子	計算節點所屬的虛擬網路子網資源標識碼。	ResourceId
userAccountCredentials	將在每個計算節點上建立之系統管理員用戶帳戶的認證。	UserAccountCredentials
virtualMachineImage	AML 計算的虛擬機映射 - 僅限視窗	VirtualMachineImage
vmPriority	虛擬機優先順序	“專用” “LowPriority”
vmSize	虛擬機大小	字串

ScaleSettings

名字	描述	價值
maxNodeCount	要使用的節點數目上限	int （必要）
minNodeCount	要使用的節點數目下限	int
nodeIdleTimeBeforeScaleDown	相應減少 amlCompute 之前的節點空閒時間。 此字串必須是 RFC 格式。	字串

ResourceId

名字	描述	價值
id	資源的標識碼	字串 （必要）

UserAccountCredentials

名字	描述	價值
adminUserName	可用來透過 SSH 連線到節點的系統管理員用戶帳戶名稱。	字串 （必要）
adminUserPassword	系統管理員用戶帳戶的密碼。	字串 約束： 敏感性值。 以安全參數的形式傳入。
adminUserSshPublicKey	系統管理員用戶帳戶的 SSH 公鑰。	字串 約束： 敏感性值。 以安全參數的形式傳入。

VirtualMachineImage

名字	描述	價值
id	虛擬機映像路徑	字串 （必要）

ComputeInstance

名字	描述	價值
computeType	計算的類型	“ComputeInstance” （必要）
性能	ComputeInstance 的屬性	ComputeInstanceProperties

ComputeInstanceProperties

名字	描述	價值
applicationSharingPolicy	在父工作區用戶之間共用此計算實例上應用程式的原則。 如果為 Personal，則只有建立者可以存取此計算實例上的應用程式。 當共用時，任何工作區使用者都可以根據指派的角色存取此實例上的應用程式。	“個人” “Shared”
computeInstanceAuthorizationType	計算實例授權類型。 可用的值為個人值（預設值）。	“personal”
enableNodePublicIp	啟用或停用節點公用IP位址布建。 可能的值為：可能的值為：true - 表示計算節點會布建公用IP。 false - 表示計算節點會有私人端點，而且沒有公用IP。	bool
personalComputeInstanceSettings	個人計算實例的設定。	PersonalComputeInstanceSettings
附表	要套用至計算的排程清單。	ComputeSchedules
setupScripts	用來設定叢集的自定義腳本詳細數據。	SetupScripts
sshSettings	指定 SSH 存取的原則和設定。	ComputeInstanceSshSettings
子	計算節點所屬的虛擬網路子網資源標識碼。	ResourceId
vmSize	虛擬機大小	字串

PersonalComputeInstanceSettings

名字	描述	價值
assignedUser	明確指派給個人計算實例的使用者。	AssignedUser

AssignedUser

名字	描述	價值
objectId	使用者的 AAD 物件識別碼。	字串 （必要）
tenantId	使用者的 AAD 租使用者識別碼。	字串 （必要）

ComputeSchedules

名字	描述	價值
computeStartStop	要套用的計算啟動停止排程清單。	ComputeStartStopSchedule[]

ComputeStartStopSchedule

名字	描述	價值
行動	[必要]計算能力動作。	“Start” “Stop”
cron	如果 triggerType 為 Cron，則為必要項。	Cron
復發	如果 triggerType 為 Recurrence，則為必要項。	循環
附表	[已淘汰]不再使用。	ScheduleBase
地位	排程已啟用或停用嗎？	“Disabled” “Enabled”
triggerType	[必要]排程觸發程序類型。	“Cron” “Recurrence”

Cron

名字	描述	價值
表達	[必要]指定排程的cron運算式。 表達式應遵循 NCronTab 格式。	字串
startTime	yyyy-MM-ddTHH：mm：ss 格式的開始時間。	字串
timeZone	指定排程執行所在的時區。 TimeZone應遵循 Windows 時區格式。 請參閱：/windows-hardware/manufacture/desktop/default-time-zones />	字串

復發

名字	描述	價值
頻率	[必要]觸發排程的頻率。	“Day” “Hour” “Minute” “Month” “Week”
間隔	[必要]指定排程間隔與頻率	int
附表	[必要]週期排程。	RecurrenceSchedule
startTime	yyyy-MM-ddTHH：mm：ss 格式的開始時間。	字串
timeZone	指定排程執行所在的時區。 TimeZone應遵循 Windows 時區格式。 請參閱：/windows-hardware/manufacture/desktop/default-time-zones />	字串

RecurrenceSchedule

名字	描述	價值
小時	[必要]排程的時數清單。	int[] （必要）
紀要	[必要]排程的分鐘數清單。	int[] （必要）
monthDays	排程的月份天數清單	int[]
平日	排程的天數清單。	包含任何的字串數組： “Friday” “Monday” “Saturday” “星期日” “Thursday” “Tuesday” “星期三”

ScheduleBase

名字	描述	價值
id	排程的系統指派標識碼。	字串
provisioningStatus	排程的目前部署狀態。	“Completed” “Failed” 「布建」
地位	排程已啟用或停用嗎？	“Disabled” “Enabled”

SetupScripts

名字	描述	價值
腳本	自訂設定文稿	ScriptsToExecute

ScriptsToExecute

名字	描述	價值
creationScript	在布建計算期間只執行一次的腳本。	ScriptReference
startupScript	每次機器啟動時都會執行的腳本。	ScriptReference

ScriptReference

名字	描述	價值
scriptArguments	傳遞至腳本以執行的選擇性命令行自變數。	字串
scriptData	掛接磁碟區中的腳本位置。	字串
scriptSource	腳本的儲存來源：工作區。	字串
超時	傳遞至逾時命令的選擇性時段。	字串

ComputeInstanceSshSettings

名字	描述	價值
adminPublicKey	將 SSH rsa 公鑰檔案指定為字串。 使用 「ssh-keygen -t rsa -b 2048」 來產生 SSH 密鑰組。	字串
sshPublicAccess	公用 SSH 埠的狀態。 可能的值為：Disabled - 指出此實例上的公用 SSH 埠已關閉。 已啟用 - 指出如果適用，公用 SSH 埠已開啟且可依 VNet/子網原則存取。	“Disabled” “Enabled”

Databricks

名字	描述	價值
computeType	計算的類型	“Databricks” （必要）
性能	Databricks 的屬性	DatabricksProperties

DatabricksProperties

名字	描述	價值
databricksAccessToken	Databricks 存取令牌	字串
workspaceUrl	工作區 URL	字串

DataFactory

名字	描述	價值
computeType	計算的類型	“DataFactory” （必要）

DataLakeAnalytics

名字	描述	價值
computeType	計算的類型	“DataLakeAnalytics” （必要）
性能		DataLakeAnalyticsSchemaProperties

DataLakeAnalyticsSchemaProperties

名字	描述	價值
dataLakeStoreAccountName	DataLake Store 帳戶名稱	字串

HDInsight

名字	描述	價值
computeType	計算的類型	“HDInsight” （必要）
性能	HDInsight 計算屬性	HDInsightProperties

HDInsightProperties

名字	描述	價值
位址	叢集主要節點的公用IP位址。	字串
administratorAccount	叢集主要節點的管理員認證	VirtualMachineSshCredentials
sshPort	針對叢集主要節點上的SSH連線開啟埠。	int

VirtualMachineSshCredentials

名字	描述	價值
密碼	系統管理員帳戶的密碼	字串
privateKeyData	私鑰資料	字串 約束： 敏感性值。 以安全參數的形式傳入。
publicKeyData	公鑰資料	字串 約束： 敏感性值。 以安全參數的形式傳入。
username	系統管理員帳戶的用戶名稱	字串

Kubernetes

名字	描述	價值
computeType	計算的類型	“Kubernetes” （必要）
性能	Kubernetes 的屬性	KubernetesProperties

KubernetesProperties

名字	描述	價值
defaultInstanceType	默認實例類型	字串
extensionInstanceReleaseTrain	擴充實例發行定型。	字串
extensionPrincipalId	擴充主體標識碼。	字串
instanceTypes	實例類型架構	KubernetesPropertiesInstanceTypes
namespace	計算命名空間	字串
relayConnectionString	轉寄連接字串。	字串 約束： 敏感性值。 以安全參數的形式傳入。
serviceBusConnectionString	ServiceBus 連接字串。	字串 約束： 敏感性值。 以安全參數的形式傳入。
vcName	VC 名稱。	字串

KubernetesPropertiesInstanceTypes

名字	描述	價值
{自定義屬性}		InstanceTypeSchema

InstanceTypeSchema

名字	描述	價值
nodeSelector	節點選取器	InstanceTypeSchemaNodeSelector
資源	此實例類型的資源要求/限制	InstanceTypeSchemaResources

InstanceTypeSchemaNodeSelector

名字	描述	價值
{自定義屬性}		字串

InstanceTypeSchemaResources

名字	描述	價值
限制	此實例類型的資源限制	InstanceResourceSchema
請求	此實例類型的資源要求	InstanceResourceSchema

InstanceResourceSchema

名字	描述	價值
{自定義屬性}		字串

SynapseSpark

名字	描述	價值
computeType	計算的類型	“SynapseSpark” （必要）
性能		SynapseSparkProperties

SynapseSparkProperties

名字	描述	價值
autoPauseProperties	自動暫停屬性。	AutoPauseProperties
autoScaleProperties	自動調整屬性。	AutoScaleProperties
nodeCount	目前指派給計算的計算節點數目。	int
nodeSize	節點大小。	字串
nodeSizeFamily	節點大小系列。	字串
poolName	集區名稱。	字串
resourceGroup	工作區所在的資源群組名稱。	字串
sparkVersion	Spark 版本。	字串
subscriptionId	Azure 訂用帳戶標識碼。	字串
workspaceName	Azure Machine Learning 工作區的名稱。	字串

AutoPauseProperties

名字	描述	價值
delayInMinutes		int
啟用		bool

AutoScaleProperties

名字	描述	價值
啟用		bool
maxNodeCount		int
minNodeCount		int

VirtualMachine

名字	描述	價值
computeType	計算的類型	“VirtualMachine” （必要）
性能		VirtualMachineSchemaProperties

VirtualMachineSchemaProperties

名字	描述	價值
位址	虛擬機的公用IP位址。	字串
administratorAccount	虛擬機的管理員認證	VirtualMachineSshCredentials
isNotebookInstanceCompute	指出此計算是否將用於執行筆記本。	bool
notebookServerPort	針對SSH連線開啟的筆記本伺服器埠。	int
sshPort	針對SSH連線開啟埠。	int
virtualMachineSize	虛擬機大小	字串

Sku

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