共用方式為

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

  • 發行項

Bicep 資源定義

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

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

資源格式

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

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/computes@2022-10-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    description: 'string'
    resourceId: 'string'
    computeType: 'string'
    // For remaining properties, see Compute objects
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: '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'
    propertyBag: any(Azure.Bicep.Types.Concrete.AnyType)
    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'
    autologgerSettings: {
      mlflowAutologger: 'string'
    }
    computeInstanceAuthorizationType: 'string'
    customServices: [
      {
        docker: {
          privileged: bool
        }
        endpoints: [
          {
            hostIp: 'string'
            name: 'string'
            protocol: 'string'
            published: int
            target: int
          }
        ]
        environmentVariables: {
          {customized property}: {
            type: 'string'
            value: 'string'
          }
        }
        image: {
          reference: 'string'
          type: 'string'
        }
        name: 'string'
        volumes: [
          {
            bind: {
              createHostPath: bool
              propagation: 'string'
              selinux: 'string'
            }
            consistency: 'string'
            readOnly: bool
            source: 'string'
            target: 'string'
            tmpfs: {
              size: int
            }
            type: 'string'
            volume: {
              nocopy: bool
            }
          }
        ]
      }
    ]
    enableNodePublicIp: bool
    idleTimeBeforeShutdown: 'string'
    personalComputeInstanceSettings: {
      assignedUser: {
        objectId: 'string'
        tenantId: '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'
  }
}

針對 DataFactory，請使用：

{
  computeType: 'DataFactory'
}

針對 DataLakeAnalytics，請使用：

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

針對 Databricks，請使用：

{
  computeType: 'Databricks'
  properties: {
    databricksAccessToken: 'string'
    workspaceUrl: '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'
  }
}

屬性值

AKS

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

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 計算節點所屬的虛擬網路子網資源標識碼 字串

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

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 虛擬機大小 字串

AssignedUser

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

AutoPauseProperties

名字 描述 價值
delayInMinutes int
啟用 bool

AutoScaleProperties

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

BindOptions

名字 描述 價值
createHostPath 指出是否要建立主機路徑。 bool
增殖 系結選項的類型 字串
selinux 提及 selinux 選項。 字串

計算

名字 描述 價值
computeType 將 類型設定為 'AKS'，AKS。 針對 AmlCompute 類型設定為 'AmlCompute'，AmlCompute。 將 類型設定為 'ComputeInstance' ComputeInstance。 針對 dataFactory 類型 設定為 'DataFactory'，。 針對 dataLakeAnalytics 類型 設定為 'DataLakeAnalytics'，。 針對 Databricks 類型 設定為 'Databricks'，。 針對 HDInsight 類型設定為 『HDInsight』，。 針對 Kubernetes 類型設定為 『Kubernetes』，。 針對 synapseSpark 類型 設定為 'SynapseSpark'，。 針對 virtualMachine 類型設定為 'VirtualMachine'，。 'AKS'
'AmlCompute'
'ComputeInstance'
'Databricks'
'DataFactory'
'DataLakeAnalytics'
'HDInsight'
'Kubernetes'
'SynapseSpark'
'VirtualMachine' （必要）
描述 Machine Learning 計算的描述。 字串
resourceId 基礎計算的 ARM 資源識別碼 字串

ComputeInstance

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

ComputeInstanceAutologgerSettings

名字 描述 價值
mlflowAutologger 指出是否為筆記本啟用mlflow自動記錄器。 'Disabled'
'Enabled'

ComputeInstanceProperties

