Microsoft.MachineLearningServices/workspaces/computes 2022-10-01 - Bicep, ARM template & Terraform AzAPI reference

Definición de recursos de Bicep

El tipo de recurso workspaces/computes se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.MachineLearningServices/workspaces/computes, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/computes@2022-10-01' = {
  parent: resourceSymbolicName
  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'
  }
}

Objetos de proceso

Establezca la propiedad computeType para especificar el tipo de objeto.

Para akS, use:

{
  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'
    }
  }
}

Para AmlCompute, use:

{
  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'
  }
}

Para computeInstance, use:

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

Para dataFactory, use:

{
  computeType: 'DataFactory'
}

Para DataLakeAnalytics, use:

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

Para databricks, use:

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

Para de HDInsight, use:

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

Para kubernetes, use:

{
  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'
  }
}

Para SynapseSpark , use:

{
  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'
  }
}

Para virtualMachine, use:

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

Valores de propiedad

AKS

Nombre	Descripción	Valor
computeType	Tipo de proceso	'AKS' (obligatorio)
Propiedades	Propiedades de AKS	AKSSchemaProperties

AksNetworkingConfiguration

Nombre	Descripción	Valor
dnsServiceIP	Una dirección IP asignada al servicio DNS de Kubernetes. Debe estar dentro del intervalo de direcciones del servicio kubernetes especificado en serviceCidr.	cuerda Restricciones: Patrón = `^(?:(?: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	Intervalo IP de notación CIDR asignado a la red del puente de Docker. No se debe superponer con ningún intervalo IP de subred ni con el intervalo de direcciones del servicio Kubernetes.	cuerda Restricciones: Patrón = `^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]\|[1-2][0-9]\|3[0-2]))?$`
serviceCidr	Intervalo IP de notación CIDR desde el que se van a asignar direcciones IP del clúster de servicio. No debe superponerse con ningún intervalo IP de subred.	cuerda Restricciones: Patrón = `^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]\|[1-2][0-9]\|3[0-2]))?$`
subnetId	Identificador de recurso de subred de red virtual al que pertenecen los nodos de proceso	cuerda

AKSSchemaProperties

Nombre	Descripción	Valor
agentCount	Número de agentes	Int Restricciones: Valor mínimo = 0
agentVmSize	Tamaño de máquina virtual del agente	cuerda
aksNetworkingConfiguration	Configuración de redes de AKS para la red virtual	AksNetworkingConfiguration
clusterFqdn	Nombre de dominio completo del clúster	cuerda
clusterPurpose	Uso previsto del clúster	'DenseProd' 'DevTest' "FastProd"
loadBalancerSubnet	Subred del equilibrador de carga	cuerda
loadBalancerType	Tipo de equilibrador de carga	'InternalLoadBalancer' 'PublicIp'
sslConfiguration	Configuración de SSL	SslConfiguration

AmlCompute

Nombre	Descripción	Valor
computeType	Tipo de proceso	'AmlCompute' (obligatorio)
Propiedades	Propiedades de AmlCompute	AmlComputeProperties

AmlComputeProperties

Nombre	Descripción	Valor
enableNodePublicIp	Habilite o deshabilite el aprovisionamiento de direcciones IP públicas del nodo. Los valores posibles son: los valores posibles son: true: indica que los nodos de proceso tendrán direcciones IP públicas aprovisionadas. false: indica que los nodos de proceso tendrán un punto de conexión privado y ninguna dirección IP pública.	Bool
isolatedNetwork	La red está aislada o no	Bool
osType	Tipo de sistema operativo de proceso	"Linux" 'Windows'
propertyBag	Contenedor de propiedades que contiene propiedades adicionales.	cualquiera
remoteLoginPortPublicAccess	Estado del puerto SSH público. Los valores posibles son: Disabled: indica que el puerto ssh público está cerrado en todos los nodos del clúster. Habilitado: indica que el puerto ssh público está abierto en todos los nodos del clúster. NotSpecified: indica que el puerto ssh público está cerrado en todos los nodos del clúster si se define la red virtual; de lo contrario, se abren todos los nodos públicos. Solo puede ser predeterminado durante el tiempo de creación del clúster, después de la creación se habilitará o deshabilitará.	'Deshabilitado' 'Habilitado' 'NotSpecified'
scaleSettings	Configuración de escalado para proceso de AML	scaleSettings
subred	Identificador de recurso de subred de red virtual al que pertenecen los nodos de proceso.	ResourceId
userAccountCredentials	Credenciales de una cuenta de usuario de administrador que se creará en cada nodo de proceso.	userAccountCredentials
virtualMachineImage	Imagen de máquina virtual para proceso de AML: solo windows	virtualMachineImage
vmPriority	Prioridad de máquina virtual	'Dedicado' 'LowPriority'
vmSize	Tamaño de máquina virtual	cuerda

AssignedUser

Nombre	Descripción	Valor
objectId	Identificador de objeto de AAD del usuario.	string (obligatorio)
tenantId	Identificador de inquilino de AAD del usuario.	string (obligatorio)

AutoPauseProperties

Nombre	Descripción	Valor
delayInMinutes		Int
Habilitado		Bool

AutoScaleProperties

Nombre	Descripción	Valor
Habilitado		Bool
maxNodeCount		Int
minNodeCount		Int

Calcular

Nombre	Descripción	Valor
computeLocation	Ubicación del proceso subyacente	cuerda
computeType	Establezca en "AKS" para el tipo AKS. Establezca en "AmlCompute" para el tipo AmlCompute. Establezca en "ComputeInstance" para el tipo ComputeInstance. Establezca en "DataFactory" para el tipo DataFactory. Establezca en "DataLakeAnalytics" para el tipo DataLakeAnalytics. Establezca en "Databricks" para el tipo Databricks. Establezca en "HDInsight" para el tipo HDInsight. Establezca en "Kubernetes" para el tipo Kubernetes. Establezca en "SynapseSpark" para el tipo SynapseSpark. Establezca en "VirtualMachine" para el tipo VirtualMachine.	"AKS" 'AmlCompute' "ComputeInstance" "Databricks" 'DataFactory' 'DataLakeAnalytics' "HDInsight" "Kubernetes" "SynapseSpark" 'VirtualMachine' (obligatorio)
descripción	Descripción del proceso de Machine Learning.	cuerda
disableLocalAuth	No participar en la autenticación local y asegurarse de que los clientes solo pueden usar MSI y AAD exclusivamente para la autenticación.	Bool
resourceId	Identificador de recurso de ARM del proceso subyacente	cuerda

ComputeInstance

Nombre	Descripción	Valor
computeType	Tipo de proceso	'ComputeInstance' (obligatorio)
Propiedades	Propiedades de ComputeInstance	ComputeInstanceProperties

ComputeInstanceProperties

Nombre	Descripción	Valor
applicationSharingPolicy	Directiva para compartir aplicaciones en esta instancia de proceso entre los usuarios del área de trabajo primaria. Si es Personal, solo el creador puede acceder a las aplicaciones en esta instancia de proceso. Cuando es Compartido, cualquier usuario del área de trabajo puede acceder a las aplicaciones de esta instancia en función de su rol asignado.	"Personal" 'Compartido'
computeInstanceAuthorizationType	Tipo de autorización de instancia de proceso. Los valores disponibles son personales (valor predeterminado).	'personal'
enableNodePublicIp	Habilite o deshabilite el aprovisionamiento de direcciones IP públicas del nodo. Los valores posibles son: los valores posibles son: true: indica que los nodos de proceso tendrán direcciones IP públicas aprovisionadas. false: indica que los nodos de proceso tendrán un punto de conexión privado y ninguna dirección IP pública.	Bool
personalComputeInstanceSettings	Configuración de una instancia de proceso personal.	PersonalComputeInstanceSettings
Horarios	Lista de programaciones que se van a aplicar en los procesos.	computeSchedules
setupScripts	Detalles de los scripts personalizados que se van a ejecutar para configurar el clúster.	SetupScripts
sshSettings	Especifica la directiva y la configuración para el acceso SSH.	ComputeInstanceSshSettings
subred	Identificador de recurso de subred de red virtual al que pertenecen los nodos de proceso.	ResourceId
vmSize	Tamaño de máquina virtual	cuerda

ComputeInstanceSshSettings

Nombre	Descripción	Valor
adminPublicKey	Especifica el archivo de clave pública rsa SSH como una cadena. Use "ssh-keygen -t rsa -b 2048" para generar los pares de claves SSH.	cuerda
sshPublicAccess	Estado del puerto SSH público. Los valores posibles son: Disabled: indica que el puerto ssh público está cerrado en esta instancia. Habilitado: indica que el puerto ssh público está abierto y accesible según la directiva de red virtual o subred, si procede.	'Deshabilitado' 'Habilitado'

ComputeResourceTags

Nombre	Descripción	Valor

ComputeSchedules

Nombre	Descripción	Valor
computeStartStop	Lista de programaciones de detención de detención de inicio de proceso que se van a aplicar.	ComputeStartStopSchedule[]

ComputeStartStopSchedule

Nombre	Descripción	Valor
acción	[Obligatorio] Acción de potencia de proceso.	'Start' 'Stop'
cron	Obligatorio si triggerType es Cron.	Cron
repetición	Obligatorio si triggerType es Recurrence.	de periodicidad
horario	[En desuso] No se usa más.	scheduleBase
estado	¿Está habilitada o deshabilitada la programación?	'Deshabilitado' 'Habilitado'
triggerType	[Obligatorio] Tipo de desencadenador schedule.	'Cron' 'Periodicidad'

Cron

Nombre	Descripción	Valor
expresión	[Obligatorio] Especifica la expresión cron de la programación. La expresión debe seguir el formato NCronTab.	cuerda
startTime	Hora de inicio en formato aaaa-MM-ddTHH:mm:ss.	cuerda
timeZone	Especifica la zona horaria en la que se ejecuta la programación. TimeZone debe seguir el formato de zona horaria de Windows. Consulte: /windows-hardware/manufacture/desktop/default-time-zones?view=windows-11	cuerda

Databricks

Nombre	Descripción	Valor
computeType	Tipo de proceso	'Databricks' (obligatorio)
Propiedades	Propiedades de Databricks	DatabricksProperties

DatabricksProperties

Nombre	Descripción	Valor
databricksAccessToken	Token de acceso de Databricks	cuerda
workspaceUrl	Dirección URL del área de trabajo	cuerda

DataFactory

Nombre	Descripción	Valor
computeType	Tipo de proceso	'DataFactory' (obligatorio)

DataLakeAnalytics

Nombre	Descripción	Valor
computeType	Tipo de proceso	'DataLakeAnalytics' (obligatorio)
Propiedades		DataLakeAnalyticsSchemaProperties

DataLakeAnalyticsSchemaProperties

Nombre	Descripción	Valor
dataLakeStoreAccountName	Nombre de la cuenta de DataLake Store	cuerda

HDInsight

Nombre	Descripción	Valor
computeType	Tipo de proceso	"HDInsight" (obligatorio)
Propiedades	Propiedades de proceso de HDInsight	HDInsightProperties

HDInsightProperties

Nombre	Descripción	Valor
dirección	Dirección IP pública del nodo maestro del clúster.	cuerda
administratorAccount	Credenciales de administrador para el nodo maestro del clúster	VirtualMachineSshCredentials
sshPort	Puerto abierto para conexiones ssh en el nodo maestro del clúster.	Int

InstanceResourceSchema

Nombre	Descripción	Valor

InstanceResourceSchema

Nombre	Descripción	Valor

InstanceTypeSchema

Nombre	Descripción	Valor
nodeSelector	Selector de nodos	instanceTypeSchemaNodeSelector
Recursos	Solicitudes o límites de recursos para este tipo de instancia	InstanceTypeSchemaResources

InstanceTypeSchemaNodeSelector

Nombre	Descripción	Valor

InstanceTypeSchemaResources

Nombre	Descripción	Valor
Límites	Límites de recursos para este tipo de instancia	InstanceResourceSchema
Solicitudes	Solicitudes de recursos para este tipo de instancia	InstanceResourceSchema

Kubernetes

Nombre	Descripción	Valor
computeType	Tipo de proceso	'Kubernetes' (obligatorio)
Propiedades	Propiedades de Kubernetes	KubernetesProperties

KubernetesProperties

Nombre	Descripción	Valor
defaultInstanceType	Tipo de instancia predeterminado	cuerda
extensionInstanceReleaseTrain	Entrenamiento de versión de instancia de extensión.	cuerda
extensionPrincipalId	Identificador de entidad de seguridad de extensión.	cuerda
instanceTypes	Esquema de tipo de instancia	KubernetesPropertiesInstanceTypes
espacio de nombres	Espacio de nombres de proceso	cuerda
relayConnectionString	Cadena de conexión de retransmisión.	cuerda Restricciones: Valor confidencial. Pase como parámetro seguro.
serviceBusConnectionString	Cadena de conexión de ServiceBus.	cuerda Restricciones: Valor confidencial. Pase como parámetro seguro.
vcName	Nombre de VC.	cuerda

KubernetesPropertiesInstanceTypes

Nombre	Descripción	Valor

ManagedServiceIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).	'Ninguno' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obligatorio)
userAssignedIdentities	Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.	UserAssignedIdentities