az ml component

  • Reference

Poznámka:

Tento odkaz je součástí rozšíření ml pro Azure CLI (verze 2.15.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az ml component . Přečtěte si další informace o rozšířeních.

Správa komponent Azure ML

Komponenta Azure ML definuje konfiguraci komponenty pro úlohy kanálu. Můžete nakonfigurovat vstupní/výstupní porty, spouštěcí prostředí a příkaz komponenty. Po vytvoření komponenty můžete odkazovat na komponenty v úloze kanálu a spouštět je v kontejnerech Dockeru.

Příkazy

Name Description Typ Stav
az ml component archive

Archivace komponenty.

 Rozšíření GA
az ml component create

Vytvořte komponentu.

 Rozšíření GA
az ml component list

Zobrazení seznamu komponent v pracovním prostoru

 Rozšíření GA
az ml component restore

Obnovení archivované komponenty

 Rozšíření GA
az ml component show

Zobrazení podrobností o komponentě

 Rozšíření GA
az ml component update

Aktualizujte součást. Aktualizace v současné době podporuje pouze několik polí (popis, display_name).

 Rozšíření GA

az ml component archive

Archivace komponenty.

Archivace komponenty ji ve výchozím nastavení skryje v dotazech seznamu (az ml component list). V kanálech můžete i nadále odkazovat a používat archivovanou komponentu. Můžete archivovat kontejner komponent nebo konkrétní verzi komponenty. Archivace kontejneru součástí bude archivovat všechny verze komponenty pod tímto názvem. Archivovanou komponentu můžete obnovit pomocí az ml component restore. Pokud je archivován celý kontejner komponent, nemůžete obnovit jednotlivé verze komponenty – kontejner komponent budete muset obnovit.

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

Příklady

Archivace kontejneru komponent (archivuje všechny verze této komponenty)

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

Archivace konkrétní verze komponenty

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

Povinné parametry

--name -n

Název komponenty.

Volitelné parametry

--label -l

Popisek komponenty

--registry-name

Pokud je k dispozici, příkaz bude místo pracovního prostoru cílit na registr. Proto se skupina prostředků a pracovní prostor nevyžadují.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--version -v

Verze komponenty.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml component create

Vytvořte komponentu.

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

Příklady

Vytvoření komponenty ze souboru specifikace YAML

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

Vytvoření komponenty ze souboru specifikace YAML se zadanou verzí

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

Vytvoření komponenty v registru ze souboru specifikace YAML

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

Vytvoření komponenty v registru ze souboru specifikace YAML se zadanou verzí

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

Povinné parametry

--file -f

Místní cesta k souboru YAML obsahujícímu specifikaci komponenty Azure ML. Referenční dokumenty YAML pro komponentu najdete tady: https://aka.ms/ml-cli-v2-component-command-yaml-reference.

Volitelné parametry

--name -n

Název komponenty.

--registry-name

Pokud je k dispozici, příkaz bude místo pracovního prostoru cílit na registr. Proto se skupina prostředků a pracovní prostor nevyžadují.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=.

--skip-validation

Přeskočte ověření při vytváření prostředku. Všimněte si, že závislé prostředky při vytváření nepřeskočí jejich ověření.

výchozí hodnota: False
--version -v

Verze komponenty.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml component list

Zobrazení seznamu komponent v pracovním prostoru

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

Příklady

Zobrazení seznamu všech komponent v pracovním prostoru

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

Zobrazení seznamu všech verzí součástí pro zadaný název v pracovním prostoru

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

Vypíše všechny komponenty v pracovním prostoru pomocí argumentu --query ke spuštění dotazu JMESPath na výsledky příkazů.

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

Výpis všech komponent v registru

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

Výpis všech verzí součástí pro zadaný název v registru

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

Vypíše všechny komponenty v registru pomocí argumentu --query ke spuštění dotazu JMESPath na výsledky příkazů.

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

Volitelné parametry

--archived-only

Vypsat pouze archivované komponenty.

výchozí hodnota: False
--include-archived

Výpis archivovaných komponent a aktivních komponent

výchozí hodnota: False
--max-results -r

Maximální počet výsledků, které se mají vrátit.

--name -n

Název komponenty.

--registry-name

Pokud je k dispozici, příkaz bude místo pracovního prostoru cílit na registr. Proto se skupina prostředků a pracovní prostor nevyžadují.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml component restore

Obnovení archivované komponenty

Když se archivovaná komponenta obnoví, už nebude skrytá v dotazech seznamu (az ml component list). Pokud se archivuje celý kontejner komponent, můžete tento archivovaný kontejner obnovit. Tím se obnoví všechny verze komponenty pod tímto názvem. Pokud je archivován celý kontejner komponent, nemůžete obnovit pouze konkrétní verzi komponenty – budete muset obnovit celý kontejner. Pokud byla archivována pouze verze jednotlivých komponent, můžete tuto konkrétní verzi obnovit.

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

Příklady

Obnovení archivovaného kontejneru komponent (obnoví všechny verze této komponenty)

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

Obnovení konkrétní archivované verze komponenty

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

Povinné parametry

--name -n

Název komponenty.

Volitelné parametry

--label -l

Popisek komponenty

--registry-name

Pokud je k dispozici, příkaz bude místo pracovního prostoru cílit na registr. Proto se skupina prostředků a pracovní prostor nevyžadují.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--version -v

Verze komponenty.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml component show

Zobrazení podrobností o komponentě

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

Příklady

Zobrazení podrobností pro komponentu se zadaným názvem a verzí

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

Zobrazení podrobností pro komponentu v registru se zadaným názvem a verzí

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

Povinné parametry

--name -n

Název komponenty.

Volitelné parametry

--label -l

Popisek komponenty

--registry-name

Pokud je k dispozici, příkaz bude místo pracovního prostoru cílit na registr. Proto se skupina prostředků a pracovní prostor nevyžadují.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--version -v

Verze komponenty.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ml component update

Aktualizujte součást. Aktualizace v současné době podporuje pouze několik polí (popis, display_name).

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

Příklady

Aktualizace popisu komponenty

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

Povinné parametry

--name -n

Název komponenty.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--workspace-name -w

Název pracovního prostoru Azure ML Výchozí pracovní prostor můžete nakonfigurovat pomocí az configure --defaults workspace=<name>.

Volitelné parametry

--add

Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, string or JSON string>.

výchozí hodnota: []
--force-string

Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.

výchozí hodnota: False
--label -l

Popisek komponenty

--registry-name

Pokud je k dispozici, příkaz bude místo pracovního prostoru cílit na registr. Proto se skupina prostředků a pracovní prostor nevyžadují.

--remove

Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list <indexToRemove> OR --remove propertyToRemove.

výchozí hodnota: []
--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=<value>.

výchozí hodnota: []
--version -v

Verze komponenty.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.