Pracovní prostory a úlohy Microsoft.MachineLearningServices 2022-05-01

  • Článek

Definice prostředku Bicep

Typ prostředku pracovních prostorů/úloh je možné nasadit s operacemi, které cílí na:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.MachineLearningServices/workspaces/jobs, přidejte do šablony následující bicep.

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/jobs@2022-05-01' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    computeId: 'string'
    description: 'string'
    displayName: 'string'
    experimentName: 'string'
    identity: {
      identityType: 'string'
      // For remaining properties, see IdentityConfiguration objects
    }
    isArchived: bool
    properties: {}
    services: {}
    tags: {}
    jobType: 'string'
    // For remaining properties, see JobBaseProperties objects
  }
}

Objekty JobBaseProperties

Nastavte vlastnost jobType a určete typ objektu.

Jako příkaz použijte:

  jobType: 'Command'
  codeId: 'string'
  command: 'string'
  distribution: {
    distributionType: 'string'
    // For remaining properties, see DistributionConfiguration objects
  }
  environmentId: 'string'
  environmentVariables: {}
  inputs: {}
  limits: {
    jobLimitsType: 'string'
    timeout: 'string'
  }
  outputs: {}
  resources: {
    instanceCount: int
    instanceType: 'string'
    properties: {}
  }

V části Kanál použijte:

  jobType: 'Pipeline'
  inputs: {}
  jobs: {}
  outputs: {}
  settings: any()

V části Uklidit použijte:

  jobType: 'Sweep'
  earlyTermination: {
    delayEvaluation: int
    evaluationInterval: int
    policyType: 'string'
    // For remaining properties, see EarlyTerminationPolicy objects
  }
  inputs: {}
  limits: {
    jobLimitsType: 'string'
    maxConcurrentTrials: int
    maxTotalTrials: int
    timeout: 'string'
    trialTimeout: 'string'
  }
  objective: {
    goal: 'string'
    primaryMetric: 'string'
  }
  outputs: {}
  samplingAlgorithm: {
    samplingAlgorithmType: 'string'
    // For remaining properties, see SamplingAlgorithm objects
  }
  searchSpace: any()
  trial: {
    codeId: 'string'
    command: 'string'
    distribution: {
      distributionType: 'string'
      // For remaining properties, see DistributionConfiguration objects
    }
    environmentId: 'string'
    environmentVariables: {}
    resources: {
      instanceCount: int
      instanceType: 'string'
      properties: {}
    }
  }

Objekty IdentityConfiguration

Nastavte vlastnost identityType a určete typ objektu.

Pro AMLToken použijte:

  identityType: 'AMLToken'

V případě spravovaného použijte:

  identityType: 'Managed'
  clientId: 'string'
  objectId: 'string'
  resourceId: 'string'

Jako UserIdentity použijte:

  identityType: 'UserIdentity'

Objekty DistributionConfiguration

Nastavte vlastnost distributionType pro určení typu objektu.

Pro Mpi použijte:

  distributionType: 'Mpi'
  processCountPerInstance: int

Pro PyTorch použijte:

  distributionType: 'PyTorch'
  processCountPerInstance: int

Pro TensorFlow použijte:

  distributionType: 'TensorFlow'
  parameterServerCount: int
  workerCount: int

Objekty EarlyTerminationPolicy

Nastavte vlastnost policyType pro určení typu objektu.

Pro Bandit použijte:

  policyType: 'Bandit'
  slackAmount: int
  slackFactor: int

Pro MedianStopping použijte:

  policyType: 'MedianStopping'

V části TruncationSelection použijte:

  policyType: 'TruncationSelection'
  truncationPercentage: int

SamplingAlgorithm – objekty

Nastavte samplingAlgorithmType vlastnost určit typ objektu.

Pro Bayesian použijte:

  samplingAlgorithmType: 'Bayesian'

Jako Mřížka použijte:

  samplingAlgorithmType: 'Grid'

V případě náhodného použití použijte:

  samplingAlgorithmType: 'Random'
  rule: 'string'
  seed: int

Hodnoty vlastností

pracovní prostory/úlohy

Název Description Hodnota
name Název prostředku

Přečtěte si, jak nastavit názvy a typy pro podřízené prostředky v Bicepu.		 string (povinné)
Nadřazené V nástroji Bicep můžete zadat nadřazený prostředek pro podřízený prostředek. Tuto vlastnost stačí přidat pouze v případě, že je podřízený prostředek deklarován mimo nadřazený prostředek.

Další informace najdete v tématu Podřízený prostředek mimo nadřazený prostředek.		 Symbolický název prostředku typu: pracovní prostory
properties [Povinné] Další atributy entity. JobBaseProperties (povinné)

JobBaseProperties

Název Description Hodnota
computeId ID prostředku ARM výpočetního prostředku řetězec
description Text popisu prostředku. řetězec
displayName Zobrazovaný název úlohy. řetězec
experimentName Název experimentu, do který úloha patří. Pokud není tato úloha nastavená, umístí se do experimentu Výchozí. řetězec
identity Konfigurace identity. Pokud je tato možnost nastavená, měla by to být jedna z hodnot AmlToken, ManagedIdentity, UserIdentity nebo null.
Výchozí hodnota je AmlToken, pokud je null.		 Konfigurace identity
isArchived Je prostředek archivovaný? bool
properties Slovník vlastností majetku. object
services Seznam koncových bodů úloh.
Pro místní úlohy bude mít koncový bod úlohy hodnotu koncového bodu FileStreamObject.		 object
tags Slovník značek. Značky je možné přidávat, odebírat a aktualizovat. object
jobType Nastavení typu objektu Příkaz
Kanál
Uklidit (povinné)

