az ml component

  • 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-komponentkommando . Läs mer om tillägg.

Hantera Azure ML-komponenter.

Azure ML-komponenten definierar konfigurationen av komponenten för pipelinejobb. Du kan konfigurera in- och utdataportarna, körningsmiljön och kommandot för komponenten. När komponenten har skapats kan du referera till komponenterna i pipelinejobbet för att köra dem i Docker-containrar.

Kommandon

Name Description Typ Status
az ml component archive

Arkivera en komponent.

 Anknytning Allmän tillgänglighet
az ml component create

Skapa en komponent.

 Anknytning Allmän tillgänglighet
az ml component list

Visa en lista över komponenter i en arbetsyta.

 Anknytning Allmän tillgänglighet
az ml component restore

Återställ en arkiverad komponent.

 Anknytning Allmän tillgänglighet
az ml component show

Visa information för en komponent.

 Anknytning Allmän tillgänglighet
az ml component update

Uppdatera en komponent. För närvarande stöder endast ett fåtal fält (beskrivning, display_name) uppdatering.

 Anknytning Allmän tillgänglighet

az ml component archive

Arkivera en komponent.

Om du arkiverar en komponent döljs den som standard från listfrågor (az ml component list). Du kan fortfarande fortsätta att referera till och använda en arkiverad komponent i dina pipelines. Du kan arkivera antingen en komponentcontainer eller en specifik komponentversion. Om du arkiverar en komponentcontainer arkiveras alla versioner av komponenten under det förnamnet. Du kan återställa en arkiverad komponent med hjälp av az ml component restore. Om hela komponentcontainern arkiveras kan du inte återställa enskilda versioner av komponenten – du måste återställa komponentcontainern.

az ml component archive --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

Exempel

Arkivera en komponentcontainer (arkiverar alla versioner av komponenten)

az ml component archive --name my-component --resource-group my-resource-group --workspace-name my-workspace

Arkivera en specifik komponentversion

az ml component archive --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--name -n

Komponentens namn.

Valfria parametrar

--label -l

Komponentens etikett.

--registry-name

Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta.

--resource-group -g

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

--version -v

Version av komponenten.

--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 component create

Skapa en komponent.

az ml component create --file
                       [--name]
                       [--registry-name]
                       [--resource-group]
                       [--set]
                       [--skip-validation]
                       [--version]
                       [--workspace-name]

Exempel

Skapa en komponent från en YAML-specifikationsfil

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

Skapa en komponent från en YAML-specifikationsfil med angiven version

az ml component create --file my_component.yml --version 1 --resource-group my-resource-group --workspace-name my-workspace

Skapa en komponent i registret från en YAML-specifikationsfil

az ml component create --file my_component.yml --registry-name my-registry-name --resource-group my-resource-group

Skapa en komponent i registret från en YAML-specifikationsfil med angiven version

az ml component create --file my_component.yml --version 1 --registry-name my-registry-name --resource-group my-resource-group

Obligatoriska parametrar

--file -f

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

Valfria parametrar

--name -n

Komponentens namn.

--registry-name

Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta.

--resource-group -g

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

--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
--version -v

Version av komponenten.

--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 component list

Visa en lista över komponenter i en arbetsyta.

az ml component list [--archived-only]
                     [--include-archived]
                     [--max-results]
                     [--name]
                     [--registry-name]
                     [--resource-group]
                     [--workspace-name]

Exempel

Visa en lista över alla komponenter i en arbetsyta

az ml component list --resource-group my-resource-group --workspace-name my-workspace

Visa en lista över alla komponentversioner för det angivna namnet på en arbetsyta

az ml component list --name my-component --resource-group my-resource-group --workspace-name my-workspace

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

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

Visa en lista över alla komponenter i ett register

az ml component list --registry-name my-registry-name --resource-group my-resource-group

Visa en lista över alla komponentversioner för det angivna namnet i ett register

az ml component list --name my-component --registry-name my-registry-name --resource-group my-resource-group

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

az ml component list --query "[].{Name:name}"  --output table --registry-name my-registry-name --resource-group my-resource-group

Valfria parametrar

--archived-only

Lista endast arkiverade komponenter.

standardvärde: False
--include-archived

Visa en lista över arkiverade komponenter och aktiva komponenter.

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

Maximalt antal resultat som ska returneras.

--name -n

Komponentens namn.

--registry-name

Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta.

--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 component restore

Återställ en arkiverad komponent.

När en arkiverad komponent återställs döljs den inte längre från listfrågor (az ml component list). Om en hel komponentcontainer arkiveras kan du återställa den arkiverade containern. Då återställs alla versioner av komponenten under det angivna namnet. Du kan inte bara återställa en specifik komponentversion om hela komponentcontainern arkiveras – du måste återställa hela containern. Om endast en enskild komponentversion arkiverades kan du återställa den specifika versionen.

az ml component restore --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

Exempel

Återställa en arkiverad komponentcontainer (återställer alla versioner av komponenten)

az ml component restore --name my-component --resource-group my-resource-group --workspace-name my-workspace

Återställa en specifik arkiverad komponentversion

az ml component restore --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--name -n

Komponentens namn.

Valfria parametrar

--label -l

Komponentens etikett.

--registry-name

Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta.

--resource-group -g

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

--version -v

Version av komponenten.

--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 component show

Visa information för en komponent.

az ml component show --name
                     [--label]
                     [--registry-name]
                     [--resource-group]
                     [--version]
                     [--workspace-name]

Exempel

Visa information för en komponent med det angivna namnet och versionen

az ml component show --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Visa information för en komponent i registret med det angivna namnet och versionen

az ml component show --name my-component --version 1 --registry-name my-registry-name --resource-group my-resource-group

Obligatoriska parametrar

--name -n

Komponentens namn.

Valfria parametrar

--label -l

Komponentens etikett.

--registry-name

Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta.

--resource-group -g

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

--version -v

Version av komponenten.

--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 component update

Uppdatera en komponent. För närvarande stöder endast ett fåtal fält (beskrivning, display_name) uppdatering.

az ml component update --name
                       --resource-group
                       --workspace-name
                       [--add]
                       [--force-string]
                       [--label]
                       [--registry-name]
                       [--remove]
                       [--set]
                       [--version]

Exempel

Uppdatera en komponents beskrivning

az ml component update -n my_component -v 1 --set description="new description" -g my-resource-group -w my-workspace

Obligatoriska parametrar

--name -n

Komponentens namn.

--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
--label -l

Komponentens etikett.

--registry-name

Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta.

--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: []
--version -v

Version av komponenten.

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.