你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Microsoft.MachineLearningServices workspaces/computes 2022-06-01-preview

Bicep 资源定义

工作区/计算资源类型可以使用目标操作进行部署:

有关每个 API 版本中更改的属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.MachineLearningServices/workspaces/computes 资源,请将以下 Bicep 添加到模板。

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

计算对象

设置 computeType 属性以指定对象的类型。

对于 AKS,请使用:

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

对于 AmlCompute,请使用:

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

对于 ComputeInstance,请使用:

  computeType: 'ComputeInstance'
  properties: {
    applicationSharingPolicy: 'string'
    computeInstanceAuthorizationType: 'personal'
    customServices: [
      {
        docker: {
          privileged: bool
          {customized property}: any()
        }
        endpoints: [
          {
            hostIp: 'string'
            name: 'string'
            protocol: 'string'
            published: int
            target: int
          }
        ]
        environmentVariables: {
          {customized property}: {
            type: 'local'
            value: 'string'
            {customized property}: any()
          }
        }
        image: {
          reference: 'string'
          type: 'string'
          {customized property}: any()
        }
        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
            }
          }
        ]
        {customized property}: any()
      }
    ]
    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'
  }

对于 Databricks,请使用:

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

对于 DataFactory,请使用:

  computeType: 'DataFactory'

对于 DataLakeAnalytics,请使用:

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

对于 HDInsight,请使用:

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

对于 Kubernetes,请使用:

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

对于 SynapseSpark,请使用:

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

对于 VirtualMachine,请使用:

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

属性值

workspaces/computes

名称 说明
name 资源名称

了解如何在 Bicep 中为子资源设置名称和类型。
字符串 (必需)

计算实例的字符限制:3-24
3-32 用于 AML 计算
2-16 用于其他计算类型

有效字符:
字母数字和连字符。
location 指定资源的位置。 字符串
标记 包含定义为键/值对的资源标记。 标记名称和值的字典。 请参阅 模板中的标记
sku 工作区的 SKU。 Sku
父级 (parent) 在 Bicep 中,可以为子资源指定父资源。 仅当子资源在父资源外部声明时,才需要添加此属性。

有关详细信息,请参阅 父资源之外的子资源
类型为资源的符号名称: 工作区
标识 资源的标识。 ManagedServiceIdentity
properties 计算属性 计算

ManagedServiceIdentity