Konfigurace identity

Název Description Hodnota
identityType Nastavení typu objektu AMLToken
Spravované
UserIdentity (povinné)

AmlToken

Název Description Hodnota
identityType [Povinné] Určuje typ architektury identit. AMLToken (povinné)

Spravovaná identita

Název Description Hodnota
identityType [Povinné] Určuje typ architektury identit. Spravované (povinné)
clientId Určuje identitu přiřazenou uživatelem podle ID klienta. Pro systém přiřazené toto pole nenastavujte. řetězec

Omezení:
Minimální délka = 36
Maximální délka = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
objectId Určuje identitu přiřazenou uživatelem podle ID objektu. Pro systém přiřazené toto pole nenastavujte. řetězec

Omezení:
Minimální délka = 36
Maximální délka = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Určuje identitu přiřazenou uživatelem podle ID prostředku ARM. Pro systém přiřazené toto pole nenastavujte. řetězec

Identita uživatele

Název Description Hodnota
identityType [Povinné] Určuje typ architektury identit. UserIdentity (povinné)

Úloha příkazového řádku

Název Description Hodnota
jobType [Povinné] Určuje typ úlohy. Příkaz (povinné)
id kódu ID prostředku ARM pro prostředek kódu. řetězec
command [Povinné] Příkaz, který se má spustit při spuštění úlohy. např. "python train.py" string (povinné)

Omezení:
Minimální délka = 1
Pattern = [a-zA-Z0-9_]
Distribuce Konfigurace distribuce úlohy. Pokud je tato možnost nastavená, měla by to být hodnota Mpi, Tensorflow, PyTorch nebo null. DistributionConfiguration (Konfigurace distribuce)
environmentId [Povinné] ID prostředku ARM specifikace prostředí pro úlohu string (povinné)

Omezení:
Pattern = [a-zA-Z0-9_]
environmentVariables Proměnné prostředí zahrnuté v úloze. object
Vstupy Mapování vstupních datových vazeb používaných v úloze object
Limity Limit úlohy příkazu CommandJobLimits
Výstupy Mapování výstupních datových vazeb používaných v úloze object
resources Konfigurace výpočetních prostředků pro úlohu Konfigurace prostředků

DistributionConfiguration (Konfigurace distribuce)

Název Description Hodnota
distributionType Nastavení typu objektu Mpi
PyTorch
TensorFlow (povinné)

Mpi

Název Description Hodnota
distributionType [Povinné] Určuje typ distribuční architektury. Mpi (povinné)
processCountPerInstance Počet procesů na uzel MPI int

PyTorch

Název Description Hodnota
distributionType [Povinné] Určuje typ distribuční architektury. PyTorch (povinné)
processCountPerInstance Počet procesů na uzel int

TensorFlow

Název Description Hodnota
distributionType [Povinné] Určuje typ distribuční architektury. TensorFlow (povinné)
parametrServerCount Počet úloh serveru parametrů int
počet pracovních procesů Počet pracovních procesů Pokud není zadaný, použije se výchozí počet instancí. int

CommandJobLimits

Název Description Hodnota
jobLimitsType [Povinné] Typ JobLimit 'Příkaz'
"Uklidit" (povinné)
timeout Maximální doba běhu ve formátu ISO 8601, po jejímž uplynutí bude úloha zrušena. Podporuje pouze dobu trvání s přesností na sekundy. řetězec

Konfigurace prostředků

Název Description Hodnota
instanceCount Volitelný počet instancí nebo uzlů používaných cílovým výpočetním objektem int
typ instance Volitelný typ virtuálního počítače, který se používá jako podporovaný cílovým výpočetním objektem. řetězec
properties Další kontejner vlastností. object

Úloha kanálu

Název Description Hodnota
typ úlohy [Povinné] Určuje typ úlohy. Kanál (povinné)
Vstupy Vstupy pro úlohu kanálu. object
Úlohy Úlohy vytvoří úlohu kanálu. object
Výstupy Výstupy pro úlohu kanálu object
nastavení Nastavení kanálu, například ContinueRunOnStepFailure atd. Pro Bicep můžete použít funkci any().

SweepJob

Název Description Hodnota
typ úlohy [Povinné] Určuje typ úlohy. "Uklidit" (povinné)
earlyTermination Zásady předčasného ukončení umožňují zrušit spuštění s nízkým výkonem před jejich dokončením. EarlyTerminationPolicy
Vstupy Mapování vstupních datových vazeb použitých v úloze object
Limity Limit úlohy úklidu. SweepJobLimits
Cílem [Povinné] Cíl optimalizace. Cíl (povinné)
Výstupy Mapování výstupních datových vazeb použitých v úloze object
samplingAlgorithm [Povinné] Algoritmus vzorkování hyperparametrů SamplingAlgorithm (povinné)
prostor vyhledávání [Povinné] Slovník obsahující každý parametr a jeho distribuci. Klíč slovníku je název parametru. Pro Bicep můžete použít funkci any(). (povinné)
trial [Povinné] Definice zkušební komponenty TrialComponent (povinné)

EarlyTerminationPolicy

Název Description Hodnota
delayEvaluation Počet intervalů, o které se má zpozdit první vyhodnocení int
evaluationInterval Interval (počet spuštění) mezi vyhodnoceními zásad int
policyType Nastavení typu objektu Bandita
MediánStopping
TruncationSelection (povinné)

Zásady bandit

