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

• 最新
• 2024-10-01
• 2024-10-01-preview
• 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-06-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    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'
  }
  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'
    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 計算的描述。	字串
disableLocalAuth	退出宣告本機驗證，並確保客戶只能只使用 MSI 和 AAD 進行驗證。	bool
resourceId	基礎計算的 ARM 資源識別碼	字串

ComputeInstance

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

ComputeInstanceProperties

名字	描述	價值
applicationSharingPolicy	在父工作區用戶之間共用此計算實例上應用程式的原則。 如果為 Personal，則只有建立者可以存取此計算實例上的應用程式。 當共用時，任何工作區使用者都可以根據指派的角色存取此實例上的應用程式。	'Personal' 'Shared'
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-06-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "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"
  },
  "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",
    "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 計算的描述。	字串
disableLocalAuth	退出宣告本機驗證，並確保客戶只能只使用 MSI 和 AAD 進行驗證。	bool
resourceId	基礎計算的 ARM 資源識別碼	字串

ComputeInstance

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

ComputeInstanceProperties

名字	描述	價值
applicationSharingPolicy	在父工作區用戶之間共用此計算實例上應用程式的原則。 如果為 Personal，則只有建立者可以存取此計算實例上的應用程式。 當共用時，任何工作區使用者都可以根據指派的角色存取此實例上的應用程式。	'Personal' 'Shared'
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-06-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 端對端安全設定	這組 Bicep 範本示範如何在安全設定中設定 Azure Machine Learning 端對端。 此參考實作包括工作區、計算叢集、計算實例和附加的私人 AKS 叢集。
Azure Machine Learning 端對端安全設定 （舊版）	這組 Bicep 範本示範如何在安全設定中設定 Azure Machine Learning 端對端。 此參考實作包括工作區、計算叢集、計算實例和附加的私人 AKS 叢集。
在 Azure Machine Learning 工作區中建立 LinkedService	此範本會在現有的 Azure Machine Learning 工作區中建立 LinkedService。
建立機器學習服務 ADLA 計算	此範本會建立 Machine Learning 服務 ADLA Compute。
建立 Machine Learning 服務 Aks 計算	此範本會建立 Machine Learning 服務 Aks Compute。
建立機器學習服務 DSVM 計算	此範本會建立機器學習服務 DSVM 計算。
建立機器學習服務 HDInsight 叢集	此範本會建立機器學習服務 HDInsight 叢集
建立具有私人IP位址的 AKS 計算目標	此範本會在具有私人IP位址的指定 Azure Machine Learning 服務工作區中建立 AKS 計算目標。
建立 Azure Machine Learning aks 計算	此範本會建立 Azure Machine Learning aks 計算。
建立 Azure Machine Learning 計算叢集	此範本會建立 Azure Machine Learning 計算叢集。
建立 Azure Machine Learning 計算執行個體	此範本會代表另一位具有範例內嵌設定腳本的使用者建立 Azure Machine Learning 計算實例

Terraform （AzAPI 提供者） 資源定義

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

• 資源群組

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

資源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/computes@2022-06-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  body = jsonencode({
    properties = {
      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"
  }
  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"
    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 計算的描述。	字串
disableLocalAuth	退出宣告本機驗證，並確保客戶只能只使用 MSI 和 AAD 進行驗證。	bool
resourceId	基礎計算的 ARM 資源識別碼	字串

ComputeInstance

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

ComputeInstanceProperties

名字	描述	價值
applicationSharingPolicy	在父工作區用戶之間共用此計算實例上應用程式的原則。 如果為 Personal，則只有建立者可以存取此計算實例上的應用程式。 當共用時，任何工作區使用者都可以根據指派的角色存取此實例上的應用程式。	'Personal' 'Shared'
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-06-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