名称 说明 Value
type 托管服务标识的类型 (其中允许 systemAssigned 和 UserAssigned 类型) 。 “None”
“SystemAssigned”
“SystemAssigned,UserAssigned”
“UserAssigned” (必需)
userAssignedIdentities 与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将是采用以下格式的 ARM 资源 ID:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是请求中) ({} 空对象。 UserAssignedIdentities

UserAssignedIdentities

名称 说明
{customized property} UserAssignedIdentity

UserAssignedIdentity

此对象不包含部署期间要设置的任何属性。 所有属性均为 ReadOnly。

计算

名称 说明
description 机器学习计算的说明。 string
disableLocalAuth 选择退出本地身份验证,并确保客户只能将 MSI 和 AAD 专用于身份验证。 bool
ResourceId 基础计算的 ARM 资源 ID 字符串
computeType 设置对象类型 AKS
AmlCompute
ComputeInstance
Databricks
DataFactory
DataLakeAnalytics
HDInsight
Kubernetes
SynapseSpark
VirtualMachine (必需)

AKS

名称 说明
computeType 计算类型 “AKS” (必需)
properties AKS 属性 AKSSchemaProperties

AKSSchemaProperties

名称 说明
agentCount 代理数 int

约束:
最小值 = 0
agentVmSize 代理虚拟机大小 字符串
aksNetworkingConfiguration vnet 的 AKS 网络配置 AksNetworkingConfiguration
clusterFqdn 群集完全限定的域名 字符串
clusterPurpose 群集的预期用途 “DenseProd”
'DevTest'
'FastProd'
loadBalancerSubnet 负载均衡器子网 string
loadBalancerType 负载均衡器类型 'InternalLoadBalancer'
'PublicIp'
sslConfiguration SSL 配置 SslConfiguration

AksNetworkingConfiguration

名称 说明
dnsServiceIP 分配给 Kubernetes DNS 服务的 IP 地址。 它必须在 serviceCidr 中指定的 Kubernetes 服务地址范围内。 字符串

约束:
模式 = ^(?:(?: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 服务地址范围重叠。 字符串

约束:
模式 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidr CIDR 表示法 IP 范围,从其中分配服务群集 IP。 此范围不得与任何子网 IP 范围重叠。 string

约束:
模式 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
subnetId 计算节点所属的虚拟网络子网资源 ID 字符串

SslConfiguration

名称 说明
cert 证书数据 字符串

约束:
敏感值。 作为安全参数传入。
cname 证书的 CNAME string
key 关键数据 string

约束:
敏感值。 作为安全参数传入。
leafDomainLabel 公共终结点的叶域标签 字符串
overwriteExistingDomain 指示是否覆盖现有域标签。 bool
status 启用或禁用用于评分的 ssl 'Auto'
'Disabled'
'Enabled'

AmlCompute

名称 说明
computeType 计算类型 需要“AmlCompute” ()
properties AmlCompute 的属性 AmlComputeProperties

AmlComputeProperties

名称 说明
enableNodePublicIp 启用或禁用节点公共 IP 地址预配。 可能的值是:可能的值是:true - 指示计算节点将预配公共 IP。 false - 指示计算节点将具有专用终结点且没有公共 IP。 bool
isolatedNetwork 网络是否隔离 bool
osType 计算 OS 类型 'Linux'
“Windows”
propertyBag 包含其他属性的属性包。 对于 Bicep,可以使用 any () 函数。
remoteLoginPortPublicAccess 公共 SSH 端口的状态。 可能的值为:Disabled - 指示群集的所有节点上的公共 ssh 端口已关闭。 已启用 - 指示群集的所有节点上的公用 ssh 端口已打开。 NotSpecified - 指示如果定义了 VNet,则群集的所有节点上的公共 ssh 端口已关闭,否则将打开所有公共节点。 它只能在创建群集时处于默认状态,在创建后,它将启用或禁用。 'Disabled'
'Enabled'
“NotSpecified”
scaleSettings AML 计算的缩放设置 ScaleSettings
子网 计算节点所属的虚拟网络子网资源 ID。 ResourceId
userAccountCredentials 将在每个计算节点上创建的管理员用户帐户的凭据。 UserAccountCredentials
virtualMachineImage AML 计算的虚拟机映像 - 仅限窗口 VirtualMachineImage
vmPriority 虚拟机优先级 “专用”
“LowPriority”
vmSize 虚拟机大小 字符串

ScaleSettings

名称 说明
maxNodeCount 要使用的最大节点数 int (必需)
minNodeCount 要使用的最小节点数 int
nodeIdleTimeBeforeScaleDown 缩减 amlCompute 之前的节点空闲时间。 此字符串需要采用 RFC 格式。 字符串

ResourceId

名称 说明 Value
id 资源的 ID 字符串 (必需)

UserAccountCredentials

名称 说明
adminUserName 可用于通过 SSH 连接到节点的管理员用户帐户的名称。 字符串 (必需)
adminUserPassword 管理员用户帐户的密码。 string

约束:
敏感值。 作为安全参数传入。
adminUserSshPublicKey 管理员用户帐户的 SSH 公钥。 string

约束:
敏感值。 作为安全参数传入。

VirtualMachineImage

名称 说明 Value
id 虚拟机映像路径 字符串 (必需)

ComputeInstance

名称 说明
computeType 计算类型 “ComputeInstance” (必需的)
properties ComputeInstance 的属性 ComputeInstanceProperties

ComputeInstanceProperties

名称 说明
applicationSharingPolicy 用于在父工作区的用户之间共享此计算实例上的应用程序的策略。 如果为“个人”,则只有创建者可以访问此计算实例上的应用程序。 共享时,任何工作区用户都可以访问此实例上的应用程序,具体取决于他/她分配的角色。 “个人”
“Shared”
computeInstanceAuthorizationType 计算实例授权类型。 可用值为个人 (默认) 。 “个人”
customServices 添加到计算的自定义服务列表。 CustomService[]
enableNodePublicIp 启用或禁用节点公共 IP 地址预配。 可能的值为:可能的值为:true - 指示计算节点将预配公共 IP。 false - 指示计算节点将具有专用终结点,并且没有公共 IP。 bool
idleTimeBeforeShutdown 在用户定义的非活动时间段后停止计算实例。 时间以ISO8601格式定义。 最小值为 15 分钟,最长为 3 天。 字符串
personalComputeInstanceSettings 个人计算实例的设置。 PersonalComputeInstanceSettings
setupScripts 要为设置群集而执行的自定义脚本的详细信息。 SetupScripts
sshSettings 指定 SSH 访问的策略和设置。 ComputeInstanceSshSettings
子网 计算节点所属的虚拟网络子网资源 ID。 ResourceId
vmSize 虚拟机大小 字符串

CustomService

名称 说明
docker 描述映像的 docker 设置 Docker
端点 配置容器的终结点 Endpoint[]
environmentVariables 容器的环境变量 CustomServiceEnvironmentVariables
image 描述映像规范 图像
name 自定义服务的名称 字符串
volumes 为容器配置卷 VolumeDefinition[]
{customized property} 对于 Bicep,可以使用 any () 函数。

Docker

名称 说明
特权 指示容器应以特权模式还是非特权模式运行。 bool
{customized property} 对于 Bicep,可以使用 any () 函数。

终结点

名称 说明
hostIp 从容器中公开应用程序的主机 IP string
name 终结点的名称 string
protocol 通过此终结点进行通信的协议 'http'
'tcp'
'udp'
published 从容器中公开应用程序的端口。 int
目标 容器中的应用程序端口。 int

CustomServiceEnvironmentVariables

名称 说明
{customized property} EnvironmentVariable

EnvironmentVariable

名称 说明 Value
type 环境变量的类型。 可能的值是:local - 对于局部变量 'local'
value 环境变量的值 字符串
{customized property} 对于 Bicep,可以使用 any () 函数。

映像

名称 说明
reference 图像引用 URL string
type 图像的类型。 可能的值为:docker - 用于 docker 映像。 azureml - 对于 AzureML 映像 'azureml'
“docker”
{customized property} 对于 Bicep,可以使用 any () 函数。

VolumeDefinition

名称 说明
bind 装载的绑定选项 BindOptions
一致性 卷的一致性 字符串
readOnly 指示是否将卷装载为 readOnly。 默认值为 false。 bool
source 装载的源。 对于绑定装载,这是主机路径。 string
目标 装载的目标。 对于绑定装载,这是容器中的路径。 字符串
Tmpfs 装载的 tmpfs 选项 TmpfsOptions
类型 卷定义的类型。 可能的值:bind、volume、tmpfs、npipe “bind”
“npipe”
“tmpfs”
“volume”
装载的卷选项 VolumeOptions

BindOptions

名称 说明
createHostPath 指示是否创建主机路径。 bool
传播 绑定选项的类型 字符串
selinux 提及 selinux 选项。 string

TmpfsOptions

名称 说明
大小 提及 Tmpfs 大小 int

VolumeOptions

名称 说明
nocopy 指示卷是否为 nocopy bool

PersonalComputeInstanceSettings

名称 说明
assignedUser 显式分配给个人计算实例的用户。 AssignedUser

AssignedUser

名称 说明
objectId 用户的 AAD 对象 ID。 字符串 (必需)
tenantId 用户的 AAD 租户 ID。 字符串 (必需)

SetupScripts

名称 说明
脚本 自定义安装脚本 ScriptsToExecute

ScriptsToExecute

名称 说明
creationScript 在预配计算期间仅运行一次的脚本。 ScriptReference
startupScript 每次计算机启动时运行的脚本。 ScriptReference

ScriptReference

名称 说明
scriptArguments 传递给要运行的脚本的可选命令行参数。 字符串
scriptData 脚本在已装载卷中的位置。 string
scriptSource 脚本的存储源:内联、工作区。 string
timeout 传递给 timeout 命令的可选时间段。 字符串

ComputeInstanceSshSettings

名称 说明
adminPublicKey 将 SSH rsa 公钥文件指定为字符串。 使用“ssh-keygen -t rsa -b 2048”生成 SSH 密钥对。 string
sshPublicAccess 公共 SSH 端口的状态。 可能的值是:Disabled - 指示此实例上的公共 ssh 端口已关闭。 已启用 - 指示公共 ssh 端口已打开,并根据 VNet/子网策略(如果适用)进行访问。 'Disabled'
'Enabled'

Databricks

名称 说明
computeType 计算类型 需要“Databricks” ()
properties Databricks 的属性 DatabricksProperties

DatabricksProperties

名称 说明
databricksAccessToken Databricks 访问令牌 字符串
workspaceUrl 工作区 URL string

DataFactory

名称 说明
computeType 计算类型 “DataFactory” (必需)

DataLakeAnalytics

名称 说明
computeType 计算类型 需要“DataLakeAnalytics” ()
properties DataLakeAnalyticsSchemaProperties

DataLakeAnalyticsSchemaProperties

名称 说明
dataLakeStoreAccountName DataLake Store 帐户名称 字符串

HDInsight

名称 说明
computeType 计算类型 需要“HDInsight” ()
properties HDInsight 计算属性 HDInsightProperties

HDInsightProperties

名称 说明
address 群集主节点的公共 IP 地址。 字符串
administratorAccount 管理员群集主节点的凭据 VirtualMachineSshCredentials
sshPort 为群集主节点上的 ssh 连接打开端口。 int

VirtualMachineSshCredentials

名称 说明
password 管理员帐户的密码 字符串
privateKeyData 私钥数据 字符串

约束:
敏感值。 作为安全参数传入。
publicKeyData 公钥数据 字符串

约束:
敏感值。 作为安全参数传入。
username 管理员帐户的用户名 字符串

Kubernetes

名称 说明
computeType 计算类型 “Kubernetes” (必需)
properties Kubernetes 的属性 KubernetesProperties

KubernetesProperties

名称 说明
defaultInstanceType 默认实例类型 字符串
extensionInstanceReleaseTrain 扩展实例发布训练。 string
extensionPrincipalId 扩展主体 id。 字符串
instanceTypes 实例类型架构 KubernetesPropertiesInstanceTypes
命名空间 计算命名空间 string
relayConnectionString 中继连接字符串。 字符串

约束:
敏感值。 作为安全参数传入。
serviceBusConnectionString ServiceBus 连接字符串。 string

约束:
敏感值。 作为安全参数传入。
vcName VC 名称。 字符串

KubernetesPropertiesInstanceTypes

名称 说明
{customized property} InstanceTypeSchema

InstanceTypeSchema

名称 说明
nodeSelector 节点选择器 InstanceTypeSchemaNodeSelector
resources 此实例类型的资源请求/限制 InstanceTypeSchemaResources

InstanceTypeSchemaNodeSelector

名称 说明
{customized property} 字符串

InstanceTypeSchemaResources

名称 说明
限制 此实例类型的资源限制 InstanceResourceSchema
请求 此实例类型的资源请求 InstanceResourceSchema

InstanceResourceSchema

名称 说明
{customized property} string
{customized property} string

SynapseSpark

名称 说明
computeType 计算类型 “SynapseSpark” (必需)
properties SynapseSparkProperties

SynapseSparkProperties

名称 说明
autoPauseProperties 自动暂停属性。 AutoPauseProperties
autoScaleProperties 自动缩放属性。 AutoScaleProperties
nodeCount 当前分配给计算的计算节点数。 int
nodeSize 节点大小。 string
nodeSizeFamily 节点大小系列。 字符串
poolName 池名称。 字符串
resourceGroup 工作区所在的资源组的名称。 字符串
sparkVersion Spark 版本。 string
subscriptionId Azure 订阅标识符。 字符串
workspaceName Azure 机器学习工作区的名称。 string

AutoPauseProperties

名称 说明
delayInMinutes int
enabled bool

AutoScaleProperties

名称 说明
enabled bool
maxNodeCount int
minNodeCount int

VirtualMachine

名称 说明
computeType 计算类型 “VirtualMachine” (必需)
properties VirtualMachineSchemaProperties

VirtualMachineSchemaProperties

名称 说明
address 虚拟机的公共 IP 地址。 字符串
administratorAccount 为虚拟机管理员凭据 VirtualMachineSshCredentials
isNotebookInstanceCompute 指示此计算是否将用于运行笔记本。 bool
notebookServerPort 为 SSH 连接打开笔记本服务器端口。 int
sshPort 为 SSH 连接打开端口。 int
virtualMachineSize 虚拟机大小 字符串

SKU

名称 说明
容量 如果 SKU 支持横向扩展/缩减,则应包含容量整数。 如果资源无法横向扩展/缩减,则可能会省略这一点。 int
family 如果服务具有不同代系的硬件(对于同一 SKU),则可以在此处进行捕获。 字符串
name SKU 的名称。 例如 - P3。 它通常是字母+数字代码 字符串 (必需)
大小 SKU 大小。 当名称字段是层和其他某个值的组合时,这将是独立代码。 字符串
如果服务具有多个层,但 PUT 上不需要此字段,则资源提供程序必须实现此字段。 “Basic”
“免费”
“Premium”
“Standard”

快速入门模板

以下快速入门模板部署此资源类型。

模板 说明
创建机器学习服务 ADLA 计算

部署到 Azure
此模板创建机器学习服务 ADLA 计算。
创建机器学习服务 Aks 计算

部署到 Azure
此模板创建机器学习服务 Aks 计算。
创建机器学习服务 DSVM 计算

部署到 Azure
此模板创建机器学习服务 DSVM 计算。
创建机器学习服务 HDInsight 群集

部署到 Azure
此模板创建机器学习服务 HDInsight 群集
创建 Azure 机器学习 aks 计算

部署到 Azure
此模板创建 Azure 机器学习 aks 计算。
创建 Azure 机器学习计算群集

部署到 Azure
此模板创建 Azure 机器学习计算群集。
创建 Azure 机器学习计算实例

部署到 Azure
此模板代表其他用户使用示例内联安装脚本创建 Azure 机器学习计算实例
在 Azure 机器学习工作区中创建 LinkedService

部署到 Azure
此模板在现有的 Azure 机器学习工作区中创建 LinkedService。
使用专用 IP 地址创建 AKS 计算目标

部署到 Azure
此模板使用专用 IP 地址在给定的 Azure 机器学习服务工作区中创建 AKS 计算目标。

ARM 模板资源定义

工作区/计算资源类型可以使用目标操作进行部署:

有关每个 API 版本中更改的属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.MachineLearningServices/workspaces/computes 资源,请将以下 JSON 添加到模板。

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

计算对象

设置 computeType 属性以指定对象的类型。

对于 AKS,请使用:

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

对于 AmlCompute,请使用:

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

对于 ComputeInstance,请使用:

  "computeType": "ComputeInstance",
  "properties": {
    "applicationSharingPolicy": "string",
    "computeInstanceAuthorizationType": "personal",
    "customServices": [
      {
        "docker": {
          "privileged": "bool",
          "{customized property}": {}
        },
        "endpoints": [
          {
            "hostIp": "string",
            "name": "string",
            "protocol": "string",
            "published": "int",
            "target": "int"
          }
        ],
        "environmentVariables": {
          "{customized property}": {
            "type": "local",
            "value": "string",
            "{customized property}": {}
          }
        },
        "image": {
          "reference": "string",
          "type": "string",
          "{customized property}": {}
        },
        "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"
            }
          }
        ],
        "{customized property}": {}
      }
    ],
    "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"
  }