Název Description Hodnota
policyType [Povinné] Název konfigurace zásad 'Bandit' (povinné)
slackAmount Je povolená absolutní vzdálenost od běhu s nejlepším výkonem. int
SlackFactor Poměr povolené vzdálenosti od nejvýkonnějšího běhu int

Zásady medianStoppingPolicy

Název Description Hodnota
policyType [Povinné] Název konfigurace zásad 'MedianStopping' (povinné)

TruncationSelectionPolicy

Název Description Hodnota
policyType [Povinné] Název konfigurace zásad TruncationSelection (povinné)
truncationPercentage Procento spuštění, která se mají zrušit v každém intervalu vyhodnocení. int

SweepJobLimits

Název Description Hodnota
jobLimitsType [Povinné] Typ JobLimit 'Příkaz'
"Uklidit" (povinné)
maxConcurrentTrials Maximální počet souběžných zkušebních verzí úlohy úklidu. int
maxTotalTrials Úklidová úloha – maximální celkový počet pokusů. int
timeout Maximální doba běhu ve formátu ISO 8601, po jejímž uplynutí bude úloha zrušena. Podporuje pouze dobu trvání s přesností na sekundy. řetězec
trialTimeout Hodnota časového limitu zkušební úlohy úklidu řetězec

Cíl

Název Description Hodnota
goal [Povinné] Definuje podporované cíle metrik pro ladění hyperparametrů. Maximalizovat
Minimalizovat (povinné)
primaryMetric [Povinné] Název metriky, která se má optimalizovat. string (povinné)

Omezení:
Vzor = [a-zA-Z0-9_]

SamplingAlgorithm

Název Description Hodnota
samplingAlgorithmType Nastavení typu objektu Bayesovské
Mřížky
Náhodné (povinné)

BayesianSamplingAlgorithm

Název Description Hodnota
samplingAlgorithmType [Povinné] Algoritmus používaný pro generování hodnot hyperparametrů spolu s vlastnostmi konfigurace "Bayesian" (povinné)

GridSamplingAlgorithm

Název Description Hodnota
samplingAlgorithmType [Povinné] Algoritmus používaný pro generování hodnot hyperparametrů spolu s vlastnostmi konfigurace "Mřížka" (povinné)

RandomSamplingAlgorithm

Název Description Hodnota
samplingAlgorithmType [Povinné] Algoritmus používaný pro generování hodnot hyperparametrů spolu s vlastnostmi konfigurace 'Random' (povinné)
Pravidlo Konkrétní typ náhodného algoritmu 'Random'
'Sobol'
Osiva Volitelné celé číslo, které se použije jako počáteční hodnota pro generování náhodných čísel int

Zkušební verze

Název Description Hodnota
id kódu ID prostředku ARM pro prostředek kódu. řetězec
command [Povinné] Příkaz, který se má spustit při spuštění úlohy. např. "python train.py" string (povinné)

Omezení:
Minimální délka = 1
Pattern = [a-zA-Z0-9_]
Distribuce Konfigurace distribuce úlohy. Pokud je tato možnost nastavená, měla by to být hodnota Mpi, Tensorflow, PyTorch nebo null. DistributionConfiguration (Konfigurace distribuce)
environmentId [Povinné] ID prostředku ARM specifikace prostředí pro úlohu string (povinné)

Omezení:
Pattern = [a-zA-Z0-9_]
environmentVariables Proměnné prostředí zahrnuté v úloze. object
resources Konfigurace výpočetních prostředků pro úlohu Konfigurace prostředků

Šablony pro rychlý start

Následující šablony rychlého startu nasadí tento typ prostředku.

Template (Šablona) Description
Vytvoření úlohy klasifikace automatického strojového učení služby Azure Machine Learning

Nasazení do Azure		 Tato šablona vytvoří úlohu klasifikace Automatického strojového učení služby Azure Machine Learning, která zjistí nejlepší model pro předpovídání, jestli se klient přihlásí k odběru vkladu s pevným termínem u finanční instituce.
Vytvoření úlohy příkazů služby Azure Machine Learning

Nasazení do Azure		 Tato šablona vytvoří úlohu příkazu Služby Azure Machine Learning se základním hello_world skriptem.
Vytvoření úlohy úklidu služby Azure Machine Learning

Nasazení do Azure		 Tato šablona vytvoří úlohu Azure Machine Learning Sweep pro ladění hyperparametrů.

Definice prostředku šablony ARM

Typ prostředku pracovních prostorů/úloh je možné nasadit s operacemi, které cílí na:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.MachineLearningServices/workspaces/jobs, přidejte do šablony následující kód JSON.

{
  "type": "Microsoft.MachineLearningServices/workspaces/jobs",
  "apiVersion": "2022-05-01",
  "name": "string",
  "properties": {
    "computeId": "string",
    "description": "string",
    "displayName": "string",
    "experimentName": "string",
    "identity": {
      "identityType": "string"
      // For remaining properties, see IdentityConfiguration objects
    },
    "isArchived": "bool",
    "properties": {},
    "services": {},
    "tags": {},
    "jobType": "string"
    // For remaining properties, see JobBaseProperties objects
  }
}

Objekty JobBaseProperties

Nastavte vlastnost jobType a určete typ objektu.

Jako příkaz použijte:

  "jobType": "Command",
  "codeId": "string",
  "command": "string",
  "distribution": {
    "distributionType": "string"
    // For remaining properties, see DistributionConfiguration objects
  },
  "environmentId": "string",
  "environmentVariables": {},
  "inputs": {},
  "limits": {
    "jobLimitsType": "string",
    "timeout": "string"
  },
  "outputs": {},
  "resources": {
    "instanceCount": "int",
    "instanceType": "string",
    "properties": {}
  }

