Dela via

az ml job

  • Referens

Kommentar

Den här referensen är en del av ML-tillägget för Azure CLI (version 2.15.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az ml-jobbkommando . Läs mer om tillägg.

Hantera Azure ML-jobb.

Ett Azure ML-jobb kör en aktivitet mot ett angivet beräkningsmål. Du kan konfigurera jobb för att skala ut modellträning i Azure. Azure ML har stöd för olika jobbtyper med olika funktioner. Till exempel kör det mest grundläggande jobbet, ett kommandojobb, ett kommando i en Docker-container och kan användas för träning med en nod och distribuerad träning. Ett svepjobb kör ett hyperparameter-svep över ett angivet sökutrymme för att justera en modells hyperparametrar.

Jobb möjliggör även systematisk spårning för ml-experimentering och arbetsflöden. När ett jobb har skapats behåller Azure ML en körningspost för jobbet som innehåller metadata, mått, loggar och artefakter som genererades under jobbet, kod som kördes och Azure ML-miljön som användes. Alla dina jobbs körposter kan visas i Azure ML Studio.

Kommandon

Name Description Typ Status
az ml job archive

Arkivera ett jobb.

 Anknytning Allmän tillgänglighet
az ml job cancel

Avbryt ett jobb.

 Anknytning Allmän tillgänglighet
az ml job connect-ssh

Konfigurera ssh-anslutning och skicka begäran till SSH-tjänsten som körs i användarens container via Tundra.

 Anknytning Allmän tillgänglighet
az ml job create

Skapa ett jobb.

 Anknytning Allmän tillgänglighet
az ml job download

Ladda ned alla jobbrelaterade filer.

 Anknytning Allmän tillgänglighet
az ml job list

Visa en lista över jobb på en arbetsyta.

 Anknytning Allmän tillgänglighet
az ml job restore

Återställ ett arkiverat jobb.

 Anknytning Allmän tillgänglighet
az ml job show

Visa information för ett jobb.

 Anknytning Allmän tillgänglighet
az ml job show-services

Visa tjänster för ett jobb per nod.

 Anknytning Allmän tillgänglighet
az ml job stream

Strömma jobbloggar till konsolen.

 Anknytning Allmän tillgänglighet
az ml job update

Uppdatera ett jobb.

 Anknytning Allmän tillgänglighet
az ml job validate

Verifiera ett jobb. Det här kommandot fungerar endast för pipelinejobb för tillfället.

 Anknytning Allmän tillgänglighet

az ml job archive

Arkivera ett jobb.

Om du arkiverar ett jobb döljs det som standard från listfrågor (az ml job list). Du kan fortfarande fortsätta att referera till och använda ett arkiverat jobb i dina arbetsflöden. Endast slutförda jobb kan arkiveras.

az ml job archive --name
                  --resource-group
                  --workspace-name

Obligatoriska parametrar

--name -n

Namnet på jobbet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml job cancel

Avbryt ett jobb.

az ml job cancel --name
                 --resource-group
                 --workspace-name

Exempel

Avbryt ett jobb efter namn

az ml job cancel --name my-job-id --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--name -n

Namnet på jobbet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml job connect-ssh

Konfigurera ssh-anslutning och skicka begäran till SSH-tjänsten som körs i användarens container via Tundra.

az ml job connect-ssh --name
                      --resource-group
                      --workspace-name
                      [--node-index]
                      [--private-key-file-path]

Exempel

Konfigurera ssh-anslutning och skicka begäran till SSH-tjänsten.

az ml job connect-ssh --name my-job-id --node-index 0 --private-key-file-path "C:/Temp/.ssh/id_rsa" --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--name -n

Namnet på jobbet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Valfria parametrar

--node-index -i

Indexet för noden som ska anslutas via ssh.

standardvärde: 0
--private-key-file-path -f

Sökvägen till filen med den privata nyckeln.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml job create

Skapa ett jobb.

För att skapa ett jobb måste du vanligtvis konfigurera all kod som ska köras, en miljö som kapslar in beroendena, ett beräkningsmål som jobbet ska köras på och eventuella ytterligare jobbspecifika inställningar. När ett jobb skapas skickas det för körning mot den angivna beräkningsresursen.

az ml job create --file
                 --resource-group
                 --workspace-name
                 [--name]
                 [--save-as]
                 [--set]
                 [--skip-validation]
                 [--stream]
                 [--web]

Exempel

Skapa ett jobb från en YAML-specifikationsfil

az ml job create --file job.yml --resource-group my-resource-group --workspace-name my-workspace

Skapa ett jobb från en YAML-specifikationsfil och öppna jobbets körningsinformation i Azure ML Studio-portalen

az ml job create --file job.yml --web --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--file -f

Lokal sökväg till YAML-filen som innehåller Azure ML-jobbspecifikationen. YAML-referensdokumenten för jobbet finns på: https://aka.ms/ml-cli-v2-job-command-yaml-reference, https://aka.ms/ml-cli-v2-job-sweep-yaml-reference, . https://aka.ms/ml-cli-v2-job-pipeline-yaml-reference

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Valfria parametrar

--name -n

Namnet på jobbet.

--save-as -a

Fil som det skapade jobbets tillstånd i YAML-format ska skrivas till.

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=.

--skip-validation

Hoppa över valideringen när du skapar resursen. Observera att beroende resurser inte hoppar över valideringen när de skapas.

standardvärde: False
--stream -s

Anger om jobbets loggar ska strömmas till konsolen.

standardvärde: False
--web -e

Visa jobbets körningsinformation i Azure ML Studio i en webbläsare.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml job download

Ladda ned alla jobbrelaterade filer.

Filerna laddas ned i en mapp med namnet efter jobbets namn.

az ml job download --name
                   --resource-group
                   --workspace-name
                   [--all]
                   [--download-path]
                   [--output-name]

Exempel

Ladda ned ett jobbs loggar och utdata till den aktuella arbetskatalogen

az ml job download --name my-job --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--name -n

Namnet på jobbet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Valfria parametrar

--all

Ladda ned alla utdata för jobbet.

standardvärde: False
--download-path -p

Sökväg för att ladda ned jobbfilerna till. Om det utelämnas laddas jobbfilerna ned till den aktuella katalogen.

--output-name

Namnet på de användardefinierade utdata som ska laddas ned. Detta bör motsvara en nyckel i utdataordlistan för ett jobb. Om det utelämnas laddas jobbets standardartefaktutdatafiler ned.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml job list

Visa en lista över jobb på en arbetsyta.

az ml job list --resource-group
               --workspace-name
               [--all-results {false, true}]
               [--archived-only]
               [--include-archived]
               [--max-results]
               [--parent-job-name]

Exempel

Visa en lista över alla jobbstatus på en arbetsyta med argumentet --query för att köra en JMESPath-fråga på resultatet av kommandon.

az ml job list --query "[].{Name:name,Jobstatus:status}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Valfria parametrar

--all-results

Returnerar alla resultat.

accepterade värden: false, true
standardvärde: False
--archived-only

Lista endast arkiverade jobb.

standardvärde: False
--include-archived

Lista arkiverade jobb och aktiva jobb.

standardvärde: False
--max-results -r

Maximalt antal resultat som ska returneras. Standardvärdet är 50.

standardvärde: 50
--parent-job-name -p

Namnet på det överordnade jobbet. Visar en lista över alla jobb vars parent_job_name matchar det angivna namnet.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml job restore

Återställ ett arkiverat jobb.

När ett arkiverat jobb återställs döljs det inte längre från listfrågor (az ml job list).

az ml job restore --name
                  --resource-group
                  --workspace-name

Obligatoriska parametrar

--name -n

Namnet på jobbet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml job show

Visa information för ett jobb.

az ml job show --name
               --resource-group
               --workspace-name
               [--web]

Exempel

Visa status för ett jobb med argumentet --query för att köra en JMESPath-fråga på resultatet av kommandon.

az ml job show --name my-job-id --query "{Name:name,Jobstatus:status}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--name -n

Namnet på jobbet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Valfria parametrar

--web -e

Visa jobbets körningsinformation i Azure ML Studio i en webbläsare.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml job show-services

Visa tjänster för ett jobb per nod.

az ml job show-services --name
                        --resource-group
                        --workspace-name
                        [--node-index]

Exempel

Visa tjänster för ett jobb per nod med argumentet --query för att köra en JMESPath-fråga på resultatet av kommandon.

az ml job show-services --name my-job-id --node-index 0 --query "{Name:name,Jobstatus:status}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--name -n

Namnet på jobbet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Valfria parametrar

--node-index -i

Indexet för den nod som tjänsterna måste visas för.

standardvärde: 0
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml job stream

Strömma jobbloggar till konsolen.

az ml job stream --name
                 --resource-group
                 --workspace-name

Obligatoriska parametrar

--name -n

Namnet på jobbet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml job update

Uppdatera ett jobb.

Endast egenskaperna "taggar" och "egenskaper" kan uppdateras.

az ml job update --name
                 --resource-group
                 --workspace-name
                 [--add]
                 [--force-string]
                 [--remove]
                 [--set]
                 [--web]

Obligatoriska parametrar

--name -n

Namnet på jobbet.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Valfria parametrar

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

standardvärde: []
--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

standardvärde: False
--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

standardvärde: []
--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

standardvärde: []
--web -e

Visa jobbets körningsinformation i Azure ML Studio i en webbläsare.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml job validate

Verifiera ett jobb. Det här kommandot fungerar endast för pipelinejobb för tillfället.

Det här kommandot verifierar en YAML-specifikationsfil för att kontrollera om den är giltig för jobbskapande och returnerar alla problem som hittades. Valideringen omfattar främst lokal kontroll av schema, till exempel saknade fält, miljö utan angiven version, kod som refereras till en lokal sökväg som inte finns. Den kontrollerar också om det finns referensberäkningsmål på målarbetsytan. Valideringsresultatet skrivs ut till konsolen, inklusive både fel och varningar. Endast fel gör att verifieringen misslyckas. Ett jobb som har godkänts kan skickas. Det här kommandot fungerar endast för pipelinejobb för tillfället.

az ml job validate --file
                   --resource-group
                   --workspace-name
                   [--set]

Exempel

Verifiera en YAML-specifikationsfil för att kontrollera om den är giltig för att skapa jobb.

az ml job validate --file job.yml --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--file -f

Lokal sökväg till YAML-filen som innehåller Azure ML-jobbspecifikationen. YAML-referensdokumenten för jobbet finns på: https://aka.ms/ml-cli-v2-job-pipeline-yaml-reference.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Valfria parametrar

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.