对于 Databricks,请使用:

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

对于 DataFactory,请使用:

  "computeType": "DataFactory"

对于 DataLakeAnalytics,请使用:

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

对于 HDInsight,请使用:

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

对于 Kubernetes,请使用:

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

对于 SynapseSpark,请使用:

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

对于 VirtualMachine,请使用:

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

属性值

workspaces/computes

名称 说明 Value
type 资源类型 “Microsoft.MachineLearningServices/workspaces/computes”
apiVersion 资源 API 版本 “2022-06-01-preview”
name 资源名称

了解如何在 JSON ARM 模板中为子资源设置名称和类型。
字符串 (必需)

计算实例的字符限制:3-24
3-32 用于 AML 计算
2-16 用于其他计算类型

有效字符:
字母数字和连字符。
location 指定资源的位置。 字符串
标记 包含定义为键/值对的资源标记。 标记名称和值的字典。 请参阅 模板中的标记
sku 工作区的 SKU。 Sku
标识 资源的标识。 ManagedServiceIdentity
properties 计算属性 计算

ManagedServiceIdentity

名称 说明 Value
type 托管服务标识的类型 (其中允许 systemAssigned 和 UserAssigned 类型) 。 “None”
“SystemAssigned”
“SystemAssigned,UserAssigned”
“UserAssigned” (必需)
userAssignedIdentities 与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将是采用以下格式的 ARM 资源 ID:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是请求中 ({}) 的空对象。 UserAssignedIdentities