V části Kanál použijte:

  "jobType": "Pipeline",
  "inputs": {},
  "jobs": {},
  "outputs": {},
  "settings": {}

V části Uklidit použijte:

  "jobType": "Sweep",
  "earlyTermination": {
    "delayEvaluation": "int",
    "evaluationInterval": "int",
    "policyType": "string"
    // For remaining properties, see EarlyTerminationPolicy objects
  },
  "inputs": {},
  "limits": {
    "jobLimitsType": "string",
    "maxConcurrentTrials": "int",
    "maxTotalTrials": "int",
    "timeout": "string",
    "trialTimeout": "string"
  },
  "objective": {
    "goal": "string",
    "primaryMetric": "string"
  },
  "outputs": {},
  "samplingAlgorithm": {
    "samplingAlgorithmType": "string"
    // For remaining properties, see SamplingAlgorithm objects
  },
  "searchSpace": {},
  "trial": {
    "codeId": "string",
    "command": "string",
    "distribution": {
      "distributionType": "string"
      // For remaining properties, see DistributionConfiguration objects
    },
    "environmentId": "string",
    "environmentVariables": {},
    "resources": {
      "instanceCount": "int",
      "instanceType": "string",
      "properties": {}
    }
  }

Objekty IdentityConfiguration

Nastavte vlastnost identityType a určete typ objektu.

Pro AMLToken použijte:

  "identityType": "AMLToken"

V případě spravovaného použijte:

  "identityType": "Managed",
  "clientId": "string",
  "objectId": "string",
  "resourceId": "string"

Jako UserIdentity použijte:

  "identityType": "UserIdentity"

Objekty DistributionConfiguration

Nastavte vlastnost distributionType pro určení typu objektu.

Pro Mpi použijte:

  "distributionType": "Mpi",
  "processCountPerInstance": "int"

Pro PyTorch použijte:

  "distributionType": "PyTorch",
  "processCountPerInstance": "int"

Pro TensorFlow použijte:

  "distributionType": "TensorFlow",
  "parameterServerCount": "int",
  "workerCount": "int"

Objekty EarlyTerminationPolicy

Nastavte vlastnost policyType pro určení typu objektu.

Pro Bandit použijte:

  "policyType": "Bandit",
  "slackAmount": "int",
  "slackFactor": "int"

Pro MedianStopping použijte:

  "policyType": "MedianStopping"

V části TruncationSelection použijte:

  "policyType": "TruncationSelection",
  "truncationPercentage": "int"

SamplingAlgorithm – objekty

Nastavte samplingAlgorithmType vlastnost určit typ objektu.

Pro Bayesian použijte:

  "samplingAlgorithmType": "Bayesian"

Jako Mřížka použijte:

  "samplingAlgorithmType": "Grid"

V případě náhodného použití použijte:

  "samplingAlgorithmType": "Random",
  "rule": "string",
  "seed": "int"

Hodnoty vlastností

pracovní prostory/úlohy

Název Description Hodnota
typ Typ prostředku Microsoft.MachineLearningServices/workspaces/jobs
apiVersion Verze rozhraní API prostředků '2022-05-01'
name Název prostředku

Podívejte se, jak nastavit názvy a typy pro podřízené prostředky v šablonách JSON ARM.		 string (povinné)
properties [Povinné] Další atributy entity. JobBaseProperties (povinné)

JobBaseProperties

Název Description Hodnota
computeId ID prostředku ARM výpočetního prostředku řetězec
description Text popisu prostředku. řetězec
displayName Zobrazovaný název úlohy. řetězec
experimentName Název experimentu, do který úloha patří. Pokud není tato úloha nastavená, umístí se do experimentu Výchozí. řetězec
identity Konfigurace identity. Pokud je tato možnost nastavená, měla by to být jedna z hodnot AmlToken, ManagedIdentity, UserIdentity nebo null.
Výchozí hodnota je AmlToken, pokud je null.		 Konfigurace identity
isArchived Je prostředek archivovaný? bool
properties Slovník vlastností majetku. object
services Seznam koncových bodů úloh.
Pro místní úlohy bude mít koncový bod úlohy hodnotu koncového bodu FileStreamObject.		 object
tags Slovník značek. Značky je možné přidávat, odebírat a aktualizovat. object
jobType Nastavení typu objektu Příkaz
Kanál
Uklidit (povinné)

Konfigurace identity

Název Description Hodnota
identityType Nastavení typu objektu AMLToken
Spravované
UserIdentity (povinné)

AmlToken

Název Description Hodnota
identityType [Povinné] Určuje typ architektury identit. AMLToken (povinné)

Spravovaná identita

Název Description Hodnota
identityType [Povinné] Určuje typ architektury identit. Spravované (povinné)
clientId Určuje identitu přiřazenou uživatelem podle ID klienta. Pro systém přiřazené toto pole nenastavujte. řetězec

Omezení:
Minimální délka = 36
Maximální délka = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
objectId Určuje identitu přiřazenou uživatelem podle ID objektu. Pro systém přiřazené toto pole nenastavujte. řetězec

Omezení:
Minimální délka = 36
Maximální délka = 36
Vzor = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Určuje identitu přiřazenou uživatelem podle ID prostředku ARM. V případě přiřazení systémem toto pole nenastavujte. řetězec

Identita uživatele

Název Description Hodnota
identityType [Povinné] Určuje typ architektury identit. UserIdentity (povinné)

Úloha příkazového řádku

