Sdílet prostřednictvím

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. 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.

 Prodloužení GHANŠTINA
az ml component create

Vytvořte komponentu.

 Prodloužení GHANŠTINA
az ml component list

Zobrazení seznamu komponent v pracovním prostoru

 Prodloužení GHANŠTINA
az ml component prepare-for-sign

Připravte komponentu pro podepisování.

 Prodloužení GHANŠTINA
az ml component restore

Obnovení archivované komponenty

 Prodloužení GHANŠTINA
az ml component show

Zobrazení podrobností o komponentě

 Prodloužení GHANŠTINA
az ml component update

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

 Prodloužení GHANŠTINA

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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--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í dokumentaci k YAML pro komponentu najdete na adrese: 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=value.

--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í.

Default value: 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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--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.

Default value: False
--include-archived

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

Default value: 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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--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 prepare-for-sign

Připravte komponentu pro podepisování.

Příprava komponenty pro podepsání generuje 2 soubory: catalog.json a catalog.json.sig, tyto soubory obsahují SHA256 vygenerované pro každý soubor, který je v cílové složce. Pokud už soubory existují, odstraní se a vytvoří se nové soubory s aktualizovaným podpisem.

az ml component prepare-for-sign --file
                                 [--registry-name]
                                 [--resource-group]
                                 [--workspace-name]

Příklady

Příprava komponenty ze souboru specifikace YAML pro podepisování

az ml component prepare-for-sign --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace

Příprava komponenty v registru ze souboru specifikace YAML pro podepisování

az ml component prepare-for-sign --file my_component.yml --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í dokumentaci k YAML pro komponentu najdete na adrese: https://aka.ms/ml-cli-v2-component-command-yaml-reference.

Volitelné parametry

--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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

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

Při obnovení archivované komponenty už nebudou 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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--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>.

Default value: []
--force-string

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

Default value: 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.

Default value: []
--set

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

Default value: []
--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řípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--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.