名字 描述 價值
applicationSharingPolicy 在父工作區用戶之間共用此計算實例上應用程式的原則。 如果為 Personal，則只有建立者可以存取此計算實例上的應用程式。 當共用時，任何工作區使用者都可以根據指派的角色存取此實例上的應用程式。 'Personal'
'Shared'
autologgerSettings 指定自動記錄工具的設定。 ComputeInstanceAutologgerSettings
computeInstanceAuthorizationType 計算實例授權類型。 可用的值為個人值（預設值）。 'personal'
customServices 新增至計算的自定義服務清單。 CustomService[]
enableNodePublicIp 啟用或停用節點公用IP位址布建。 可能的值為：可能的值為：true - 表示計算節點會布建公用IP。 false - 表示計算節點會有私人端點，而且沒有公用IP。 bool
idleTimeBeforeShutdown 在使用者定義閑置期間之後停止計算實例。 時間是以ISO8601格式定義。 最小值為 15 分鐘，最大值為 3 天。 字串
personalComputeInstanceSettings 個人計算實例的設定。 PersonalComputeInstanceSettings
setupScripts 用來設定叢集的自定義腳本詳細數據。 SetupScripts
sshSettings 指定 SSH 存取的原則和設定。 ComputeInstanceSshSettings
子 計算節點所屬的虛擬網路子網資源標識碼。 ResourceId
vmSize 虛擬機大小 字串

ComputeInstanceSshSettings

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

ComputeResourceTags

名字 描述 價值

CustomService

名字 描述 價值
碼頭工人 描述映像的 Docker 設定 Docker
端點 設定容器的端點 端點[]
environmentVariables 容器的環境變數 CustomServiceEnvironmentVariables
圖像 描述映像規格 圖像
名字 自訂服務的名稱 字串
卷 設定容器的磁碟區 VolumeDefinition[]

CustomServiceEnvironmentVariables

名字 描述 價值

Databricks

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

DatabricksProperties

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

DataFactory

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

DataLakeAnalytics

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

DataLakeAnalyticsSchemaProperties

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

碼頭工人

名字 描述 價值
特權 指出容器應以特殊許可權或非特殊許可權模式執行。 bool

端點

名字 描述 價值
hostIp 從容器公開應用程式的主機IP 字串
名字 端點的名稱 字串
協定 透過此端點進行通訊的通訊協定 'http'
'tcp'
'udp'
發表 從容器公開應用程式的埠。 int
目標 容器內的應用程式埠。 int

EnvironmentVariable

名字 描述 價值
類型 環境變數的類型。 可能的值為：local - 針對局部變數 'local'
價值 環境變數的值 字串

HDInsight

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

HDInsightProperties

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

圖像

名字 描述 價值
參考 影像參考 URL 字串
類型 影像的類型。 可能的值為：docker - 針對 Docker 映射。 azureml - 適用於 AzureML 映射 'azureml'
'docker'

InstanceResourceSchema

名字 描述 價值

InstanceResourceSchema

名字 描述 價值

InstanceTypeSchema

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

InstanceTypeSchemaNodeSelector

名字 描述 價值

InstanceTypeSchemaResources

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

Kubernetes

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

KubernetesProperties

名字 描述 價值
defaultInstanceType 默認實例類型 字串
extensionInstanceReleaseTrain 擴充實例發行定型。 字串
extensionPrincipalId 擴充主體標識碼。 字串
instanceTypes 實例類型架構 KubernetesPropertiesInstanceTypes
namespace 計算命名空間 字串
relayConnectionString 轉寄連接字串。 字串

約束：
敏感性值。 以安全參數的形式傳入。
serviceBusConnectionString ServiceBus 連接字串。 字串

約束：
敏感性值。 以安全參數的形式傳入。
vcName VC 名稱。 字串

KubernetesPropertiesInstanceTypes

名字 描述 價值

ManagedServiceIdentity

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

Microsoft.MachineLearningServices/workspaces/computes

名字 描述 價值
身份 資源的身分識別。 ManagedServiceIdentity
位置 指定資源的位置。 字串
名字 資源名稱 字串 （必要）
父母 在 Bicep 中，您可以指定子資源的父資源。 只有在父資源外部宣告子資源時，才需要新增這個屬性。

如需詳細資訊，請參閱 父資源外部的子資源。		 類型的資源符號名稱：工作區
性能 計算屬性 計算
sku 工作區的 SKU。 Sku
標籤 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤

PersonalComputeInstanceSettings

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

ResourceId

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

ScaleSettings

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

ScriptReference

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

ScriptsToExecute

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

SetupScripts

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

Sku

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

SslConfiguration

名字 描述 價值
證書 憑證數據 字串

約束：
敏感性值。 以安全參數的形式傳入。
cname 憑證的 CNAME 字串
鑰匙 索引鍵數據 字串