Název Description Hodnota
typ úlohy [Povinné] Určuje typ úlohy. Příkaz (povinné)
id kódu ID prostředku ARM prostředku kódu. řetězec
command [Povinné] Příkaz, který se spustí při spuštění úlohy. např. "python train.py" string (povinné)

Omezení:
Minimální délka = 1
Vzor = [a-zA-Z0-9_]
Distribuce Konfigurace distribuce úlohy. Pokud je nastavená hodnota, měla by to být hodnota Mpi, Tensorflow, PyTorch nebo null. Konfigurace distribuce
id prostředí [Povinné] ID prostředku ARM specifikace prostředí pro úlohu. string (povinné)

Omezení:
Vzor = [a-zA-Z0-9_]
environmentVariables Proměnné prostředí zahrnuté v úloze object
Vstupy Mapování vstupních datových vazeb použitých v úloze object
Limity Limit úlohy příkazu CommandJobLimits
Výstupy Mapování výstupních datových vazeb použitých v úloze object
resources Konfigurace výpočetního prostředku pro úlohu Konfigurace prostředků

Konfigurace distribuce

Název Description Hodnota
distributionType Nastavení typu objektu Mpi
PyTorch
TensorFlow (povinné)

Mpi

Název Description Hodnota
distributionType [Povinné] Určuje typ distribuční architektury. Mpi (povinné)
processCountPerInstance Počet procesů na uzel MPI int

PyTorch

Název Description Hodnota
distributionType [Povinné] Určuje typ distribuční architektury. PyTorch (povinné)
processCountPerInstance Počet procesů na uzel int

TensorFlow

Název Description Hodnota
distributionType [Povinné] Určuje typ distribuční architektury. TensorFlow (povinné)
parametrServerCount Počet úloh serveru parametrů int
počet pracovních procesů Počet pracovních procesů Pokud není zadaný, použije se výchozí počet instancí. int

CommandJobLimits

Název Description Hodnota
jobLimitsType [Povinné] Typ JobLimit. 'Příkaz'
"Uklidit" (povinné)
timeout Maximální doba spuštění ve formátu ISO 8601, po jejímž uplynutí bude úloha zrušena. Podporuje pouze dobu trvání s přesností na sekundy. řetězec

Konfigurace prostředků

Název Description Hodnota
instanceCount Volitelný počet instancí nebo uzlů používaných cílovým výpočetním objektem int
instanceType Volitelný typ virtuálního počítače, který je podporován cílovým výpočetním prostředím. řetězec
properties Další vlastnosti taška. object

Úloha kanálu

Název Description Hodnota
jobType [Povinné] Určuje typ úlohy. Kanál (povinné)
Vstupy Vstupy pro úlohu kanálu. object
Úlohy Úlohy vytvoří úlohu kanálu. object
Výstupy Výstupy pro úlohu kanálu object
nastavení Nastavení kanálu, například ContinueRunOnStepFailure atd.

Úloha úklidu

Název Description Hodnota
jobType [Povinné] Určuje typ úlohy. "Uklidit" (povinné)
earlyTermination Zásady předčasného ukončení umožňují zrušit spuštění s nízkým výkonem před jejich dokončením. EarlyTerminationPolicy
Vstupy Mapování vstupních datových vazeb používaných v úloze object
Limity Limit úlohy úklidu. SweepJobLimits
Cílem [Povinné] Cíl optimalizace. Cíl (povinné)
Výstupy Mapování výstupních datových vazeb používaných v úloze object
samplingAlgorithm [Povinné] Algoritmus vzorkování hyperparametrů SamplingAlgorithm (povinné)
searchSpace [Povinné] Slovník obsahující každý parametr a jeho distribuci. Klíč slovníku je název parametru.
trial [Povinné] Definice zkušební komponenty. Zkušební verze ( povinné)

EarlyTerminationPolicy

Název Description Hodnota
delayEvaluation Počet intervalů, o které se má zpozdit první vyhodnocení int
evaluationInterval Interval (počet spuštění) mezi vyhodnoceními zásad int
policyType Nastavení typu objektu Bandita
MediánStopping
TruncationSelection (povinné)

BanditPolicy

Název Description Hodnota
policyType [Povinné] Název konfigurace zásad 'Bandit' (povinné)
slackAmount Je povolená absolutní vzdálenost od nejvýkonnějšího běhu. int
slackFactor Poměr povolené vzdálenosti od nejvýkonnějšího běhu int

Zásady medianStoppingPolicy

Název Description Hodnota
policyType [Povinné] Název konfigurace zásad 'MedianStopping' (povinné)

TruncationSelectionPolicy

Název Description Hodnota
policyType [Povinné] Název konfigurace zásad TruncationSelection (povinné)
truncationPercentage Procento spuštění, která se mají zrušit v každém intervalu vyhodnocení. int

SweepJobLimits

Název Description Hodnota
jobLimitsType [Povinné] Typ JobLimit 'Příkaz'
"Uklidit" (povinné)
maxConcurrentTrials Maximální počet souběžných zkušebních verzí úlohy úklidu. int
maxTotalTrials Úklidová úloha – maximální celkový počet pokusů. int
timeout Maximální doba běhu ve formátu ISO 8601, po jejímž uplynutí bude úloha zrušena. Podporuje pouze dobu trvání s přesností na sekundy. řetězec
trialTimeout Hodnota časového limitu zkušební úlohy úklidu řetězec

Cíl

Název Description Hodnota
goal [Povinné] Definuje podporované cíle metrik pro ladění hyperparametrů. Maximalizovat
Minimalizovat (povinné)
primaryMetric [Povinné] Název metriky, která se má optimalizovat. string (povinné)

Omezení:
Vzor = [a-zA-Z0-9_]

