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

Microsoft.MachineLearningServices 工作区/计算 2023-08-01-preview

Bicep 资源定义

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

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

资源格式

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

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

计算对象

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

对于 AKS,请使用:

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

对于 AmlCompute,请使用:

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

对于 ComputeInstance,请使用:

{
  computeType: 'ComputeInstance'
  properties: {
    applicationSharingPolicy: 'string'
    autologgerSettings: {
      mlflowAutologger: 'string'
    }
    computeInstanceAuthorizationType: 'string'
    customServices: [
      {
        docker: {
          privileged: bool
        }
        endpoints: [
          {
            hostIp: 'string'
            name: 'string'
            protocol: 'string'
            published: int
            target: int
          }
        ]
        environmentVariables: {
          {customized property}: {
            type: 'string'
            value: 'string'
          }
        }
        image: {
          reference: 'string'
          type: 'string'
          version: 'string'
        }
        kernel: {
          argv: [
            'string'
          ]
          displayName: 'string'
          language: '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
    enableOSPatching: bool
    enableRootAccess: bool
    enableSSO: bool
    idleTimeBeforeShutdown: 'string'
    personalComputeInstanceSettings: {
      assignedUser: {
        objectId: 'string'
        tenantId: 'string'
      }
    }
    releaseQuotaOnStop: bool
    schedules: {
      computeStartStop: [
        {
          action: 'string'
          cron: {
            expression: 'string'
            startTime: 'string'
            timeZone: 'string'
          }
          recurrence: {
            frequency: 'string'
            interval: int
            schedule: {
              hours: [
                int
              ]
              minutes: [
                int
              ]
              monthDays: [
                int
              ]
              weekDays: [
                'string'
              ]
            }
            startTime: 'string'
            timeZone: 'string'
          }
          schedule: {
            id: 'string'
            provisioningStatus: 'string'
            status: 'string'
          }
          status: 'string'
          triggerType: 'string'
        }
      ]
    }
    setupScripts: {
      scripts: {
        creationScript: {
          scriptArguments: 'string'
          scriptData: 'string'
          scriptSource: 'string'
          timeout: 'string'
        }
        startupScript: {
          scriptArguments: 'string'
          scriptData: 'string'
          scriptSource: 'string'
          timeout: 'string'
        }
      }
    }
    sshSettings: {
      adminPublicKey: 'string'
      sshPublicAccess: 'string'
    }
    subnet: {
      id: 'string'
    }
    vmSize: 'string'
  }
}

对于 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 计算节点所属的虚拟网络子网资源 ID 字符串

AKSSchemaProperties

名字 描述 价值
agentCount 代理数 int

约束:
最小值 = 0
agentVmSize 代理虚拟机大小 字符串
aksNetworkingConfiguration vnet 的 AKS 网络配置 AksNetworkingConfiguration
clusterFqdn 群集完全限定的域名 字符串
clusterPurpose 群集的预期用途 “DenseProd”
“开发测试”
“FastProd”
loadBalancerSubnet 负载均衡器子网 字符串
loadBalancerType 负载均衡器类型 “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 包含其他属性的属性包。 any
remoteLoginPortPublicAccess 公共 SSH 端口的状态。 可能的值是:已禁用 - 指示公共 ssh 端口已在群集的所有节点上关闭。 已启用 - 指示公共 ssh 端口在群集的所有节点上处于打开状态。 NotSpecified - 指示如果定义了 VNet,则群集的所有节点上关闭公共 SSH 端口,否则将打开所有公共节点。 只能在创建群集期间默认,创建后才会启用或禁用它。 “Disabled”
“Enabled”
“NotSpecified”
scaleSettings AML 计算的规模设置 ScaleSettings
计算节点所属的虚拟网络子网资源 ID。 ResourceId
userAccountCredentials 将在每个计算节点上创建的管理员用户帐户的凭据。 UserAccountCredentials
virtualMachineImage AML 计算的虚拟机映像 - 仅限窗口 VirtualMachineImage
vmPriority 虚拟机优先级 “专用”
“LowPriority”
vmSize 虚拟机大小 字符串

AssignedUser

名字 描述 价值
objectId 用户的 AAD 对象 ID。 string (必需)
tenantId 用户的 AAD 租户 ID。 string (必需)

AutoPauseProperties

名字 描述 价值
delayInMinutes int
启用 bool

AutoScaleProperties

名字 描述 价值
启用 bool
maxNodeCount int
minNodeCount int

BindOptions

名字 描述 价值
createHostPath 指示是否创建主机路径。 bool
增殖 绑定选项的类型 字符串
selinux 提及 selinux 选项。 字符串

计算

名字 描述 价值
computeLocation 基础计算的位置 字符串
computeType 对于 AKS类型,设置为“AKS”。 对于 AmlCompute类型,设置为“AmlCompute”。 对于 type 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”(必需)
描述 机器学习计算的说明。 字符串
disableLocalAuth 选择退出本地身份验证,并确保客户只能仅使用 MSI 和 AAD 进行身份验证。 bool
resourceId 基础计算的 ARM 资源 ID 字符串

ComputeInstance

名字 描述 价值
computeType 计算的类型 “ComputeInstance”(必需)
性能 ComputeInstance 的属性 ComputeInstanceProperties

ComputeInstanceAutologgerSettings

名字 描述 价值
mlflowAutologger 指示是否为笔记本启用了 mlflow 自动记录器。 “Disabled”
“Enabled”

ComputeInstanceProperties

名字 描述 价值
applicationSharingPolicy 用于在此计算实例上共享父工作区用户的应用程序的策略。 如果个人版,则只有创建者可以访问此计算实例上的应用程序。 共享时,任何工作区用户都可以根据分配的角色访问此实例上的应用程序。 “个人”
“共享”
autologgerSettings 指定自动记录器的设置。 ComputeInstanceAutologgerSettings
computeInstanceAuthorizationType 计算实例授权类型。 可用值为个人值(默认值)。 “personal”
customServices 添加到计算中的自定义服务列表。 CustomService[]
enableNodePublicIp 启用或禁用节点公共 IP 地址预配。 可能的值为:可能的值为:true - 指示计算节点将预配公共 IP。 false - 指示计算节点将具有专用终结点,并且没有公共 IP。 bool
enableOSPatching 启用自动 OS 修补。 可能的值为:true、false。 bool
enableRootAccess 启用根访问。 可能的值为:true、false。 bool
enableSSO 启用 SSO(单一登录)。 可能的值为:true、false。 bool
idleTimeBeforeShutdown 在用户定义的非活动期间后停止计算实例。 时间以ISO8601格式定义。 最小值为 15 分钟,最大值为 3 天。 字符串
personalComputeInstanceSettings 个人计算实例的设置。 PersonalComputeInstanceSettings
releaseQuotaOnStop 如果计算实例停止,则释放配额。 可能的值为:true - 如果计算实例停止,则释放配额。 false - 在计算实例停止时不释放配额。 bool
附表 要应用于计算的计划列表。 ComputeSchedules
setupScripts 用于设置群集的自定义脚本的详细信息。 SetupScripts
sshSettings 指定 SSH 访问的策略和设置。 ComputeInstanceSshSettings
计算节点所属的虚拟网络子网资源 ID。 ResourceId
vmSize 虚拟机大小 字符串

ComputeInstanceSshSettings

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

ComputeRecurrenceSchedule

名字 描述 价值
小时 [必需]计划小时列表。 int[] (必需)
纪要 [必需]计划分钟列表。 int[] (必需)
monthDays 计划月份日期列表 int[]
平日 计划天数列表。 包含任一项的字符串数组:
“Friday”
“Monday”
“Saturday”
“星期日”
“星期四”
“Tuesday”
“Wednesday”

ComputeResourceTags

名字 描述 价值

ComputeSchedules

名字 描述 价值
computeStartStop 要应用的计算启动停止计划的列表。 ComputeStartStopSchedule[]

ComputeStartStopSchedule

名字 描述 价值
行动 [必需]计算能力操作。 “Start”
“Stop”
cron 如果 triggerType 为 Cron,则为必需。 Cron
复发 如果 triggerType 为 Recurrence,则为必需。 定期
附表 [已弃用]不再使用。 ScheduleBase
地位 计划是启用或禁用的吗? “Disabled”
“Enabled”
triggerType [必需]计划触发器类型。 “Cron”
“Recurrence”

Cron

名字 描述 价值
表达 [必需]指定计划的 cron 表达式。
表达式应遵循 NCronTab 格式。
字符串
startTime yyyy-MM-ddTHH:mm:ss 格式的开始时间。 字符串
timeZone 指定运行计划的时区。
TimeZone 应遵循 Windows 时区格式。 请参阅:/windows-hardware/manufacture/desktop/default-time-zone?view=windows-11
字符串

CustomService

名字 描述 价值
码头工人 描述映像的 docker 设置 Docker
端点 配置容器的终结点 终结点[]
environmentVariables 容器的环境变量 CustomServiceEnvironmentVariables
图像 描述映像规范 图像
内核 描述映像的 jupyter 内核设置(如果是自定义环境) JupyterKernelConfig
名字 自定义服务的名称 字符串
为容器配置卷 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

图像

名字 描述 价值
参考 如果类型为 docker,则映像引用 URL。 如果类型为 azureml,则环境名称 字符串
类型 图像的类型。 可能的值包括:docker - 对于 docker 映像。 azureml - 对于 AzureML 环境映像(自定义和特选) “azureml”
“docker”
版本 正在使用的映像版本。 如果最新,请跳过此字段 字符串

InstanceResourceSchema

名字 描述 价值

InstanceResourceSchema

名字 描述 价值

InstanceTypeSchema

名字 描述 价值
nodeSelector 节点选择器 InstanceTypeSchemaNodeSelector
资源 此实例类型的资源请求/限制 InstanceTypeSchemaResources

InstanceTypeSchemaNodeSelector

名字 描述 价值

InstanceTypeSchemaResources

名字 描述 价值
限制 此实例类型的资源限制 InstanceResourceSchema
请求 此实例类型的资源请求 InstanceResourceSchema

JupyterKernelConfig

名字 描述 价值
argv 运行时的参数 string[]
displayName 内核的显示名称 字符串
语言 内核语言 [示例值:python] 字符串

Kubernetes

名字 描述 价值
computeType 计算的类型 “Kubernetes”(必需)
性能 Kubernetes 的属性 KubernetesProperties

KubernetesProperties

名字 描述 价值
defaultInstanceType 默认实例类型 字符串
extensionInstanceReleaseTrain 扩展实例发布训练。 字符串
extensionPrincipalId 扩展主体 ID。 字符串
instanceTypes 实例类型架构 KubernetesPropertiesInstanceTypes
namespace 计算命名空间 字符串
relayConnectionString 中继连接字符串。 字符串

约束:
敏感值。 以安全参数的形式传入。
serviceBusConnectionString ServiceBus 连接字符串。 字符串

约束:
敏感值。 以安全参数的形式传入。
vcName VC 名称。 字符串

KubernetesPropertiesInstanceTypes

名字 描述 价值

ManagedServiceIdentity

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

Microsoft.MachineLearningServices/workspaces/computes

名字 描述 价值
身份 资源的标识。 ManagedServiceIdentity
位置 指定资源的位置。 字符串
名字 资源名称 字符串

约束:
模式 = ^[a-zA-Z](?![a-zA-Z0-9-]*-\d+$)[a-zA-Z0-9\-]{2,23}$ (必需)
父母 在 Bicep 中,可以为子资源指定父资源。 仅当子资源在父资源外部声明时,才需要添加此属性。

有关详细信息,请参阅 父资源外部的子资源
类型资源的符号名称:工作区
性能 计算属性 计算
sku 工作区的 SKU。 Sku
标签 资源标记 标记名称和值的字典。 请参阅模板 中的 标记

PersonalComputeInstanceSettings

名字 描述 价值
assignedUser 显式分配给个人计算实例的用户。 AssignedUser

复发

名字 描述 价值
频率 [必需]触发计划的频率。 “Day”
“Hour”
“Minute”
“Month”
“Week”
间隔 [必需]指定计划间隔与频率 int
附表 [必需]重复计划。 ComputeRecurrenceSchedule
startTime yyyy-MM-ddTHH:mm:ss 格式的开始时间。 字符串
timeZone 指定运行计划的时区。
TimeZone 应遵循 Windows 时区格式。 请参阅:/windows-hardware/manufacture/desktop/default-time-zone?view=windows-11
字符串

ResourceId

名字 描述 价值
id 资源的 ID string (必需)

ScaleSettings

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

ScheduleBase

名字 描述 价值
id 计划的系统分配 ID。 字符串
provisioningStatus 计划的当前部署状态。 “Completed”
“Failed”
“预配”
地位 计划是启用或禁用的吗? “Disabled”
“Enabled”

ScriptReference

名字 描述 价值
scriptArguments 传递给要运行的脚本的可选命令行参数。 字符串
scriptData 装载卷中脚本的位置。 字符串
scriptSource 脚本的存储源:内联工作区。 字符串
超时 传递给超时命令的可选时间段。 字符串

ScriptsToExecute

名字 描述 价值
creationScript 预配计算期间仅运行一次的脚本。 ScriptReference
startupScript 每次计算机启动时运行的脚本。 ScriptReference

SetupScripts

名字 描述 价值
脚本 自定义设置脚本 ScriptsToExecute

Sku

名字 描述 价值
能力 如果 SKU 支持横向扩展/缩减,则应包含容量整数。 如果资源无法横向扩展/缩小,则可能会省略此范围。 int
家庭 如果服务具有不同代的硬件(对于同一 SKU,则可以在此处捕获)。 字符串
名字 SKU 的名称。 Ex - P3. 它通常是字母+数字代码 string (必需)
大小 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 机器学习工作区的名称。 字符串

TmpfsOptions

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

UserAccountCredentials

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

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

约束:
敏感值。 以安全参数的形式传入。

UserAssignedIdentities

名字 描述 价值

UserAssignedIdentity

名字 描述 价值

VirtualMachine

名字 描述 价值
computeType 计算的类型 “VirtualMachine”(必需)
性能 VirtualMachineSchemaProperties

VirtualMachineImage

名字 描述 价值
id 虚拟机映像路径 string (必需)

VirtualMachineSchemaProperties

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

VirtualMachineSshCredentials

名字 描述 价值
密码 管理员帐户的密码 字符串
privateKeyData 私钥数据 字符串

约束:
敏感值。 以安全参数的形式传入。
publicKeyData 公钥数据 字符串

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

VolumeDefinition

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

VolumeOptions

名字 描述 价值
nocopy 指示卷是否为 nocopy bool

快速入门示例

以下快速入门示例部署此资源类型。

Bicep 文件 描述
Azure 机器学习端到端安全设置 此 Bicep 模板集演示如何在安全设置中端到端设置 Azure 机器学习。 此参考实现包括工作区、计算群集、计算实例和附加的专用 AKS 群集。
Azure 机器学习端到端安全设置(旧版) 此 Bicep 模板集演示如何在安全设置中端到端设置 Azure 机器学习。 此参考实现包括工作区、计算群集、计算实例和附加的专用 AKS 群集。
创建具有专用 IP 地址的 AKS 计算目标 此模板使用专用 IP 地址在给定的 Azure 机器学习服务工作区中创建 AKS 计算目标。

ARM 模板资源定义

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

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

资源格式

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

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

计算对象

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

对于 AKS,请使用:

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

对于 AmlCompute,请使用:

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

对于 ComputeInstance,请使用:

{
  "computeType": "ComputeInstance",
  "properties": {
    "applicationSharingPolicy": "string",
    "autologgerSettings": {
      "mlflowAutologger": "string"
    },
    "computeInstanceAuthorizationType": "string",
    "customServices": [
      {
        "docker": {
          "privileged": "bool"
        },
        "endpoints": [
          {
            "hostIp": "string",
            "name": "string",
            "protocol": "string",
            "published": "int",
            "target": "int"
          }
        ],
        "environmentVariables": {
          "{customized property}": {
            "type": "string",
            "value": "string"
          }
        },
        "image": {
          "reference": "string",
          "type": "string",
          "version": "string"
        },
        "kernel": {
          "argv": [ "string" ],
          "displayName": "string",
          "language": "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",
    "enableOSPatching": "bool",
    "enableRootAccess": "bool",
    "enableSSO": "bool",
    "idleTimeBeforeShutdown": "string",
    "personalComputeInstanceSettings": {
      "assignedUser": {
        "objectId": "string",
        "tenantId": "string"
      }
    },
    "releaseQuotaOnStop": "bool",
    "schedules": {
      "computeStartStop": [
        {
          "action": "string",
          "cron": {
            "expression": "string",
            "startTime": "string",
            "timeZone": "string"
          },
          "recurrence": {
            "frequency": "string",
            "interval": "int",
            "schedule": {
              "hours": [ "int" ],
              "minutes": [ "int" ],
              "monthDays": [ "int" ],
              "weekDays": [ "string" ]
            },
            "startTime": "string",
            "timeZone": "string"
          },
          "schedule": {
            "id": "string",
            "provisioningStatus": "string",
            "status": "string"
          },
          "status": "string",
          "triggerType": "string"
        }
      ]
    },
    "setupScripts": {
      "scripts": {
        "creationScript": {
          "scriptArguments": "string",
          "scriptData": "string",
          "scriptSource": "string",
          "timeout": "string"
        },
        "startupScript": {
          "scriptArguments": "string",
          "scriptData": "string",
          "scriptSource": "string",
          "timeout": "string"
        }
      }
    },
    "sshSettings": {
      "adminPublicKey": "string",
      "sshPublicAccess": "string"
    },
    "subnet": {
      "id": "string"
    },
    "vmSize": "string"
  }
}

对于 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 计算节点所属的虚拟网络子网资源 ID 字符串

AKSSchemaProperties

名字 描述 价值
agentCount 代理数 int

约束:
最小值 = 0
agentVmSize 代理虚拟机大小 字符串
aksNetworkingConfiguration vnet 的 AKS 网络配置 AksNetworkingConfiguration
clusterFqdn 群集完全限定的域名 字符串
clusterPurpose 群集的预期用途 “DenseProd”
“开发测试”
“FastProd”
loadBalancerSubnet 负载均衡器子网 字符串
loadBalancerType 负载均衡器类型 “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 包含其他属性的属性包。 any
remoteLoginPortPublicAccess 公共 SSH 端口的状态。 可能的值是:已禁用 - 指示公共 ssh 端口已在群集的所有节点上关闭。 已启用 - 指示公共 ssh 端口在群集的所有节点上处于打开状态。 NotSpecified - 指示如果定义了 VNet,则群集的所有节点上关闭公共 SSH 端口,否则将打开所有公共节点。 只能在创建群集期间默认,创建后才会启用或禁用它。 “Disabled”
“Enabled”
“NotSpecified”
scaleSettings AML 计算的规模设置 ScaleSettings
计算节点所属的虚拟网络子网资源 ID。 ResourceId
userAccountCredentials 将在每个计算节点上创建的管理员用户帐户的凭据。 UserAccountCredentials
virtualMachineImage AML 计算的虚拟机映像 - 仅限窗口 VirtualMachineImage
vmPriority 虚拟机优先级 “专用”
“LowPriority”
vmSize 虚拟机大小 字符串

AssignedUser

名字 描述 价值
objectId 用户的 AAD 对象 ID。 string (必需)
tenantId 用户的 AAD 租户 ID。 string (必需)

AutoPauseProperties

名字 描述 价值
delayInMinutes int
启用 bool

AutoScaleProperties

名字 描述 价值
启用 bool
maxNodeCount int
minNodeCount int

BindOptions

名字 描述 价值
createHostPath 指示是否创建主机路径。 bool
增殖 绑定选项的类型 字符串
selinux 提及 selinux 选项。 字符串

计算

名字 描述 价值
computeLocation 基础计算的位置 字符串
computeType 对于 AKS类型,设置为“AKS”。 对于 AmlCompute类型,设置为“AmlCompute”。 对于 type 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”(必需)
描述 机器学习计算的说明。 字符串
disableLocalAuth 选择退出本地身份验证,并确保客户只能仅使用 MSI 和 AAD 进行身份验证。 bool
resourceId 基础计算的 ARM 资源 ID 字符串

ComputeInstance

名字 描述 价值
computeType 计算的类型 “ComputeInstance”(必需)
性能 ComputeInstance 的属性 ComputeInstanceProperties

ComputeInstanceAutologgerSettings

名字 描述 价值
mlflowAutologger 指示是否为笔记本启用了 mlflow 自动记录器。 “Disabled”
“Enabled”

ComputeInstanceProperties

名字 描述 价值
applicationSharingPolicy 用于在此计算实例上共享父工作区用户的应用程序的策略。 如果个人版,则只有创建者可以访问此计算实例上的应用程序。 共享时,任何工作区用户都可以根据分配的角色访问此实例上的应用程序。 “个人”
“共享”
autologgerSettings 指定自动记录器的设置。 ComputeInstanceAutologgerSettings
computeInstanceAuthorizationType 计算实例授权类型。 可用值为个人值(默认值)。 “personal”
customServices 添加到计算中的自定义服务列表。 CustomService[]
enableNodePublicIp 启用或禁用节点公共 IP 地址预配。 可能的值为:可能的值为:true - 指示计算节点将预配公共 IP。 false - 指示计算节点将具有专用终结点,并且没有公共 IP。 bool
enableOSPatching 启用自动 OS 修补。 可能的值为:true、false。 bool
enableRootAccess 启用根访问。 可能的值为:true、false。 bool
enableSSO 启用 SSO(单一登录)。 可能的值为:true、false。 bool
idleTimeBeforeShutdown 在用户定义的非活动期间后停止计算实例。 时间以ISO8601格式定义。 最小值为 15 分钟,最大值为 3 天。 字符串
personalComputeInstanceSettings 个人计算实例的设置。 PersonalComputeInstanceSettings
releaseQuotaOnStop 如果计算实例停止,则释放配额。 可能的值为:true - 如果计算实例停止,则释放配额。 false - 在计算实例停止时不释放配额。 bool
附表 要应用于计算的计划列表。 ComputeSchedules
setupScripts 用于设置群集的自定义脚本的详细信息。 SetupScripts
sshSettings 指定 SSH 访问的策略和设置。 ComputeInstanceSshSettings
计算节点所属的虚拟网络子网资源 ID。 ResourceId
vmSize 虚拟机大小 字符串

ComputeInstanceSshSettings

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

ComputeRecurrenceSchedule

名字 描述 价值
小时 [必需]计划小时列表。 int[] (必需)
纪要 [必需]计划分钟列表。 int[] (必需)
monthDays 计划月份日期列表 int[]
平日 计划天数列表。 包含任一项的字符串数组:
“Friday”
“Monday”
“Saturday”
“星期日”
“星期四”
“Tuesday”
“Wednesday”

ComputeResourceTags

名字 描述 价值

ComputeSchedules

名字 描述 价值
computeStartStop 要应用的计算启动停止计划的列表。 ComputeStartStopSchedule[]

ComputeStartStopSchedule

名字 描述 价值
行动 [必需]计算能力操作。 “Start”
“Stop”
cron 如果 triggerType 为 Cron,则为必需。 Cron
复发 如果 triggerType 为 Recurrence,则为必需。 定期
附表 [已弃用]不再使用。 ScheduleBase
地位 计划是启用或禁用的吗? “Disabled”
“Enabled”
triggerType [必需]计划触发器类型。 “Cron”
“Recurrence”

Cron

名字 描述 价值
表达 [必需]指定计划的 cron 表达式。
表达式应遵循 NCronTab 格式。
字符串
startTime yyyy-MM-ddTHH:mm:ss 格式的开始时间。 字符串
timeZone 指定运行计划的时区。
TimeZone 应遵循 Windows 时区格式。 请参阅:/windows-hardware/manufacture/desktop/default-time-zone?view=windows-11
字符串

CustomService

名字 描述 价值
码头工人 描述映像的 docker 设置 Docker
端点 配置容器的终结点 终结点[]
environmentVariables 容器的环境变量 CustomServiceEnvironmentVariables
图像 描述映像规范 图像
内核 描述映像的 jupyter 内核设置(如果是自定义环境) JupyterKernelConfig
名字 自定义服务的名称 字符串
为容器配置卷 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

图像

名字 描述 价值
参考 如果类型为 docker,则映像引用 URL。 如果类型为 azureml,则环境名称 字符串
类型 图像的类型。 可能的值包括:docker - 对于 docker 映像。 azureml - 对于 AzureML 环境映像(自定义和特选) “azureml”
“docker”
版本 正在使用的映像版本。 如果最新,请跳过此字段 字符串

InstanceResourceSchema

名字 描述 价值

InstanceResourceSchema

名字 描述 价值

InstanceTypeSchema

名字 描述 价值
nodeSelector 节点选择器 InstanceTypeSchemaNodeSelector
资源 此实例类型的资源请求/限制 InstanceTypeSchemaResources

InstanceTypeSchemaNodeSelector

名字 描述 价值

InstanceTypeSchemaResources

名字 描述 价值
限制 此实例类型的资源限制 InstanceResourceSchema
请求 此实例类型的资源请求 InstanceResourceSchema

JupyterKernelConfig

名字 描述 价值
argv 运行时的参数 string[]
displayName 内核的显示名称 字符串
语言 内核语言 [示例值:python] 字符串

Kubernetes

名字 描述 价值
computeType 计算的类型 “Kubernetes”(必需)
性能 Kubernetes 的属性 KubernetesProperties

KubernetesProperties

名字 描述 价值
defaultInstanceType 默认实例类型 字符串
extensionInstanceReleaseTrain 扩展实例发布训练。 字符串
extensionPrincipalId 扩展主体 ID。 字符串
instanceTypes 实例类型架构 KubernetesPropertiesInstanceTypes
namespace 计算命名空间 字符串
relayConnectionString 中继连接字符串。 字符串

约束:
敏感值。 以安全参数的形式传入。
serviceBusConnectionString ServiceBus 连接字符串。 字符串

约束:
敏感值。 以安全参数的形式传入。
vcName VC 名称。 字符串

KubernetesPropertiesInstanceTypes

名字 描述 价值

ManagedServiceIdentity

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

Microsoft.MachineLearningServices/workspaces/computes

名字 描述 价值
apiVersion API 版本 '2023-08-01-preview'
身份 资源的标识。 ManagedServiceIdentity
位置 指定资源的位置。 字符串
名字 资源名称 字符串

约束:
模式 = ^[a-zA-Z](?![a-zA-Z0-9-]*-\d+$)[a-zA-Z0-9\-]{2,23}$ (必需)
性能 计算属性 计算
sku 工作区的 SKU。 Sku
标签 资源标记 标记名称和值的字典。 请参阅模板 中的 标记
类型 资源类型 “Microsoft.MachineLearningServices/workspaces/computes”

PersonalComputeInstanceSettings

名字 描述 价值
assignedUser 显式分配给个人计算实例的用户。 AssignedUser

复发

名字 描述 价值
频率 [必需]触发计划的频率。 “Day”
“Hour”
“Minute”
“Month”
“Week”
间隔 [必需]指定计划间隔与频率 int
附表 [必需]重复计划。 ComputeRecurrenceSchedule
startTime yyyy-MM-ddTHH:mm:ss 格式的开始时间。 字符串
timeZone 指定运行计划的时区。
TimeZone 应遵循 Windows 时区格式。 请参阅:/windows-hardware/manufacture/desktop/default-time-zone?view=windows-11
字符串

ResourceId

名字 描述 价值
id 资源的 ID string (必需)

ScaleSettings

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

ScheduleBase

名字 描述 价值
id 计划的系统分配 ID。 字符串
provisioningStatus 计划的当前部署状态。 “Completed”
“Failed”
“预配”
地位 计划是启用或禁用的吗? “Disabled”
“Enabled”

ScriptReference

名字 描述 价值
scriptArguments 传递给要运行的脚本的可选命令行参数。 字符串
scriptData 装载卷中脚本的位置。 字符串
scriptSource 脚本的存储源:内联工作区。 字符串
超时 传递给超时命令的可选时间段。 字符串

ScriptsToExecute

名字 描述 价值
creationScript 预配计算期间仅运行一次的脚本。 ScriptReference
startupScript 每次计算机启动时运行的脚本。 ScriptReference

SetupScripts

名字 描述 价值
脚本 自定义设置脚本 ScriptsToExecute

Sku

名字 描述 价值
能力 如果 SKU 支持横向扩展/缩减,则应包含容量整数。 如果资源无法横向扩展/缩小,则可能会省略此范围。 int
家庭 如果服务具有不同代的硬件(对于同一 SKU,则可以在此处捕获)。 字符串
名字 SKU 的名称。 Ex - P3. 它通常是字母+数字代码 string (必需)
大小 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 机器学习工作区的名称。 字符串

TmpfsOptions

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

UserAccountCredentials

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

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

约束:
敏感值。 以安全参数的形式传入。

UserAssignedIdentities

名字 描述 价值

UserAssignedIdentity

名字 描述 价值

VirtualMachine

名字 描述 价值
computeType 计算的类型 “VirtualMachine”(必需)
性能 VirtualMachineSchemaProperties

VirtualMachineImage

名字 描述 价值
id 虚拟机映像路径 string (必需)

VirtualMachineSchemaProperties

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

VirtualMachineSshCredentials

名字 描述 价值
密码 管理员帐户的密码 字符串
privateKeyData 私钥数据 字符串

约束:
敏感值。 以安全参数的形式传入。
publicKeyData 公钥数据 字符串

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

VolumeDefinition

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

VolumeOptions

名字 描述 价值
nocopy 指示卷是否为 nocopy bool

快速入门模板

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

模板 描述
Azure 机器学习端到端安全设置

部署到 Azure
此 Bicep 模板集演示如何在安全设置中端到端设置 Azure 机器学习。 此参考实现包括工作区、计算群集、计算实例和附加的专用 AKS 群集。
Azure 机器学习端到端安全设置(旧版)

部署到 Azure
此 Bicep 模板集演示如何在安全设置中端到端设置 Azure 机器学习。 此参考实现包括工作区、计算群集、计算实例和附加的专用 AKS 群集。
在 Azure 机器学习工作区中创建 LinkedService

部署到 Azure
此模板在现有的 Azure 机器学习工作区中创建 LinkedService。
创建机器学习服务 ADLA 计算

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

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

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

部署到 Azure
此模板创建机器学习服务 HDInsight 群集
创建具有专用 IP 地址的 AKS 计算目标

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

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

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

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

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

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

  • 资源组

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

资源格式

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/computes@2023-08-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  body = jsonencode({
    properties = {
      computeLocation = "string"
      description = "string"
      disableLocalAuth = bool
      resourceId = "string"
      computeType = "string"
      // For remaining properties, see Compute objects
    }
  })
  sku = {
    capacity = int
    family = "string"
    name = "string"
    size = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
}

计算对象

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

对于 AKS,请使用:

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

对于 AmlCompute,请使用:

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

对于 ComputeInstance,请使用:

{
  computeType = "ComputeInstance"
  properties = {
    applicationSharingPolicy = "string"
    autologgerSettings = {
      mlflowAutologger = "string"
    }
    computeInstanceAuthorizationType = "string"
    customServices = [
      {
        docker = {
          privileged = bool
        }
        endpoints = [
          {
            hostIp = "string"
            name = "string"
            protocol = "string"
            published = int
            target = int
          }
        ]
        environmentVariables = {
          {customized property} = {
            type = "string"
            value = "string"
          }
        }
        image = {
          reference = "string"
          type = "string"
          version = "string"
        }
        kernel = {
          argv = [
            "string"
          ]
          displayName = "string"
          language = "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
    enableOSPatching = bool
    enableRootAccess = bool
    enableSSO = bool
    idleTimeBeforeShutdown = "string"
    personalComputeInstanceSettings = {
      assignedUser = {
        objectId = "string"
        tenantId = "string"
      }
    }
    releaseQuotaOnStop = bool
    schedules = {
      computeStartStop = [
        {
          action = "string"
          cron = {
            expression = "string"
            startTime = "string"
            timeZone = "string"
          }
          recurrence = {
            frequency = "string"
            interval = int
            schedule = {
              hours = [
                int
              ]
              minutes = [
                int
              ]
              monthDays = [
                int
              ]
              weekDays = [
                "string"
              ]
            }
            startTime = "string"
            timeZone = "string"
          }
          schedule = {
            id = "string"
            provisioningStatus = "string"
            status = "string"
          }
          status = "string"
          triggerType = "string"
        }
      ]
    }
    setupScripts = {
      scripts = {
        creationScript = {
          scriptArguments = "string"
          scriptData = "string"
          scriptSource = "string"
          timeout = "string"
        }
        startupScript = {
          scriptArguments = "string"
          scriptData = "string"
          scriptSource = "string"
          timeout = "string"
        }
      }
    }
    sshSettings = {
      adminPublicKey = "string"
      sshPublicAccess = "string"
    }
    subnet = {
      id = "string"
    }
    vmSize = "string"
  }
}

对于 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 计算节点所属的虚拟网络子网资源 ID 字符串

AKSSchemaProperties

名字 描述 价值
agentCount 代理数 int

约束:
最小值 = 0
agentVmSize 代理虚拟机大小 字符串
aksNetworkingConfiguration vnet 的 AKS 网络配置 AksNetworkingConfiguration
clusterFqdn 群集完全限定的域名 字符串
clusterPurpose 群集的预期用途 “DenseProd”
“开发测试”
“FastProd”
loadBalancerSubnet 负载均衡器子网 字符串
loadBalancerType 负载均衡器类型 “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 包含其他属性的属性包。 any
remoteLoginPortPublicAccess 公共 SSH 端口的状态。 可能的值是:已禁用 - 指示公共 ssh 端口已在群集的所有节点上关闭。 已启用 - 指示公共 ssh 端口在群集的所有节点上处于打开状态。 NotSpecified - 指示如果定义了 VNet,则群集的所有节点上关闭公共 SSH 端口,否则将打开所有公共节点。 只能在创建群集期间默认,创建后才会启用或禁用它。 “Disabled”
“Enabled”
“NotSpecified”
scaleSettings AML 计算的规模设置 ScaleSettings
计算节点所属的虚拟网络子网资源 ID。 ResourceId
userAccountCredentials 将在每个计算节点上创建的管理员用户帐户的凭据。 UserAccountCredentials
virtualMachineImage AML 计算的虚拟机映像 - 仅限窗口 VirtualMachineImage
vmPriority 虚拟机优先级 “专用”
“LowPriority”
vmSize 虚拟机大小 字符串

AssignedUser

名字 描述 价值
objectId 用户的 AAD 对象 ID。 string (必需)
tenantId 用户的 AAD 租户 ID。 string (必需)

AutoPauseProperties

名字 描述 价值
delayInMinutes int
启用 bool

AutoScaleProperties

名字 描述 价值
启用 bool
maxNodeCount int
minNodeCount int

BindOptions

名字 描述 价值
createHostPath 指示是否创建主机路径。 bool
增殖 绑定选项的类型 字符串
selinux 提及 selinux 选项。 字符串

计算

名字 描述 价值
computeLocation 基础计算的位置 字符串
computeType 对于 AKS类型,设置为“AKS”。 对于 AmlCompute类型,设置为“AmlCompute”。 对于 type 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”(必需)
描述 机器学习计算的说明。 字符串
disableLocalAuth 选择退出本地身份验证,并确保客户只能仅使用 MSI 和 AAD 进行身份验证。 bool
resourceId 基础计算的 ARM 资源 ID 字符串

ComputeInstance

名字 描述 价值
computeType 计算的类型 “ComputeInstance”(必需)
性能 ComputeInstance 的属性 ComputeInstanceProperties

ComputeInstanceAutologgerSettings

名字 描述 价值
mlflowAutologger 指示是否为笔记本启用了 mlflow 自动记录器。 “Disabled”
“Enabled”

ComputeInstanceProperties

名字 描述 价值
applicationSharingPolicy 用于在此计算实例上共享父工作区用户的应用程序的策略。 如果个人版,则只有创建者可以访问此计算实例上的应用程序。 共享时,任何工作区用户都可以根据分配的角色访问此实例上的应用程序。 “个人”
“共享”
autologgerSettings 指定自动记录器的设置。 ComputeInstanceAutologgerSettings
computeInstanceAuthorizationType 计算实例授权类型。 可用值为个人值(默认值)。 “personal”
customServices 添加到计算中的自定义服务列表。 CustomService[]
enableNodePublicIp 启用或禁用节点公共 IP 地址预配。 可能的值为:可能的值为:true - 指示计算节点将预配公共 IP。 false - 指示计算节点将具有专用终结点,并且没有公共 IP。 bool
enableOSPatching 启用自动 OS 修补。 可能的值为:true、false。 bool
enableRootAccess 启用根访问。 可能的值为:true、false。 bool
enableSSO 启用 SSO(单一登录)。 可能的值为:true、false。 bool
idleTimeBeforeShutdown 在用户定义的非活动期间后停止计算实例。 时间以ISO8601格式定义。 最小值为 15 分钟,最大值为 3 天。 字符串
personalComputeInstanceSettings 个人计算实例的设置。 PersonalComputeInstanceSettings
releaseQuotaOnStop 如果计算实例停止,则释放配额。 可能的值为:true - 如果计算实例停止,则释放配额。 false - 在计算实例停止时不释放配额。 bool
附表 要应用于计算的计划列表。 ComputeSchedules
setupScripts 用于设置群集的自定义脚本的详细信息。 SetupScripts
sshSettings 指定 SSH 访问的策略和设置。 ComputeInstanceSshSettings
计算节点所属的虚拟网络子网资源 ID。 ResourceId
vmSize 虚拟机大小 字符串

ComputeInstanceSshSettings

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

ComputeRecurrenceSchedule

名字 描述 价值
小时 [必需]计划小时列表。 int[] (必需)
纪要 [必需]计划分钟列表。 int[] (必需)
monthDays 计划月份日期列表 int[]
平日 计划天数列表。 包含任一项的字符串数组:
“Friday”
“Monday”
“Saturday”
“星期日”
“星期四”
“Tuesday”
“Wednesday”

ComputeResourceTags

名字 描述 价值

ComputeSchedules

名字 描述 价值
computeStartStop 要应用的计算启动停止计划的列表。 ComputeStartStopSchedule[]

ComputeStartStopSchedule

名字 描述 价值
行动 [必需]计算能力操作。 “Start”
“Stop”
cron 如果 triggerType 为 Cron,则为必需。 Cron
复发 如果 triggerType 为 Recurrence,则为必需。 定期
附表 [已弃用]不再使用。 ScheduleBase
地位 计划是启用或禁用的吗? “Disabled”
“Enabled”
triggerType [必需]计划触发器类型。 “Cron”
“Recurrence”

Cron

名字 描述 价值
表达 [必需]指定计划的 cron 表达式。
表达式应遵循 NCronTab 格式。
字符串
startTime yyyy-MM-ddTHH:mm:ss 格式的开始时间。 字符串
timeZone 指定运行计划的时区。
TimeZone 应遵循 Windows 时区格式。 请参阅:/windows-hardware/manufacture/desktop/default-time-zone?view=windows-11
字符串

CustomService

名字 描述 价值
码头工人 描述映像的 docker 设置 Docker
端点 配置容器的终结点 终结点[]
environmentVariables 容器的环境变量 CustomServiceEnvironmentVariables
图像 描述映像规范 图像
内核 描述映像的 jupyter 内核设置(如果是自定义环境) JupyterKernelConfig
名字 自定义服务的名称 字符串
为容器配置卷 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

图像

名字 描述 价值
参考 如果类型为 docker,则映像引用 URL。 如果类型为 azureml,则环境名称 字符串
类型 图像的类型。 可能的值包括:docker - 对于 docker 映像。 azureml - 对于 AzureML 环境映像(自定义和特选) “azureml”
“docker”
版本 正在使用的映像版本。 如果最新,请跳过此字段 字符串

InstanceResourceSchema

名字 描述 价值

InstanceResourceSchema

名字 描述 价值

InstanceTypeSchema

名字 描述 价值
nodeSelector 节点选择器 InstanceTypeSchemaNodeSelector
资源 此实例类型的资源请求/限制 InstanceTypeSchemaResources

InstanceTypeSchemaNodeSelector

名字 描述 价值

InstanceTypeSchemaResources

名字 描述 价值
限制 此实例类型的资源限制 InstanceResourceSchema
请求 此实例类型的资源请求 InstanceResourceSchema

JupyterKernelConfig

名字 描述 价值
argv 运行时的参数 string[]
displayName 内核的显示名称 字符串
语言 内核语言 [示例值:python] 字符串

Kubernetes

名字 描述 价值
computeType 计算的类型 “Kubernetes”(必需)
性能 Kubernetes 的属性 KubernetesProperties

KubernetesProperties

名字 描述 价值
defaultInstanceType 默认实例类型 字符串
extensionInstanceReleaseTrain 扩展实例发布训练。 字符串
extensionPrincipalId 扩展主体 ID。 字符串
instanceTypes 实例类型架构 KubernetesPropertiesInstanceTypes
namespace 计算命名空间 字符串
relayConnectionString 中继连接字符串。 字符串

约束:
敏感值。 以安全参数的形式传入。
serviceBusConnectionString ServiceBus 连接字符串。 字符串

约束:
敏感值。 以安全参数的形式传入。
vcName VC 名称。 字符串

KubernetesPropertiesInstanceTypes

名字 描述 价值

ManagedServiceIdentity

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

Microsoft.MachineLearningServices/workspaces/computes

名字 描述 价值
身份 资源的标识。 ManagedServiceIdentity
位置 指定资源的位置。 字符串
名字 资源名称 字符串

约束:
模式 = ^[a-zA-Z](?![a-zA-Z0-9-]*-\d+$)[a-zA-Z0-9\-]{2,23}$ (必需)
parent_id 此资源的父资源的 ID。 类型资源的 ID:工作区
性能 计算属性 计算
sku 工作区的 SKU。 Sku
标签 资源标记 标记名称和值的字典。
类型 资源类型 “Microsoft.MachineLearningServices/workspaces/computes@2023-08-01-preview”

PersonalComputeInstanceSettings

名字 描述 价值
assignedUser 显式分配给个人计算实例的用户。 AssignedUser

复发

名字 描述 价值
频率 [必需]触发计划的频率。 “Day”
“Hour”
“Minute”
“Month”
“Week”
间隔 [必需]指定计划间隔与频率 int
附表 [必需]重复计划。 ComputeRecurrenceSchedule
startTime yyyy-MM-ddTHH:mm:ss 格式的开始时间。 字符串
timeZone 指定运行计划的时区。
TimeZone 应遵循 Windows 时区格式。 请参阅:/windows-hardware/manufacture/desktop/default-time-zone?view=windows-11
字符串

ResourceId

名字 描述 价值
id 资源的 ID string (必需)

ScaleSettings

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

ScheduleBase

名字 描述 价值
id 计划的系统分配 ID。 字符串
provisioningStatus 计划的当前部署状态。 “Completed”
“Failed”
“预配”
地位 计划是启用或禁用的吗? “Disabled”
“Enabled”

ScriptReference

名字 描述 价值
scriptArguments 传递给要运行的脚本的可选命令行参数。 字符串
scriptData 装载卷中脚本的位置。 字符串
scriptSource 脚本的存储源:内联工作区。 字符串
超时 传递给超时命令的可选时间段。 字符串

ScriptsToExecute

名字 描述 价值
creationScript 预配计算期间仅运行一次的脚本。 ScriptReference
startupScript 每次计算机启动时运行的脚本。 ScriptReference

SetupScripts

名字 描述 价值
脚本 自定义设置脚本 ScriptsToExecute

Sku

名字 描述 价值
能力 如果 SKU 支持横向扩展/缩减,则应包含容量整数。 如果资源无法横向扩展/缩小,则可能会省略此范围。 int
家庭 如果服务具有不同代的硬件(对于同一 SKU,则可以在此处捕获)。 字符串
名字 SKU 的名称。 Ex - P3. 它通常是字母+数字代码 string (必需)
大小 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 机器学习工作区的名称。 字符串

TmpfsOptions

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

UserAccountCredentials

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

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

约束:
敏感值。 以安全参数的形式传入。

UserAssignedIdentities

名字 描述 价值

UserAssignedIdentity

名字 描述 价值

VirtualMachine

名字 描述 价值
computeType 计算的类型 “VirtualMachine”(必需)
性能 VirtualMachineSchemaProperties

VirtualMachineImage

名字 描述 价值
id 虚拟机映像路径 string (必需)

VirtualMachineSchemaProperties

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

VirtualMachineSshCredentials

名字 描述 价值
密码 管理员帐户的密码 字符串
privateKeyData 私钥数据 字符串

约束:
敏感值。 以安全参数的形式传入。
publicKeyData 公钥数据 字符串

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

VolumeDefinition

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

VolumeOptions

名字 描述 价值
nocopy 指示卷是否为 nocopy bool