約束：
敏感性值。 以安全參數的形式傳入。
leafDomainLabel 公用端點的分葉網域標籤 字串
overwriteExistingDomain 指出是否要覆寫現有的網域卷標。 bool
地位 啟用或停用 SSL 以進行評分 'Auto'
'Disabled'
'Enabled'

SynapseSpark

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

SynapseSparkProperties

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

TmpfsOptions

名字 描述 價值
大小 提及 Tmpfs 大小 int

UserAccountCredentials

名字 描述 價值
adminUserName 可用來透過 SSH 連線到節點的系統管理員用戶帳戶名稱。 字串 （必要）
adminUserPassword 系統管理員用戶帳戶的密碼。 字串

約束：
敏感性值。 以安全參數的形式傳入。
adminUserSshPublicKey 系統管理員用戶帳戶的 SSH 公鑰。 字串

約束：
敏感性值。 以安全參數的形式傳入。

UserAssignedIdentities

名字 描述 價值

UserAssignedIdentity

名字 描述 價值

VirtualMachine

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

VirtualMachineImage

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

VirtualMachineSchemaProperties

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

VirtualMachineSshCredentials

名字 描述 價值
密碼 系統管理員帳戶的密碼 字串
privateKeyData 私鑰資料 字串

約束：
敏感性值。 以安全參數的形式傳入。
publicKeyData 公鑰資料 字串

約束：
敏感性值。 以安全參數的形式傳入。
username 系統管理員帳戶的用戶名稱 字串

VolumeDefinition

名字 描述 價值
捆 掛接的系結選項 BindOptions
一致性 磁碟區的一致性 字串
readOnly 指出是否要將磁碟區掛接為 readOnly。 默認值為 false。 bool
源 掛接的來源。 對於系結掛接，這是主機路徑。 字串
目標 掛接的目標。 對於系結掛接，這是容器中的路徑。 字串
tmpfs 掛接的 tmpfs 選項 TmpfsOptions
類型 磁碟區定義的類型。 可能的值：bind、volume、tmpfs、npipe 'bind'
'npipe'
'tmpfs'
'volume'
卷 掛接的磁碟區選項 VolumeOptions

VolumeOptions

名字 描述 價值
nocopy 指出磁碟區是否為 nocopy bool

快速入門範例

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

Bicep 檔案 描述
Azure Machine Learning 端對端安全設定 這組 Bicep 範本示範如何在安全設定中設定 Azure Machine Learning 端對端。 此參考實作包括工作區、計算叢集、計算實例和附加的私人 AKS 叢集。
Azure Machine Learning 端對端安全設定 （舊版） 這組 Bicep 範本示範如何在安全設定中設定 Azure Machine Learning 端對端。 此參考實作包括工作區、計算叢集、計算實例和附加的私人 AKS 叢集。
建立具有私人IP位址的 AKS 計算目標 此範本會在具有私人IP位址的指定 Azure Machine Learning 服務工作區中建立 AKS 計算目標。

ARM 樣本資源定義

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

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

資源格式

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