SamplingAlgorithm

Název Description Hodnota
samplingAlgorithmType Nastavení typu objektu Bayesovské
Mřížky
Náhodné (povinné)

BayesianSamplingAlgorithm

Název Description Hodnota
samplingAlgorithmType [Povinné] Algoritmus používaný ke generování hodnot hyperparametrů spolu s vlastnostmi konfigurace "Bayesovské" (povinné)

GridSamplingAlgorithm

Název Description Hodnota
samplingAlgorithmType [Povinné] Algoritmus používaný ke generování hodnot hyperparametrů spolu s vlastnostmi konfigurace 'Mřížka' (povinné)

RandomSamplingAlgorithm

Název Description Hodnota
samplingAlgorithmType [Povinné] Algoritmus používaný ke generování hodnot hyperparametrů spolu s vlastnostmi konfigurace 'Random' (povinné)
Pravidlo Konkrétní typ náhodného algoritmu 'Random'
'Sobol'
Osiva Volitelné celé číslo, které se použije jako počáteční hodnota pro generování náhodných čísel int

TrialComponent

Název Description Hodnota
id kódu ID prostředku ARM prostředku kódu. řetězec
command [Povinné] Příkaz, který se spustí při spuštění úlohy. např. "python train.py" string (povinné)

Omezení:
Minimální délka = 1
Pattern = [a-zA-Z0-9_]
Distribuce Konfigurace distribuce úlohy. Pokud je tato možnost nastavená, měla by to být hodnota Mpi, Tensorflow, PyTorch nebo null. DistributionConfiguration (Konfigurace distribuce)
environmentId [Povinné] ID prostředku ARM specifikace prostředí pro úlohu string (povinné)

Omezení:
Pattern = [a-zA-Z0-9_]
environmentVariables Proměnné prostředí zahrnuté v úloze. object
resources Konfigurace výpočetních prostředků pro úlohu Konfigurace prostředků

Šablony pro rychlý start

Následující šablony rychlého startu nasadí tento typ prostředku.

Template (Šablona) Description
Vytvoření úlohy klasifikace automatického strojového učení služby Azure Machine Learning

Nasazení do Azure		 Tato šablona vytvoří úlohu klasifikace Automatického strojového učení služby Azure Machine Learning, která zjistí nejlepší model pro předpovídání, jestli se klient přihlásí k odběru vkladu s pevným termínem u finanční instituce.
Vytvoření úlohy příkazů služby Azure Machine Learning

Nasazení do Azure		 Tato šablona vytvoří úlohu příkazu Služby Azure Machine Learning se základním hello_world skriptem.
Vytvoření úlohy úklidu služby Azure Machine Learning

Nasazení do Azure		 Tato šablona vytvoří úlohu Azure Machine Learning Sweep pro ladění hyperparametrů.

Definice prostředku Terraformu (zprostředkovatele AzAPI)

Typ prostředku pracovních prostorů/úloh je možné nasadit s operacemi, které cílí na:

  • Skupiny prostředků

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.MachineLearningServices/workspaces/jobs, přidejte do šablony následující Terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/jobs@2022-05-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      computeId = "string"
      description = "string"
      displayName = "string"
      experimentName = "string"
      identity = {
        identityType = "string"
        // For remaining properties, see IdentityConfiguration objects
      }
      isArchived = bool
      properties = {}
      services = {}
      tags = {}
      jobType = "string"
      // For remaining properties, see JobBaseProperties objects
    }
  })
}

Objekty JobBaseProperties

Nastavte vlastnost jobType a určete typ objektu.

Jako příkaz použijte:

  jobType = "Command"
  codeId = "string"
  command = "string"
  distribution = {
    distributionType = "string"
    // For remaining properties, see DistributionConfiguration objects
  }
  environmentId = "string"
  environmentVariables = {}
  inputs = {}
  limits = {
    jobLimitsType = "string"
    timeout = "string"
  }
  outputs = {}
  resources = {
    instanceCount = int
    instanceType = "string"
    properties = {}
  }

V části Kanál použijte:

  jobType = "Pipeline"
  inputs = {}
  jobs = {}
  outputs = {}

V části Uklidit použijte:

  jobType = "Sweep"
  earlyTermination = {
    delayEvaluation = int
    evaluationInterval = int
    policyType = "string"
    // For remaining properties, see EarlyTerminationPolicy objects
  }
  inputs = {}
  limits = {
    jobLimitsType = "string"
    maxConcurrentTrials = int
    maxTotalTrials = int
    timeout = "string"
    trialTimeout = "string"
  }
  objective = {
    goal = "string"
    primaryMetric = "string"
  }
  outputs = {}
  samplingAlgorithm = {
    samplingAlgorithmType = "string"
    // For remaining properties, see SamplingAlgorithm objects
  }
  trial = {
    codeId = "string"
    command = "string"
    distribution = {
      distributionType = "string"
      // For remaining properties, see DistributionConfiguration objects
    }
    environmentId = "string"
    environmentVariables = {}
    resources = {
      instanceCount = int
      instanceType = "string"
      properties = {}
    }
  }

Objekty IdentityConfiguration

Nastavte vlastnost identityType a určete typ objektu.

Pro AMLToken použijte:

  identityType = "AMLToken"

V případě spravovaného použijte:

  identityType = "Managed"
  clientId = "string"
  objectId = "string"
  resourceId = "string"

Jako UserIdentity použijte:

  identityType = "UserIdentity"

Objekty DistributionConfiguration

Nastavte vlastnost distributionType pro určení typu objektu.

Pro Mpi použijte:

  distributionType = "Mpi"
  processCountPerInstance = int