UserAssignedIdentities

名称 说明
{customized property} UserAssignedIdentity

UserAssignedIdentity

此对象不包含部署期间要设置的任何属性。 所有属性均为 ReadOnly。

计算

名称 说明
description 机器学习计算的说明。 字符串
disableLocalAuth 选择退出本地身份验证,并确保客户只能将 MSI 和 AAD 专用于身份验证。 bool
ResourceId 基础计算的 ARM 资源 ID string
computeType 设置对象类型 AKS
AmlCompute
ComputeInstance
Databricks
DataFactory
DataLakeAnalytics
HDInsight
Kubernetes
SynapseSpark
VirtualMachine (必需)

AKS

名称 说明
computeType 计算类型 “AKS” (必需)
properties AKS 属性 AKSSchemaProperties

AKSSchemaProperties

名称 说明
agentCount 代理数 int

约束:
最小值 = 0
agentVmSize 代理虚拟机大小 string
aksNetworkingConfiguration vnet 的 AKS 网络配置 AksNetworkingConfiguration
clusterFqdn 群集完全限定的域名 string
clusterPurpose 群集的预期用途 “DenseProd”
'DevTest'
'FastProd'
loadBalancerSubnet 负载均衡器子网 字符串
loadBalancerType 负载均衡器类型 'InternalLoadBalancer'
'PublicIp'
sslConfiguration SSL 配置 SslConfiguration

AksNetworkingConfiguration

名称 说明
dnsServiceIP 分配给 Kubernetes DNS 服务的 IP 地址。 它必须在 serviceCidr 中指定的 Kubernetes 服务地址范围内。 字符串