{
  "type": "Microsoft.MachineLearningServices/workspaces/computes",
  "apiVersion": "2022-10-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "description": "string",
    "resourceId": "string",
    "computeType": "string"
    // For remaining properties, see Compute objects
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "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",
    "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",
    "autologgerSettings": {
      "mlflowAutologger": "string"
    },
    "computeInstanceAuthorizationType": "string",
    "customServices": [
      {
        "docker": {
          "privileged": "bool"
        },
        "endpoints": [
          {
            "hostIp": "string",
            "name": "string",
            "protocol": "string",
            "published": "int",
            "target": "int"
          }
        ],
        "environmentVariables": {
          "{customized property}": {
            "type": "string",
            "value": "string"
          }
        },
        "image": {
          "reference": "string",
          "type": "string"
        },
        "name": "string",
        "volumes": [
          {
            "bind": {
              "createHostPath": "bool",
              "propagation": "string",
              "selinux": "string"
            },
            "consistency": "string",
            "readOnly": "bool",
            "source": "string",
            "target": "string",
            "tmpfs": {
              "size": "int"
            },
            "type": "string",
            "volume": {
              "nocopy": "bool"
            }
          }
        ]
      }
    ],
    "enableNodePublicIp": "bool",
    "idleTimeBeforeShutdown": "string",
    "personalComputeInstanceSettings": {
      "assignedUser": {
        "objectId": "string",
        "tenantId": "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"
  }
}

針對 DataFactory，請使用：

{
  "computeType": "DataFactory"
}

針對 DataLakeAnalytics，請使用：

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

針對 Databricks，請使用：

{
  "computeType": "Databricks",
  "properties": {
    "databricksAccessToken": "string",
    "workspaceUrl": "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"
  }
}

屬性值

AKS

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

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 計算節點所屬的虛擬網路子網資源標識碼 字串

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

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 虛擬機大小 字串

AssignedUser

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

AutoPauseProperties

名字 描述 價值
delayInMinutes int
啟用 bool

AutoScaleProperties

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

BindOptions

名字 描述 價值
createHostPath 指出是否要建立主機路徑。 bool
增殖 系結選項的類型 字串
selinux 提及 selinux 選項。 字串

計算

名字 描述 價值
computeType 將 類型設定為 'AKS'，AKS。 針對 AmlCompute 類型設定為 'AmlCompute'，AmlCompute。 將 類型設定為 'ComputeInstance' ComputeInstance。 針對 dataFactory 類型 設定為 'DataFactory'，。 針對 dataLakeAnalytics 類型 設定為 'DataLakeAnalytics'，。 針對 Databricks 類型 設定為 'Databricks'，。 針對 HDInsight 類型設定為 『HDInsight』，。 針對 Kubernetes 類型設定為 『Kubernetes』，。 針對 synapseSpark 類型 設定為 'SynapseSpark'，。 針對 virtualMachine 類型設定為 'VirtualMachine'，。 'AKS'
'AmlCompute'
'ComputeInstance'
'Databricks'
'DataFactory'
'DataLakeAnalytics'
'HDInsight'
'Kubernetes'
'SynapseSpark'
'VirtualMachine' （必要）
描述 Machine Learning 計算的描述。 字串
resourceId 基礎計算的 ARM 資源識別碼 字串

ComputeInstance

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

ComputeInstanceAutologgerSettings

名字 描述 價值
mlflowAutologger 指出是否為筆記本啟用mlflow自動記錄器。 'Disabled'
'Enabled'

ComputeInstanceProperties

名字 描述 價值
applicationSharingPolicy 在父工作區用戶之間共用此計算實例上應用程式的原則。 如果為 Personal，則只有建立者可以存取此計算實例上的應用程式。 當共用時，任何工作區使用者都可以根據指派的角色存取此實例上的應用程式。 'Personal'
'Shared'
autologgerSettings 指定自動記錄工具的設定。 ComputeInstanceAutologgerSettings
computeInstanceAuthorizationType 計算實例授權類型。 可用的值為個人值（預設值）。 'personal'
customServices 新增至計算的自定義服務清單。 CustomService[]
enableNodePublicIp 啟用或停用節點公用IP位址布建。 可能的值為：可能的值為：true - 表示計算節點會布建公用IP。 false - 表示計算節點會有私人端點，而且沒有公用IP。 bool
idleTimeBeforeShutdown 在使用者定義閑置期間之後停止計算實例。 時間是以ISO8601格式定義。 最小值為 15 分鐘，最大值為 3 天。 字串
personalComputeInstanceSettings 個人計算實例的設定。 PersonalComputeInstanceSettings
setupScripts 用來設定叢集的自定義腳本詳細數據。 SetupScripts
sshSettings 指定 SSH 存取的原則和設定。 ComputeInstanceSshSettings
子 計算節點所屬的虛擬網路子網資源標識碼。 ResourceId
vmSize 虛擬機大小 字串

ComputeInstanceSshSettings

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

ComputeResourceTags

名字 描述 價值

CustomService

名字 描述 價值
碼頭工人 描述映像的 Docker 設定 Docker
端點 設定容器的端點 端點[]
environmentVariables 容器的環境變數 CustomServiceEnvironmentVariables
圖像 描述映像規格 圖像
名字 自訂服務的名稱 字串
卷 設定容器的磁碟區 VolumeDefinition[]

CustomServiceEnvironmentVariables

名字 描述 價值

Databricks

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

DatabricksProperties

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

DataFactory

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

DataLakeAnalytics

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

DataLakeAnalyticsSchemaProperties

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

碼頭工人

名字 描述 價值
特權 指出容器應以特殊許可權或非特殊許可權模式執行。 bool

端點

名字 描述 價值
hostIp 從容器公開應用程式的主機IP 字串
名字 端點的名稱 字串
協定 透過此端點進行通訊的通訊協定 'http'
'tcp'
'udp'
發表 從容器公開應用程式的埠。 int
目標 容器內的應用程式埠。 int

EnvironmentVariable

名字 描述 價值
類型 環境變數的類型。 可能的值為：local - 針對局部變數 'local'
價值 環境變數的值 字串

HDInsight

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

HDInsightProperties

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

圖像

名字 描述 價值
參考 影像參考 URL 字串
類型 影像的類型。 可能的值為：docker - 針對 Docker 映射。 azureml - 適用於 AzureML 映射 'azureml'
'docker'

InstanceResourceSchema

名字 描述 價值

InstanceResourceSchema

名字 描述 價值

InstanceTypeSchema

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

InstanceTypeSchemaNodeSelector

名字 描述 價值

InstanceTypeSchemaResources

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

Kubernetes

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

KubernetesProperties

名字 描述 價值
defaultInstanceType 默認實例類型 字串
extensionInstanceReleaseTrain 擴充實例發行定型。 字串
extensionPrincipalId 擴充主體標識碼。 字串
instanceTypes 實例類型架構 KubernetesPropertiesInstanceTypes
namespace 計算命名空間 字串
relayConnectionString 轉寄連接字串。 字串

約束：
敏感性值。 以安全參數的形式傳入。
serviceBusConnectionString ServiceBus 連接字串。 字串

約束：
敏感性值。 以安全參數的形式傳入。
vcName VC 名稱。 字串

KubernetesPropertiesInstanceTypes

名字 描述 價值

ManagedServiceIdentity

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

Microsoft.MachineLearningServices/workspaces/computes

名字 描述 價值
apiVersion API 版本 '2022-10-01-preview'
身份 資源的身分識別。 ManagedServiceIdentity
位置 指定資源的位置。 字串
名字 資源名稱 字串 （必要）
性能 計算屬性 計算
sku 工作區的 SKU。 Sku
標籤 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤
類型 資源類型 'Microsoft.MachineLearningServices/workspaces/computes'

PersonalComputeInstanceSettings

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

ResourceId

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

ScaleSettings

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

ScriptReference

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

ScriptsToExecute

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

SetupScripts

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

Sku

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

SslConfiguration

名字 描述 價值
證書 憑證數據 字串

約束：
敏感性值。 以安全參數的形式傳入。
cname 憑證的 CNAME 字串
鑰匙 索引鍵數據 字串

約束：
敏感性值。 以安全參數的形式傳入。
leafDomainLabel 公用端點的分葉網域標籤 字串
overwriteExistingDomain 指出是否要覆寫現有的網域卷標。 bool
地位 啟用或停用 SSL 以進行評分 'Auto'
'Disabled'
'Enabled'

SynapseSpark

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

SynapseSparkProperties

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

TmpfsOptions

名字 描述 價值
大小 提及 Tmpfs 大小 int

UserAccountCredentials

名字 描述 價值
adminUserName 可用來透過 SSH 連線到節點的系統管理員用戶帳戶名稱。 字串 （必要）
adminUserPassword 系統管理員用戶帳戶的密碼。 字串

約束：
敏感性值。 以安全參數的形式傳入。
adminUserSshPublicKey 系統管理員用戶帳戶的 SSH 公鑰。 字串

約束：
敏感性值。 以安全參數的形式傳入。

UserAssignedIdentities

名字 描述 價值

UserAssignedIdentity

名字 描述 價值

VirtualMachine

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

VirtualMachineImage

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

VirtualMachineSchemaProperties

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

VirtualMachineSshCredentials

名字 描述 價值
密碼 系統管理員帳戶的密碼 字串
privateKeyData 私鑰資料 字串

約束：
敏感性值。 以安全參數的形式傳入。
publicKeyData 公鑰資料 字串

約束：
敏感性值。 以安全參數的形式傳入。
username 系統管理員帳戶的用戶名稱 字串

VolumeDefinition

名字 描述 價值
捆 掛接的系結選項 BindOptions
一致性 磁碟區的一致性 字串
readOnly 指出是否要將磁碟區掛接為 readOnly。 默認值為 false。 bool
源 掛接的來源。 對於系結掛接，這是主機路徑。 字串
目標 掛接的目標。 對於系結掛接，這是容器中的路徑。 字串
tmpfs 掛接的 tmpfs 選項 TmpfsOptions
類型 磁碟區定義的類型。 可能的值：bind、volume、tmpfs、npipe 'bind'
'npipe'
'tmpfs'
'volume'
卷 掛接的磁碟區選項 VolumeOptions

VolumeOptions

名字 描述 價值
nocopy 指出磁碟區是否為 nocopy bool

快速入門範本

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

範本 描述
Azure Machine Learning 端對端安全設定

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

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

部署至 Azure 		此範本會在現有的 Azure Machine Learning 工作區中建立 LinkedService。
建立機器學習服務 ADLA 計算

部署至 Azure 		此範本會建立 Machine Learning 服務 ADLA Compute。
建立 Machine Learning 服務 Aks 計算

部署至 Azure 		此範本會建立 Machine Learning 服務 Aks Compute。
建立機器學習服務 DSVM 計算

部署至 Azure 		此範本會建立機器學習服務 DSVM 計算。
建立機器學習服務 HDInsight 叢集

部署至 Azure 		此範本會建立機器學習服務 HDInsight 叢集
建立具有私人IP位址的 AKS 計算目標

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

部署至 Azure 		此範本會建立 Azure Machine Learning aks 計算。
建立 Azure Machine Learning 計算叢集

部署至 Azure 		此範本會建立 Azure Machine Learning 計算叢集。
建立 Azure Machine Learning 計算執行個體

部署至 Azure 		此範本會代表另一位具有範例內嵌設定腳本的使用者建立 Azure Machine Learning 計算實例

Terraform （AzAPI 提供者） 資源定義

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

  • 資源群組

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

資源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/computes@2022-10-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  sku = {
    capacity = int
    family = "string"
    name = "string"
    size = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      description = "string"
      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"
    autologgerSettings = {
      mlflowAutologger = "string"
    }
    computeInstanceAuthorizationType = "string"
    customServices = [
      {
        docker = {
          privileged = bool
        }
        endpoints = [
          {
            hostIp = "string"
            name = "string"
            protocol = "string"
            published = int
            target = int
          }
        ]
        environmentVariables = {
          {customized property} = {
            type = "string"
            value = "string"
          }
        }
        image = {
          reference = "string"
          type = "string"
        }
        name = "string"
        volumes = [
          {
            bind = {
              createHostPath = bool
              propagation = "string"
              selinux = "string"
            }
            consistency = "string"
            readOnly = bool
            source = "string"
            target = "string"
            tmpfs = {
              size = int
            }
            type = "string"
            volume = {
              nocopy = bool
            }
          }
        ]
      }
    ]
    enableNodePublicIp = bool
    idleTimeBeforeShutdown = "string"
    personalComputeInstanceSettings = {
      assignedUser = {
        objectId = "string"
        tenantId = "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"
  }
}

針對 DataFactory，請使用：

{
  computeType = "DataFactory"
}

針對 DataLakeAnalytics，請使用：

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

針對 Databricks，請使用：

{
  computeType = "Databricks"
  properties = {
    databricksAccessToken = "string"
    workspaceUrl = "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"
  }
}

屬性值

AKS

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

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 計算節點所屬的虛擬網路子網資源標識碼 字串

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

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 虛擬機大小 字串

AssignedUser

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

AutoPauseProperties

名字 描述 價值
delayInMinutes int
啟用 bool

AutoScaleProperties

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

BindOptions

名字 描述 價值
createHostPath 指出是否要建立主機路徑。 bool
增殖 系結選項的類型 字串
selinux 提及 selinux 選項。 字串

計算

名字 描述 價值
computeType 將 類型設定為 'AKS'，AKS。 針對 AmlCompute 類型設定為 'AmlCompute'，AmlCompute。 將 類型設定為 'ComputeInstance' ComputeInstance。 針對 dataFactory 類型 設定為 'DataFactory'，。 針對 dataLakeAnalytics 類型 設定為 'DataLakeAnalytics'，。 針對 Databricks 類型 設定為 'Databricks'，。 針對 HDInsight 類型設定為 『HDInsight』，。 針對 Kubernetes 類型設定為 『Kubernetes』，。 針對 synapseSpark 類型 設定為 'SynapseSpark'，。 針對 virtualMachine 類型設定為 'VirtualMachine'，。 'AKS'
'AmlCompute'
'ComputeInstance'
'Databricks'
'DataFactory'
'DataLakeAnalytics'
'HDInsight'
'Kubernetes'
'SynapseSpark'
'VirtualMachine' （必要）
描述 Machine Learning 計算的描述。 字串
resourceId 基礎計算的 ARM 資源識別碼 字串

ComputeInstance

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

ComputeInstanceAutologgerSettings

名字 描述 價值
mlflowAutologger 指出是否為筆記本啟用mlflow自動記錄器。 'Disabled'
'Enabled'

ComputeInstanceProperties

名字 描述 價值
applicationSharingPolicy 在父工作區用戶之間共用此計算實例上應用程式的原則。 如果為 Personal，則只有建立者可以存取此計算實例上的應用程式。 當共用時，任何工作區使用者都可以根據指派的角色存取此實例上的應用程式。 'Personal'
'Shared'
autologgerSettings 指定自動記錄工具的設定。 ComputeInstanceAutologgerSettings
computeInstanceAuthorizationType 計算實例授權類型。 可用的值為個人值（預設值）。 'personal'
customServices 新增至計算的自定義服務清單。 CustomService[]
enableNodePublicIp 啟用或停用節點公用IP位址布建。 可能的值為：可能的值為：true - 表示計算節點會布建公用IP。 false - 表示計算節點會有私人端點，而且沒有公用IP。 bool
idleTimeBeforeShutdown 在使用者定義閑置期間之後停止計算實例。 時間是以ISO8601格式定義。 最小值為 15 分鐘，最大值為 3 天。 字串
personalComputeInstanceSettings 個人計算實例的設定。 PersonalComputeInstanceSettings
setupScripts 用來設定叢集的自定義腳本詳細數據。 SetupScripts
sshSettings 指定 SSH 存取的原則和設定。 ComputeInstanceSshSettings
子 計算節點所屬的虛擬網路子網資源標識碼。 ResourceId
vmSize 虛擬機大小 字串

ComputeInstanceSshSettings

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

ComputeResourceTags

名字 描述 價值

CustomService

名字 描述 價值
碼頭工人 描述映像的 Docker 設定 Docker
端點 設定容器的端點 端點[]
environmentVariables 容器的環境變數 CustomServiceEnvironmentVariables
圖像 描述映像規格 圖像
名字 自訂服務的名稱 字串
卷 設定容器的磁碟區 VolumeDefinition[]

CustomServiceEnvironmentVariables

名字 描述 價值

Databricks

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

DatabricksProperties

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

DataFactory

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

DataLakeAnalytics

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

DataLakeAnalyticsSchemaProperties

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

碼頭工人

名字 描述 價值
特權 指出容器應以特殊許可權或非特殊許可權模式執行。 bool

端點

名字 描述 價值
hostIp 從容器公開應用程式的主機IP 字串
名字 端點的名稱 字串
協定 透過此端點進行通訊的通訊協定 'http'
'tcp'
'udp'
發表 從容器公開應用程式的埠。 int
目標 容器內的應用程式埠。 int

EnvironmentVariable

名字 描述 價值
類型 環境變數的類型。 可能的值為：local - 針對局部變數 'local'
價值 環境變數的值 字串

HDInsight

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

HDInsightProperties

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

圖像

名字 描述 價值
參考 影像參考 URL 字串
類型 影像的類型。 可能的值為：docker - 針對 Docker 映射。 azureml - 適用於 AzureML 映射 'azureml'
'docker'

InstanceResourceSchema

名字 描述 價值

InstanceResourceSchema

名字 描述 價值

InstanceTypeSchema

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

InstanceTypeSchemaNodeSelector

名字 描述 價值

InstanceTypeSchemaResources

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

Kubernetes

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

KubernetesProperties

名字 描述 價值
defaultInstanceType 默認實例類型 字串
extensionInstanceReleaseTrain 擴充實例發行定型。 字串
extensionPrincipalId 擴充主體標識碼。 字串
instanceTypes 實例類型架構 KubernetesPropertiesInstanceTypes
namespace 計算命名空間 字串
relayConnectionString 轉寄連接字串。 字串

約束：
敏感性值。 以安全參數的形式傳入。
serviceBusConnectionString ServiceBus 連接字串。 字串

約束：
敏感性值。 以安全參數的形式傳入。
vcName VC 名稱。 字串

KubernetesPropertiesInstanceTypes

名字 描述 價值

ManagedServiceIdentity

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

Microsoft.MachineLearningServices/workspaces/computes

名字 描述 價值
身份 資源的身分識別。 ManagedServiceIdentity
位置 指定資源的位置。 字串
名字 資源名稱 字串 （必要）
parent_id 此資源為父系之資源的標識碼。 類型資源的標識碼：工作區
性能 計算屬性 計算
sku 工作區的 SKU。 Sku
標籤 資源標籤 標記名稱和值的字典。
類型 資源類型 “Microsoft.MachineLearningServices/workspaces/computes@2022-10-01-preview”

PersonalComputeInstanceSettings

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

ResourceId

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

ScaleSettings

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

ScriptReference

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

ScriptsToExecute

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

SetupScripts

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

Sku

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

SslConfiguration

名字 描述 價值
證書 憑證數據 字串

約束：
敏感性值。 以安全參數的形式傳入。
cname 憑證的 CNAME 字串
鑰匙 索引鍵數據 字串

約束：
敏感性值。 以安全參數的形式傳入。
leafDomainLabel 公用端點的分葉網域標籤 字串
overwriteExistingDomain 指出是否要覆寫現有的網域卷標。 bool
地位 啟用或停用 SSL 以進行評分 'Auto'
'Disabled'
'Enabled'

SynapseSpark

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

SynapseSparkProperties

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

TmpfsOptions

名字 描述 價值
大小 提及 Tmpfs 大小 int

UserAccountCredentials

名字 描述 價值
adminUserName 可用來透過 SSH 連線到節點的系統管理員用戶帳戶名稱。 字串 （必要）
adminUserPassword 系統管理員用戶帳戶的密碼。 字串

約束：
敏感性值。 以安全參數的形式傳入。
adminUserSshPublicKey 系統管理員用戶帳戶的 SSH 公鑰。 字串

約束：
敏感性值。 以安全參數的形式傳入。

UserAssignedIdentities

名字 描述 價值

UserAssignedIdentity

名字 描述 價值

VirtualMachine

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

VirtualMachineImage

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

VirtualMachineSchemaProperties

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

VirtualMachineSshCredentials

名字 描述 價值
密碼 系統管理員帳戶的密碼 字串
privateKeyData 私鑰資料 字串

約束：
敏感性值。 以安全參數的形式傳入。
publicKeyData 公鑰資料 字串

約束：
敏感性值。 以安全參數的形式傳入。
username 系統管理員帳戶的用戶名稱 字串

VolumeDefinition

名字 描述 價值
捆 掛接的系結選項 BindOptions
一致性 磁碟區的一致性 字串
readOnly 指出是否要將磁碟區掛接為 readOnly。 默認值為 false。 bool
源 掛接的來源。 對於系結掛接，這是主機路徑。 字串
目標 掛接的目標。 對於系結掛接，這是容器中的路徑。 字串
tmpfs 掛接的 tmpfs 選項 TmpfsOptions
類型 磁碟區定義的類型。 可能的值：bind、volume、tmpfs、npipe 'bind'
'npipe'
'tmpfs'
'volume'
卷 掛接的磁碟區選項 VolumeOptions

VolumeOptions

名字 描述 價值
nocopy 指出磁碟區是否為 nocopy bool