Pro PyTorch použijte:

  distributionType = "PyTorch"
  processCountPerInstance = int

Pro TensorFlow použijte:

  distributionType = "TensorFlow"
  parameterServerCount = int
  workerCount = int

Objekty EarlyTerminationPolicy

Nastavte vlastnost policyType pro určení typu objektu.

Pro Bandit použijte:

  policyType = "Bandit"
  slackAmount = int
  slackFactor = int

Pro MedianStopping použijte:

  policyType = "MedianStopping"

V části TruncationSelection použijte:

  policyType = "TruncationSelection"
  truncationPercentage = int

SamplingAlgorithm – objekty

Nastavte samplingAlgorithmType vlastnost určit typ objektu.

Pro Bayesian použijte:

  samplingAlgorithmType = "Bayesian"

Jako Mřížka použijte:

  samplingAlgorithmType = "Grid"

V případě náhodného použití použijte:

  samplingAlgorithmType = "Random"
  rule = "string"
  seed = int

Hodnoty vlastností

pracovní prostory/úlohy

Název Description Hodnota
typ Typ prostředku Microsoft.MachineLearningServices/workspaces/jobs@2022-05-01
name Název prostředku string (povinné)
parent_id ID prostředku, který je nadřazený pro tento prostředek. ID prostředku typu: pracovní prostory
properties [Povinné] Další atributy entity. JobBaseProperties (povinné)

JobBaseProperties

Název Description Hodnota
computeId ID prostředku ARM výpočetního prostředku řetězec
description Text popisu prostředku. řetězec
displayName Zobrazovaný název úlohy. řetězec
experimentName Název experimentu, do který úloha patří. Pokud není tato úloha nastavená, umístí se do experimentu Výchozí. řetězec
identity Konfigurace identity. Pokud je nastaveno, měl by to být AmlToken, ManagedIdentity, UserIdentity nebo null.
Výchozí hodnota je AmlToken, pokud je null.		 Konfigurace identity
isArchived Je prostředek archivovaný? bool
properties Slovník vlastností majetku. object
services Seznam koncových bodů úloh.
Pro místní úlohy bude koncový bod úlohy mít hodnotu koncového bodu FileStreamObject.		 object
tags Slovník značek. Značky je možné přidávat, odebírat a aktualizovat. object
typ úlohy Nastavení typu objektu Příkaz
Kanál
Uklidit (povinné)

Konfigurace identity

Název Description Hodnota
identityType Nastavení typu objektu AMLToken
Spravované
Identita uživatele (povinné)

AmlToken

Název Description Hodnota
identityType [Povinné] Určuje typ architektury identit. "AMLToken" (povinné)

Spravovaná identita

Název Description Hodnota
identityType [Povinné] Určuje typ architektury identit. "Spravované" (povinné)
clientId Určuje identitu přiřazenou uživatelem podle ID klienta. V případě přiřazení systémem toto pole nenastavujte. řetězec

Omezení:
Minimální délka = 36
Maximální délka = 36
Vzor = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
objectId Určuje identitu přiřazenou uživatelem podle ID objektu. V případě přiřazení systémem toto pole nenastavujte. řetězec

Omezení:
Minimální délka = 36
Maximální délka = 36
Vzor = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Určuje identitu přiřazenou uživatelem podle ID prostředku ARM. V případě přiřazení systémem toto pole nenastavujte. řetězec

Identita uživatele

Název Description Hodnota
identityType [Povinné] Určuje typ architektury identit. "UserIdentity" (povinné)

Úloha příkazového řádku

Název Description Hodnota
typ úlohy [Povinné] Určuje typ úlohy. "Příkaz" (povinné)
id kódu ID prostředku ARM prostředku kódu. řetězec
command [Povinné] Příkaz, který se spustí při spuštění úlohy. např. "python train.py" string (povinné)

Omezení:
Minimální délka = 1
Vzor = [a-zA-Z0-9_]
Distribuce Konfigurace distribuce úlohy. Pokud je nastavená hodnota, měla by to být hodnota Mpi, Tensorflow, PyTorch nebo null. Konfigurace distribuce
id prostředí [Povinné] ID prostředku ARM specifikace prostředí pro úlohu. string (povinné)

Omezení:
Vzor = [a-zA-Z0-9_]
environmentVariables Proměnné prostředí zahrnuté v úloze object
Vstupy Mapování vstupních datových vazeb použitých v úloze object
Limity Limit úlohy příkazu CommandJobLimits
Výstupy Mapování výstupních datových vazeb použitých v úloze object
resources Konfigurace výpočetního prostředku pro úlohu Konfigurace prostředků

Konfigurace distribuce

Název Description Hodnota
distributionType Nastavení typu objektu Mpi
PyTorch
TensorFlow (povinné)

Mpi

Název Description Hodnota
distributionType [Povinné] Určuje typ distribuční architektury. "Mpi" (povinné)
processCountPerInstance Počet procesů na uzel MPI int

PyTorch

Název Description Hodnota
distributionType [Povinné] Určuje typ distribuční architektury. "PyTorch" (povinné)
processCountPerInstance Počet procesů na uzel int

TensorFlow

Název Description Hodnota
distributionType [Povinné] Určuje typ distribuční architektury. "TensorFlow" (povinné)
parametrServerCount Počet úloh serveru parametrů int
počet pracovních procesů Počet pracovních procesů Pokud není zadaný, použije se výchozí počet instancí. int

CommandJobLimits