约束:
模式 = ^(?:(?: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 服务地址范围重叠。 string

约束:
模式 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidr CIDR 表示法 IP 范围,从其中分配服务群集 IP。 此范围不得与任何子网 IP 范围重叠。 字符串

约束:
模式 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
subnetId 计算节点所属的虚拟网络子网资源 ID string

SslConfiguration

名称 说明
cert 证书数据 string

约束:
敏感值。 作为安全参数传入。
cname 证书的 CNAME string
key 关键数据 字符串

约束:
敏感值。 作为安全参数传入。
leafDomainLabel 公共终结点的叶域标签 string
overwriteExistingDomain 指示是否覆盖现有域标签。 bool
status 启用或禁用用于评分的 ssl 'Auto'
'Disabled'
'Enabled'

AmlCompute

名称 说明
computeType 计算类型 需要“AmlCompute” ()
properties AmlCompute 的属性 AmlComputeProperties

AmlComputeProperties

名称 说明
enableNodePublicIp 启用或禁用节点公共 IP 地址预配。 可能的值是:可能的值是:true - 指示计算节点将预配公共 IP。 false - 指示计算节点将具有专用终结点且没有公共 IP。 bool
isolatedNetwork 网络是否隔离 bool
osType 计算 OS 类型 'Linux'
“Windows”
propertyBag 包含其他属性的属性包。
remoteLoginPortPublicAccess 公共 SSH 端口的状态。 可能的值为:Disabled - 指示群集的所有节点上的公共 ssh 端口已关闭。 已启用 - 指示群集的所有节点上的公用 ssh 端口已打开。 NotSpecified - 指示如果定义了 VNet,则群集的所有节点上的公共 ssh 端口已关闭,否则将打开所有公共节点。 它只能在创建群集时处于默认状态,在创建后,它将启用或禁用。 'Disabled'
'Enabled'
“NotSpecified”
scaleSettings AML 计算的缩放设置 ScaleSettings
子网 计算节点所属的虚拟网络子网资源 ID。 ResourceId
userAccountCredentials 将在每个计算节点上创建的管理员用户帐户的凭据。 UserAccountCredentials
virtualMachineImage AML 计算的虚拟机映像 - 仅限窗口 VirtualMachineImage
vmPriority 虚拟机优先级 “专用”
“LowPriority”
vmSize 虚拟机大小 字符串

ScaleSettings

名称 说明
maxNodeCount 要使用的最大节点数 int (必需)
minNodeCount 要使用的最小节点数 int
nodeIdleTimeBeforeScaleDown 纵向缩减 amlCompute 之前的节点空闲时间。 此字符串需要采用 RFC 格式。 字符串

ResourceId

名称 说明 Value
id 资源的 ID 字符串 (必需)

UserAccountCredentials

名称 说明
adminUserName 可用于通过 SSH 连接到节点的管理员用户帐户的名称。 字符串 (必需)
adminUserPassword 管理员用户帐户的密码。 字符串

约束:
敏感值。 作为安全参数传入。
adminUserSshPublicKey 管理员用户帐户的 SSH 公钥。 string

约束:
敏感值。 作为安全参数传入。

VirtualMachineImage

名称 说明 Value
id 虚拟机映像路径 字符串 (必需)

ComputeInstance

名称 说明
computeType 计算类型 “ComputeInstance” (必需)
properties ComputeInstance 的属性 ComputeInstanceProperties

ComputeInstanceProperties

名称 说明
applicationSharingPolicy 用于在父工作区的用户之间共享此计算实例上的应用程序的策略。 如果为“个人”,则只有创建者可以访问此计算实例上的应用程序。 共享后,任何工作区用户都可以访问此实例上的应用程序,具体取决于其分配的角色。 “个人”
'Shared'
computeInstanceAuthorizationType 计算实例授权类型。 可用值为个人 (默认) 。 “personal”
customServices 添加到计算中的自定义服务列表。 CustomService[]
enableNodePublicIp 启用或禁用节点公共 IP 地址预配。 可能的值是:可能的值是:true - 指示计算节点将预配公共 IP。 false - 指示计算节点将具有专用终结点且没有公共 IP。 bool
idleTimeBeforeShutdown 在用户定义的非活动时段后停止计算实例。 时间以ISO8601格式定义。 最小值为 15 分钟,最长为 3 天。 string
personalComputeInstanceSettings 个人计算实例的设置。 PersonalComputeInstanceSettings
setupScripts 要执行的用于设置群集的自定义脚本的详细信息。 SetupScripts
sshSettings 指定 SSH 访问的策略和设置。 ComputeInstanceSshSettings
子网 计算节点所属的虚拟网络子网资源 ID。 ResourceId
vmSize 虚拟机大小 字符串

CustomService

名称 说明
docker 描述映像的 docker 设置 Docker
端点 配置容器的终结点 Endpoint[]
environmentVariables 容器的环境变量 CustomServiceEnvironmentVariables
image 描述映像规范 图像
name 自定义服务的名称 字符串
volumes 为容器配置卷 VolumeDefinition[]
{customized property}

Docker

名称 说明
特权 指示容器应以特权模式还是非特权模式运行。 bool
{customized property}

终结点

名称 说明
hostIp 从容器中公开应用程序的主机 IP string
name 终结点的名称 string
protocol 通过此终结点进行通信的协议 'http'
'tcp'
'udp'
published 从容器中公开应用程序的端口。 int
目标 容器中的应用程序端口。 int

CustomServiceEnvironmentVariables

名称 说明
{customized property} EnvironmentVariable

EnvironmentVariable

名称 说明 Value
type 环境变量的类型。 可能的值是:local - 对于局部变量 'local'
value 环境变量的值 string
{customized property}

映像

名称 说明
reference 图像引用 URL string
type 图像的类型。 可能的值为:docker - 用于 docker 映像。 azureml - 对于 AzureML 映像 'azureml'
“docker”
{customized property}

VolumeDefinition

名称 说明
bind 装载的绑定选项 BindOptions
一致性 卷的一致性 字符串
readOnly 指示是否将卷装载为 readOnly。 默认值为 false。 bool
source 装载的源。 对于绑定装载,这是主机路径。 string
目标 装载的目标。 对于绑定装载,这是容器中的路径。 string
Tmpfs 装载的 tmpfs 选项 TmpfsOptions
类型 卷定义的类型。 可能的值:bind、volume、tmpfs、npipe 'bind'
'npipe'
'tmpfs'
'volume'
装载的卷选项 VolumeOptions

BindOptions

名称 说明
createHostPath 指示是否创建主机路径。 bool
传播 绑定选项的类型 字符串
selinux 提及 selinux 选项。 字符串

TmpfsOptions

名称 说明
大小 提及 Tmpfs 大小 int

VolumeOptions

名称 说明
nocopy 指示卷是否为 nocopy bool

PersonalComputeInstanceSettings

名称 说明
assignedUser 显式分配给个人计算实例的用户。 AssignedUser

AssignedUser

名称 说明
objectId 用户的 AAD 对象 ID。 字符串 (必需)
tenantId 用户的 AAD 租户 ID。 字符串 (必需)

SetupScripts

名称 说明
脚本 自定义安装脚本 ScriptsToExecute

ScriptsToExecute

名称 说明
creationScript 在预配计算期间仅运行一次的脚本。 ScriptReference
startupScript 每次计算机启动时运行的脚本。 ScriptReference

ScriptReference

名称 说明
scriptArguments 传递给要运行的脚本的可选命令行参数。 string
scriptData 脚本在已装载卷中的位置。 字符串
scriptSource 脚本的存储源:内联、工作区。 string
timeout 传递给 timeout 命令的可选时间段。 字符串

ComputeInstanceSshSettings

名称 说明
adminPublicKey 将 SSH rsa 公钥文件指定为字符串。 使用“ssh-keygen -t rsa -b 2048”生成 SSH 密钥对。 字符串
sshPublicAccess 公共 SSH 端口的状态。 可能的值为:Disabled - 指示在此实例上关闭公共 SSH 端口。 已启用 - 指示公共 ssh 端口已打开,并且根据 VNet/子网策略(如果适用)进行访问。 “Disabled”
“已启用”

Databricks

名称 说明
computeType 计算类型 需要“Databricks” ()
properties Databricks 的属性 DatabricksProperties

DatabricksProperties

名称 说明
databricksAccessToken Databricks 访问令牌 字符串
workspaceUrl 工作区 URL 字符串

DataFactory

名称 说明
computeType 计算类型 “DataFactory” (必需)

DataLakeAnalytics

名称 说明
computeType 计算类型 需要“DataLakeAnalytics” ()
properties DataLakeAnalyticsSchemaProperties

DataLakeAnalyticsSchemaProperties

名称 说明
dataLakeStoreAccountName DataLake Store 帐户名称 字符串

HDInsight

名称 说明
computeType 计算类型 “HDInsight” (必需)
properties HDInsight 计算属性 HDInsightProperties

HDInsightProperties

名称 说明
address 群集主节点的公共 IP 地址。 字符串
administratorAccount 管理员群集主节点的凭据 VirtualMachineSshCredentials
sshPort 为群集主节点上的 ssh 连接打开端口。 int

VirtualMachineSshCredentials

名称 说明
password 管理员帐户的密码 字符串
privateKeyData 私钥数据 字符串

约束:
敏感值。 作为安全参数传入。
publicKeyData 公钥数据 字符串

约束:
敏感值。 作为安全参数传入。
username 管理员帐户的用户名 字符串

Kubernetes

名称 说明
computeType 计算类型 “Kubernetes” (必需)
properties Kubernetes 的属性 KubernetesProperties

KubernetesProperties

名称 说明
defaultInstanceType 默认实例类型 string
extensionInstanceReleaseTrain 扩展实例发布训练。 string
extensionPrincipalId 扩展主体 id。 string
instanceTypes 实例类型架构 KubernetesPropertiesInstanceTypes
命名空间 计算命名空间 string
relayConnectionString 中继连接字符串。 string

约束:
敏感值。 作为安全参数传入。
serviceBusConnectionString ServiceBus 连接字符串。 string

约束:
敏感值。 作为安全参数传入。
vcName VC 名称。 字符串

KubernetesPropertiesInstanceTypes

名称 说明
{customized property} InstanceTypeSchema

InstanceTypeSchema

名称 说明
nodeSelector 节点选择器 InstanceTypeSchemaNodeSelector
resources 此实例类型的资源请求/限制 InstanceTypeSchemaResources

InstanceTypeSchemaNodeSelector

名称 说明
{customized property} 字符串

InstanceTypeSchemaResources

名称 说明
限制 此实例类型的资源限制 InstanceResourceSchema
请求 此实例类型的资源请求 InstanceResourceSchema

InstanceResourceSchema

名称 说明
{customized property} 字符串
{customized property} string

SynapseSpark

名称 说明
computeType 计算类型 “SynapseSpark” (必需)
properties SynapseSparkProperties

SynapseSparkProperties

名称 说明
autoPauseProperties 自动暂停属性。 AutoPauseProperties
autoScaleProperties 自动缩放属性。 AutoScaleProperties
nodeCount 当前分配给计算的计算节点数。 int
nodeSize 节点大小。 string
nodeSizeFamily 节点大小系列。 字符串
poolName 池名称。 字符串
resourceGroup 工作区所在的资源组的名称。 string
sparkVersion Spark 版本。 字符串
subscriptionId Azure 订阅标识符。 字符串
workspaceName Azure 机器学习工作区的名称。 string

AutoPauseProperties

名称 说明
delayInMinutes int
enabled bool

AutoScaleProperties

名称 说明
enabled bool
maxNodeCount int
minNodeCount int

VirtualMachine

名称 说明
computeType 计算类型 “VirtualMachine” (必需)
properties VirtualMachineSchemaProperties

VirtualMachineSchemaProperties

名称 说明
address 虚拟机的公共 IP 地址。 字符串
administratorAccount 为虚拟机管理员凭据 VirtualMachineSshCredentials
isNotebookInstanceCompute 指示此计算是否将用于运行笔记本。 bool
notebookServerPort 为 SSH 连接打开笔记本服务器端口。 int
sshPort 为 SSH 连接打开端口。 int
virtualMachineSize 虚拟机大小 字符串

SKU

名称 说明
容量 如果 SKU 支持横向扩展/缩减,则应包含容量整数。 如果资源无法横向扩展/缩减,则可能会省略这一点。 int
family 如果服务具有不同代系的硬件(对于同一 SKU),则可以在此处进行捕获。 字符串
name SKU 的名称。 例如 - P3。 它通常是字母+数字代码 字符串 (必需)
大小 SKU 大小。 当名称字段是层和其他某个值的组合时,这将是独立代码。 字符串
如果服务具有多个层,但 PUT 上不需要此字段,则资源提供程序必须实现此字段。 “Basic”
“免费”
“Premium”
“Standard”

快速入门模板

以下快速入门模板部署此资源类型。

模板 说明
创建机器学习服务 ADLA 计算

部署到 Azure
此模板创建机器学习服务 ADLA 计算。
创建机器学习服务 Aks 计算

部署到 Azure
此模板创建机器学习服务 Aks 计算。
创建机器学习服务 DSVM 计算

部署到 Azure
此模板创建机器学习服务 DSVM 计算。
创建机器学习服务 HDInsight 群集

部署到 Azure
此模板创建机器学习服务 HDInsight 群集
创建 Azure 机器学习 aks 计算

部署到 Azure
此模板创建 Azure 机器学习 aks 计算。
创建 Azure 机器学习计算群集

部署到 Azure
此模板创建 Azure 机器学习计算群集。
创建 Azure 机器学习计算实例

部署到 Azure
此模板使用示例内联设置脚本代表其他用户创建 Azure 机器学习计算实例
在 Azure 机器学习工作区中创建 LinkedService

部署到 Azure
此模板在现有 Azure 机器学习工作区中创建 LinkedService。
创建具有专用 IP 地址的 AKS 计算目标

部署到 Azure
此模板在给定的 Azure 机器学习服务工作区中创建具有专用 IP 地址的 AKS 计算目标。

Terraform (AzAPI 提供程序) 资源定义

可以使用面向以下操作部署工作区/计算资源类型:

  • 资源组

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.MachineLearningServices/workspaces/computes 资源,请将以下 Terraform 添加到模板。

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

计算对象

设置 computeType 属性以指定对象的类型。

对于 AKS,请使用:

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

对于 AmlCompute,请使用:

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

对于 ComputeInstance,请使用:

  computeType = "ComputeInstance"
  properties = {
    applicationSharingPolicy = "string"
    computeInstanceAuthorizationType = "personal"
    customServices = [
      {
        docker = {
          privileged = bool
        }
        endpoints = [
          {
            hostIp = "string"
            name = "string"
            protocol = "string"
            published = int
            target = int
          }
        ]
        environmentVariables = {
          {customized property} = {
            type = "local"
            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"
  }

对于 Databricks,请使用:

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

对于 DataFactory,请使用:

  computeType = "DataFactory"

对于 DataLakeAnalytics,请使用:

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

对于 HDInsight,请使用:

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

对于 Kubernetes,请使用:

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

对于 SynapseSpark,请使用:

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

对于 VirtualMachine,请使用:

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

属性值

workspaces/computes

名称 说明 Value
type 资源类型 “Microsoft.MachineLearningServices/workspaces/computes@2022-06-01-preview”
name 资源名称 字符串 (必需)

字符限制:计算实例为 3-24
3-32 用于 AML 计算
2-16 用于其他计算类型

有效字符:
字母数字和连字符。
location 指定资源的位置。 string
parent_id 此资源的父资源的 ID。 类型为的资源的 ID: 工作区
标记 包含定义为键/值对的资源标记。 标记名称和值的字典。
sku 工作区的 SKU。 Sku
标识 资源的标识。 ManagedServiceIdentity
properties 计算属性 计算

ManagedServiceIdentity

名称 说明 Value
type ) 允许 SystemAssigned 和 UserAssigned 类型的托管服务标识 (的类型。 “SystemAssigned”
“SystemAssigned,UserAssigned”
“UserAssigned” (必需)
identity_ids 与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将是采用以下格式的 ARM 资源 ID:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。 字典值可以是请求中) ({} 空对象。 用户标识 ID 的数组。

UserAssignedIdentities

名称 说明
{customized property} UserAssignedIdentity

UserAssignedIdentity

此对象不包含部署期间要设置的任何属性。 所有属性均为 ReadOnly。

计算

名称 说明
description 机器学习计算的说明。 字符串
disableLocalAuth 选择退出本地身份验证,并确保客户只能将 MSI 和 AAD 专用于身份验证。 bool
ResourceId 基础计算的 ARM 资源 ID 字符串
computeType 设置对象类型 AKS
AmlCompute
ComputeInstance
Databricks
DataFactory
DataLakeAnalytics
HDInsight
Kubernetes
SynapseSpark
VirtualMachine (必需)

AKS

名称 说明
computeType 计算类型 “AKS” (必需)
properties AKS 属性 AKSSchemaProperties

AKSSchemaProperties

名称 说明
agentCount 代理数 int

约束:
最小值 = 0
agentVmSize 代理虚拟机大小 字符串
aksNetworkingConfiguration vnet 的 AKS 网络配置 AksNetworkingConfiguration
clusterFqdn 群集完全限定的域名 字符串
clusterPurpose 群集的预期用途 “DenseProd”
“DevTest”
“FastProd”
loadBalancerSubnet 负载均衡器子网 字符串
loadBalancerType 负载均衡器类型 “InternalLoadBalancer”
“PublicIp”
sslConfiguration SSL 配置 SslConfiguration

AksNetworkingConfiguration

名称 说明
dnsServiceIP 分配给 Kubernetes DNS 服务的 IP 地址。 它必须在 serviceCidr 中指定的 Kubernetes 服务地址范围内。 字符串

约束:
模式 = ^(?:(?: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 服务地址范围重叠。 字符串

约束:
模式 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidr CIDR 表示法 IP 范围,从其中分配服务群集 IP。 此范围不得与任何子网 IP 范围重叠。 string

约束:
模式 = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
subnetId 计算节点所属的虚拟网络子网资源 ID 字符串

SslConfiguration

名称 说明
cert 证书数据 字符串

约束:
敏感值。 作为安全参数传入。
cname 证书的 CNAME string
key 关键数据 字符串

约束:
敏感值。 作为安全参数传入。
leafDomainLabel 公共终结点的叶域标签 字符串
overwriteExistingDomain 指示是否覆盖现有域标签。 bool
status 启用或禁用用于评分的 ssl “Auto”
“Disabled”
“已启用”

AmlCompute

名称 说明
computeType 计算类型 “AmlCompute” (必需)
properties AmlCompute 的属性 AmlComputeProperties

AmlComputeProperties

名称 说明
enableNodePublicIp 启用或禁用节点公共 IP 地址预配。 可能的值为:可能的值为:true - 指示计算节点将预配公共 IP。 false - 指示计算节点将具有专用终结点,并且没有公共 IP。 bool
isolatedNetwork 网络是否隔离 bool
osType 计算 OS 类型 “Linux”
“Windows”
propertyBag 包含其他属性的属性包。
remoteLoginPortPublicAccess 公共 SSH 端口的状态。 可能的值为:Disabled - 指示公共 ssh 端口在群集的所有节点上关闭。 已启用 - 指示群集的所有节点上的公用 ssh 端口已打开。 NotSpecified - 指示如果定义了 VNet,则群集的所有节点上的公共 ssh 端口已关闭,否则将打开所有公共节点。 它只能在创建群集时处于默认状态,在创建后,它将启用或禁用。 “Disabled”
“已启用”
“NotSpecified”
scaleSettings AML 计算的缩放设置 ScaleSettings
子网 计算节点所属的虚拟网络子网资源 ID。 ResourceId
userAccountCredentials 将在每个计算节点上创建的管理员用户帐户的凭据。 UserAccountCredentials
virtualMachineImage AML 计算的虚拟机映像 - 仅限窗口 VirtualMachineImage
vmPriority 虚拟机优先级 “专用”
“LowPriority”
vmSize 虚拟机大小 字符串

ScaleSettings

名称 说明
maxNodeCount 要使用的最大节点数 int (必需)
minNodeCount 要使用的最小节点数 int
nodeIdleTimeBeforeScaleDown 缩减 amlCompute 之前的节点空闲时间。 此字符串需要采用 RFC 格式。 字符串

ResourceId

名称 说明 Value
id 资源的 ID 字符串 (必需)

UserAccountCredentials

名称 说明
adminUserName 可用于通过 SSH 连接到节点的管理员用户帐户的名称。 字符串 (必需)
adminUserPassword 管理员用户帐户的密码。 字符串

约束:
敏感值。 作为安全参数传入。
adminUserSshPublicKey 管理员用户帐户的 SSH 公钥。 字符串

约束:
敏感值。 作为安全参数传入。

VirtualMachineImage

名称 说明 Value
id 虚拟机映像路径 字符串 (必需)

ComputeInstance

名称 说明
computeType 计算类型 需要“ComputeInstance” ()
properties ComputeInstance 的属性 ComputeInstanceProperties

ComputeInstanceProperties

名称 说明
applicationSharingPolicy 用于在父工作区的用户之间共享此计算实例上的应用程序的策略。 如果为“个人”,则只有创建者可以访问此计算实例上的应用程序。 共享后,任何工作区用户都可以访问此实例上的应用程序,具体取决于其分配的角色。 “个人”
“Shared”
computeInstanceAuthorizationType 计算实例授权类型。 可用值为个人 (默认) 。 “personal”
customServices 添加到计算中的自定义服务列表。 CustomService[]
enableNodePublicIp 启用或禁用节点公共 IP 地址预配。 可能的值是:可能的值是:true - 指示计算节点将预配公共 IP。 false - 指示计算节点将具有专用终结点且没有公共 IP。 bool
idleTimeBeforeShutdown 在用户定义的非活动时段后停止计算实例。 时间以ISO8601格式定义。 最小值为 15 分钟,最长为 3 天。 字符串
personalComputeInstanceSettings 个人计算实例的设置。 PersonalComputeInstanceSettings
setupScripts 要执行的用于设置群集的自定义脚本的详细信息。 SetupScripts
sshSettings 指定 SSH 访问的策略和设置。 ComputeInstanceSshSettings
子网 计算节点所属的虚拟网络子网资源 ID。 ResourceId
vmSize 虚拟机大小 字符串

CustomService

名称 说明
docker 描述映像的 docker 设置 Docker
端点 配置容器的终结点 Endpoint[]
environmentVariables 容器的环境变量 CustomServiceEnvironmentVariables
image 描述映像规范 图像
name 自定义服务的名称 字符串
volumes 为容器配置卷 VolumeDefinition[]
{customized property}

Docker

名称 说明
特权 指示容器应以特权模式还是非特权模式运行。 bool
{customized property}

终结点

名称 说明
hostIp 从容器中公开应用程序的主机 IP string
name 终结点的名称 字符串
protocol 通过此终结点进行通信的协议 “http”
“tcp”
“udp”
published 从容器中公开应用程序的端口。 int
目标 容器中的应用程序端口。 int

CustomServiceEnvironmentVariables

名称 说明
{customized property} EnvironmentVariable

EnvironmentVariable

名称 说明 Value
type 环境变量的类型。 可能的值是:local - 对于局部变量 “local”
value 环境变量的值 字符串
{customized property}

映像

名称 说明
reference 图像引用 URL string
type 图像的类型。 可能的值为:docker - 用于 docker 映像。 azureml - 对于 AzureML 映像 “azureml”
“docker”
{customized property}

VolumeDefinition

名称 说明
bind 装载的绑定选项 BindOptions
一致性 卷的一致性 string
readOnly 指示是否将卷装载为 readOnly。 默认值为 false。 bool
source 装载的源。 对于绑定装载,这是主机路径。 string
目标 装载的目标。 对于绑定装载,这是容器中的路径。 字符串
Tmpfs 装载的 tmpfs 选项 TmpfsOptions
类型 卷定义的类型。 可能的值:bind、volume、tmpfs、npipe “bind”
“npipe”
“tmpfs”
“volume”
装载的卷选项 VolumeOptions

BindOptions

名称 说明
createHostPath 指示是否创建主机路径。 bool
传播 绑定选项的类型 string
selinux 提及 selinux 选项。 字符串

TmpfsOptions

名称 说明
大小 提及 Tmpfs 大小 int

VolumeOptions

名称 说明
nocopy 指示卷是否为 nocopy bool

PersonalComputeInstanceSettings

名称 说明
assignedUser 显式分配给个人计算实例的用户。 AssignedUser

AssignedUser

名称 说明
objectId 用户的 AAD 对象 ID。 字符串 (必需)
tenantId 用户的 AAD 租户 ID。 字符串 (必需)

SetupScripts

名称 说明
脚本 自定义安装脚本 ScriptsToExecute

ScriptsToExecute

名称 说明
creationScript 在预配计算期间只运行一次的脚本。 ScriptReference
startupScript 每次启动计算机时运行的脚本。 ScriptReference

ScriptReference

名称 说明
scriptArguments 传递给要运行的脚本的可选命令行参数。 字符串
scriptData 脚本在已装载卷中的位置。 string
scriptSource 脚本的存储源:内联、工作区。 string
timeout 传递给超时命令的可选时间段。 string

ComputeInstanceSshSettings

名称 说明
adminPublicKey 将 SSH rsa 公钥文件指定为字符串。 使用“ssh-keygen -t rsa -b 2048”生成 SSH 密钥对。 字符串
sshPublicAccess 公共 SSH 端口的状态。 可能的值是:Disabled - 指示此实例上的公共 ssh 端口已关闭。 已启用 - 指示公共 ssh 端口已打开,并根据 VNet/子网策略(如果适用)进行访问。 “Disabled”
“Enabled”

Databricks

名称 说明
computeType 计算类型 需要“Databricks” ()
properties Databricks 的属性 DatabricksProperties

DatabricksProperties

名称 说明
databricksAccessToken Databricks 访问令牌 字符串
workspaceUrl 工作区 URL string

DataFactory

名称 说明
computeType 计算类型 “DataFactory” (必需)

DataLakeAnalytics

名称 说明
computeType 计算类型 “DataLakeAnalytics” (必需)
properties DataLakeAnalyticsSchemaProperties

DataLakeAnalyticsSchemaProperties

名称 说明
dataLakeStoreAccountName DataLake Store 帐户名称 string

HDInsight

名称 说明
computeType 计算类型 需要“HDInsight” ()
properties HDInsight 计算属性 HDInsightProperties

HDInsightProperties

名称 说明
address 群集主节点的公共 IP 地址。 string
administratorAccount 管理员群集主节点的凭据 VirtualMachineSshCredentials
sshPort 为群集主节点上的 ssh 连接打开端口。 int

VirtualMachineSshCredentials

名称 说明
password 管理员帐户的密码 字符串
privateKeyData 私钥数据 字符串

约束:
敏感值。 作为安全参数传入。
publicKeyData 公钥数据 字符串

约束:
敏感值。 作为安全参数传入。
username 管理员帐户的用户名 字符串

Kubernetes

名称 说明
computeType 计算类型 “Kubernetes” (必需)
properties Kubernetes 的属性 KubernetesProperties

KubernetesProperties

名称 说明
defaultInstanceType 默认实例类型 字符串
extensionInstanceReleaseTrain 扩展实例发布训练。 字符串
extensionPrincipalId 扩展主体 id。 字符串
instanceTypes 实例类型架构 KubernetesPropertiesInstanceTypes
命名空间 计算命名空间 字符串
relayConnectionString 中继连接字符串。 字符串

约束:
敏感值。 作为安全参数传入。
serviceBusConnectionString ServiceBus 连接字符串。 字符串

约束:
敏感值。 作为安全参数传入。
vcName VC 名称。 字符串

KubernetesPropertiesInstanceTypes

名称 说明
{customized property} InstanceTypeSchema

InstanceTypeSchema

名称 说明
nodeSelector 节点选择器 InstanceTypeSchemaNodeSelector
resources 此实例类型的资源请求/限制 InstanceTypeSchemaResources

InstanceTypeSchemaNodeSelector

名称 说明
{customized property} 字符串

InstanceTypeSchemaResources

名称 说明
限制 此实例类型的资源限制 InstanceResourceSchema
请求 此实例类型的资源请求 InstanceResourceSchema

InstanceResourceSchema

名称 说明
{customized property} 字符串
{customized property} 字符串

SynapseSpark

名称 说明
computeType 计算类型 需要“SynapseSpark” ()
properties SynapseSparkProperties

SynapseSparkProperties

名称 说明
autoPauseProperties 自动暂停属性。 AutoPauseProperties
autoScaleProperties 自动缩放属性。 AutoScaleProperties
nodeCount 当前分配给计算的计算节点数。 int
nodeSize 节点大小。 字符串
nodeSizeFamily 节点大小系列。 字符串
poolName 池名称。 字符串
resourceGroup 工作区所在的资源组的名称。 字符串
sparkVersion Spark 版本。 字符串
subscriptionId Azure 订阅标识符。 字符串
workspaceName Azure 机器学习工作区的名称。 字符串

AutoPauseProperties

名称 说明
delayInMinutes int
enabled bool

AutoScaleProperties

名称 说明
enabled bool
maxNodeCount int
minNodeCount int

VirtualMachine

名称 说明
computeType 计算类型 “VirtualMachine” (必需)
properties VirtualMachineSchemaProperties

VirtualMachineSchemaProperties

名称 说明
address 虚拟机的公共 IP 地址。 字符串
administratorAccount 为虚拟机管理员凭据 VirtualMachineSshCredentials
isNotebookInstanceCompute 指示此计算是否将用于运行笔记本。 bool
notebookServerPort 为 ssh 连接打开笔记本服务器端口。 int
sshPort 为 ssh 连接打开端口。 int
virtualMachineSize 虚拟机大小 字符串

SKU

名称 说明
容量 如果 SKU 支持横向扩展/缩减,则应包含容量整数。 如果无法对资源进行横向扩展/缩减,则可能会省略此项。 int
family 如果服务针对同一 SKU 具有不同代系的硬件,则可以在此处捕获。 字符串
name SKU 的名称。 例如 - P3。 它通常是字母+数字代码 字符串 (必需)
大小 SKU 大小。 当名称字段是层和一些其他值的组合时,这将是独立代码。 字符串
如果服务具有多个层,但 PUT 上不需要此字段,则资源提供程序需要实现此字段。 "Basic"
"Free"
“Premium”
“Standard”