Název Description Hodnota
jobLimitsType [Povinné] Typ JobLimit "Příkaz"
"Uklidit" (povinné)
timeout Maximální doba běhu ve formátu ISO 8601, po jejímž uplynutí bude úloha zrušena. Podporuje pouze dobu trvání s přesností na sekundy. řetězec

Konfigurace prostředků

Název Description Hodnota
instanceCount Volitelný počet instancí nebo uzlů používaných cílovým výpočetním objektem int
typ instance Volitelný typ virtuálního počítače, který se používá jako podporovaný cílovým výpočetním objektem. řetězec
properties Další kontejner vlastností. object

Úloha kanálu

Název Description Hodnota
typ úlohy [Povinné] Určuje typ úlohy. "Kanál" (povinné)
Vstupy Vstupy pro úlohu kanálu. object
Úlohy Úlohy vytvoří úlohu kanálu. object
Výstupy Výstupy pro úlohu kanálu object
nastavení Nastavení kanálu, například ContinueRunOnStepFailure atd.

SweepJob

Název Description Hodnota
typ úlohy [Povinné] Určuje typ úlohy. "Uklidit" (povinné)
earlyTermination Zásady předčasného ukončení umožňují zrušit spuštění s nízkým výkonem před jejich dokončením. EarlyTerminationPolicy
Vstupy Mapování vstupních datových vazeb použitých v úloze object
Limity Limit úlohy úklidu. SweepJobLimits
Cílem [Povinné] Cíl optimalizace. Cíl (povinné)
Výstupy Mapování výstupních datových vazeb použitých v úloze object
samplingAlgorithm [Povinné] Algoritmus vzorkování hyperparametrů SamplingAlgorithm (povinné)
prostor vyhledávání [Povinné] Slovník obsahující každý parametr a jeho distribuci. Klíč slovníku je název parametru.
trial [Povinné] Definice zkušební komponenty TrialComponent (povinné)

EarlyTerminationPolicy

Název Description Hodnota
delayEvaluation Počet intervalů, o které se má zpozdit první vyhodnocení int
evaluationInterval Interval (počet spuštění) mezi vyhodnoceními zásad int
policyType Nastavení typu objektu Bandita
MediánStopping
TruncationSelection (povinné)

Zásady bandit

Název Description Hodnota
policyType [Povinné] Název konfigurace zásad "Bandit" (povinné)
slackAmount Je povolená absolutní vzdálenost od běhu s nejlepším výkonem. int
SlackFactor Poměr povolené vzdálenosti od nejvýkonnějšího běhu int

Zásady medianStoppingPolicy

Název Description Hodnota
policyType [Povinné] Název konfigurace zásad "MedianStopping" (povinné)

TruncationSelectionPolicy

Název Description Hodnota
policyType [Povinné] Název konfigurace zásad "TruncationSelection" (povinné)
truncationPercentage Procento spuštění, která se mají zrušit v každém intervalu vyhodnocení. int

SweepJobLimits

Název Description Hodnota
jobLimitsType [Povinné] Typ JobLimit "Příkaz"
"Uklidit" (povinné)
maxConcurrentTrials Maximální počet souběžných zkušebních verzí úlohy úklidu. int
maxTotalTrials Úklidová úloha – maximální celkový počet pokusů. int
timeout Maximální doba běhu ve formátu ISO 8601, po jejímž uplynutí bude úloha zrušena. Podporuje pouze dobu trvání s přesností na sekundy. řetězec
trialTimeout Hodnota časového limitu zkušební úlohy úklidu řetězec

Cíl

Název Description Hodnota
goal [Povinné] Definuje podporované cíle metrik pro ladění hyperparametrů. "Maximalizovat"
"Minimalizovat" (povinné)
primaryMetric [Povinné] Název metriky, která se má optimalizovat. string (povinné)

Omezení:
Vzor = [a-zA-Z0-9_]

SamplingAlgorithm

Název Description Hodnota
samplingAlgorithmType Nastavení typu objektu Bayesovské
Mřížky
Náhodné (povinné)

BayesianSamplingAlgorithm

Název Description Hodnota
samplingAlgorithmType [Povinné] Algoritmus používaný ke generování hodnot hyperparametrů spolu s vlastnostmi konfigurace "Bayesian" (povinné)

GridSamplingAlgorithm

Název Description Hodnota
samplingAlgorithmType [Povinné] Algoritmus používaný ke generování hodnot hyperparametrů spolu s vlastnostmi konfigurace "Mřížka" (povinné)

RandomSamplingAlgorithm

Název Description Hodnota
samplingAlgorithmType [Povinné] Algoritmus používaný ke generování hodnot hyperparametrů spolu s vlastnostmi konfigurace "Random" (povinné)
Pravidlo Konkrétní typ náhodného algoritmu "Random"
"Sobol"
Osiva Volitelné celé číslo, které se použije jako počáteční hodnota pro generování náhodných čísel int

TrialComponent

Název Description Hodnota
id kódu ID prostředku ARM prostředku kódu. řetězec
command [Povinné] Příkaz, který se spustí při spuštění úlohy. např. "python train.py" string (povinné)

Omezení:
Minimální délka = 1
Vzor = [a-zA-Z0-9_]
Distribuce Konfigurace distribuce úlohy. Pokud je nastavená hodnota, měla by to být hodnota Mpi, Tensorflow, PyTorch nebo null. Konfigurace distribuce
id prostředí [Povinné] ID prostředku ARM specifikace prostředí pro úlohu. string (povinné)

Omezení:
Vzor = [a-zA-Z0-9_]
environmentVariables Proměnné prostředí zahrnuté v úloze object
resources Konfigurace výpočetního prostředku pro úlohu Konfigurace prostředků