Udostępnij za pośrednictwem

az ml component

  • Odwołanie

Nuta

Ta dokumentacja jest częścią rozszerzenia ml ml dla interfejsu wiersza polecenia platformy Azure (wersja 2.15.0 lub nowsza). Rozszerzenie automatycznie zainstaluje polecenie az ml component. Dowiedz się więcej o rozszerzeniach.

Zarządzanie składnikami usługi Azure ML.

Składnik usługi Azure ML definiuje konfigurację składnika dla zadań potoku. Można skonfigurować porty wejściowe/wyjściowe, środowisko wykonywania i polecenie składnika. Po utworzeniu składnika można odwołać się do składników w zadaniu potoku, aby wykonać je w kontenerach platformy Docker.

Polecenia

Nazwa Opis Typ Stan
az ml component archive

Archiwizowanie składnika.

 Rozszerzenie GA
az ml component create

Utwórz składnik.

 Rozszerzenie GA
az ml component list

Wyświetlanie listy składników w obszarze roboczym.

 Rozszerzenie GA
az ml component prepare-for-sign

Przygotuj składnik do podpisywania.

 Rozszerzenie GA
az ml component restore

Przywracanie zarchiwizowanego składnika.

 Rozszerzenie GA
az ml component show

Pokaż szczegóły składnika.

 Rozszerzenie GA
az ml component update

Aktualizowanie składnika. Obecnie tylko kilka pól (opis, display_name) obsługuje aktualizację.

 Rozszerzenie GA

az ml component archive

Archiwizowanie składnika.

Archiwizowanie składnika domyślnie spowoduje ukrycie go przed zapytaniami listy (az ml component list). Nadal można odwoływać się do zarchiwizowanego składnika i używać go w potokach. Można zarchiwizować kontener składników lub określoną wersję składnika. Archiwizowanie kontenera składników spowoduje zarchiwizowanie wszystkich wersji składnika pod daną nazwą. Możesz przywrócić zarchiwizowany składnik przy użyciu az ml component restore. Jeśli cały kontener składników jest zarchiwizowany, nie można przywrócić poszczególnych wersji składnika — musisz przywrócić kontener składników.

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

Przykłady

Archiwizowanie kontenera składników (archiwizuje wszystkie wersje tego składnika)

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

Archiwizowanie określonej wersji składnika

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

Parametry wymagane

--name -n

Nazwa składnika.

Parametry opcjonalne

--label -l

Etykieta składnika.

--registry-name

Jeśli zostanie podana, polecenie będzie dotyczyć rejestru zamiast obszaru roboczego. W związku z tym grupa zasobów i obszar roboczy nie będą wymagane.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--version -v

Wersja składnika.

--workspace-name -w

Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu az configure --defaults workspace=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az ml component create

Utwórz składnik.

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

Przykłady

Tworzenie składnika na podstawie pliku specyfikacji YAML

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

Tworzenie składnika na podstawie pliku specyfikacji YAML z określoną wersją

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

Tworzenie składnika w rejestrze na podstawie pliku specyfikacji YAML

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

Tworzenie składnika w rejestrze na podstawie pliku specyfikacji YAML z określoną wersją

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

Parametry wymagane

--file -f

Ścieżka lokalna do pliku YAML zawierającego specyfikację składnika usługi Azure ML. Dokumentację referencyjną YAML dla składnika można znaleźć na stronie: https://aka.ms/ml-cli-v2-component-command-yaml-reference.

Parametry opcjonalne

--name -n

Nazwa składnika.

--registry-name

Jeśli zostanie podana, polecenie będzie dotyczyć rejestru zamiast obszaru roboczego. W związku z tym grupa zasobów i obszar roboczy nie będą wymagane.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=value.

--skip-validation

Pomiń walidację podczas tworzenia zasobu. Należy pamiętać, że zasoby zależne nie pomijają walidacji podczas tworzenia.

Domyślna wartość: False
--version -v

Wersja składnika.

--workspace-name -w

Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu az configure --defaults workspace=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az ml component list

Wyświetlanie listy składników w obszarze roboczym.

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

Przykłady

Wyświetlanie listy wszystkich składników w obszarze roboczym

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

Wyświetlanie listy wszystkich wersji składników dla określonej nazwy w obszarze roboczym

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

Wyświetl listę wszystkich składników w obszarze roboczym przy użyciu argumentu --query w celu wykonania zapytania JMESPath na wynikach poleceń.

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

Wyświetlanie listy wszystkich składników w rejestrze

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

Wyświetl listę wszystkich wersji składników dla określonej nazwy w rejestrze

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

Wyświetl listę wszystkich składników w rejestrze przy użyciu argumentu --query w celu wykonania zapytania JMESPath na wynikach poleceń.

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

Parametry opcjonalne

--archived-only

Wyświetl tylko zarchiwizowane składniki.

Domyślna wartość: False
--include-archived

Lista zarchiwizowanych składników i aktywnych składników.

Domyślna wartość: False
--max-results -r

Maksymalna liczba wyników do zwrócenia.

--name -n

Nazwa składnika.

--registry-name

Jeśli zostanie podana, polecenie będzie dotyczyć rejestru zamiast obszaru roboczego. W związku z tym grupa zasobów i obszar roboczy nie będą wymagane.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--workspace-name -w

Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu az configure --defaults workspace=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az ml component prepare-for-sign

Przygotuj składnik do podpisywania.

Przygotowanie składnika do podpisywania generuje 2 pliki: catalog.json i catalog.json.sig, te pliki zawierają algorytm SHA256 wygenerowany dla każdego pliku, który znajduje się w folderze docelowym. Jeśli pliki są już obecne, zostaną usunięte, a nowe pliki zostaną utworzone ze zaktualizowanym podpisem.

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

Przykłady

Przygotowywanie składnika z pliku specyfikacji YAML do podpisywania

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

Przygotowywanie składnika w rejestrze z pliku specyfikacji YAML do podpisywania

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

Parametry wymagane

--file -f

Ścieżka lokalna do pliku YAML zawierającego specyfikację składnika usługi Azure ML. Dokumentację referencyjną YAML dla składnika można znaleźć na stronie: https://aka.ms/ml-cli-v2-component-command-yaml-reference.

Parametry opcjonalne

--registry-name

Jeśli zostanie podana, polecenie będzie dotyczyć rejestru zamiast obszaru roboczego. W związku z tym grupa zasobów i obszar roboczy nie będą wymagane.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--workspace-name -w

Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu az configure --defaults workspace=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az ml component restore

Przywracanie zarchiwizowanego składnika.

Po przywróceniu zarchiwizowanego składnika nie będzie już ukrywany przed zapytaniami listy (az ml component list). Jeśli cały kontener składników jest zarchiwizowany, możesz przywrócić ten zarchiwizowany kontener. Spowoduje to przywrócenie wszystkich wersji składnika pod daną nazwą. Nie można przywrócić tylko określonej wersji składnika, jeśli cały kontener składników jest zarchiwizowany — musisz przywrócić cały kontener. Jeśli tylko pojedyncza wersja składnika została zarchiwizowana, możesz przywrócić określoną wersję.

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

Przykłady

Przywracanie zarchiwizowanego kontenera składników (przywraca wszystkie wersje tego składnika)

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

Przywracanie określonej zarchiwizowanej wersji składnika

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

Parametry wymagane

--name -n

Nazwa składnika.

Parametry opcjonalne

--label -l

Etykieta składnika.

--registry-name

Jeśli zostanie podana, polecenie będzie dotyczyć rejestru zamiast obszaru roboczego. W związku z tym grupa zasobów i obszar roboczy nie będą wymagane.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--version -v

Wersja składnika.

--workspace-name -w

Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu az configure --defaults workspace=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az ml component show

Pokaż szczegóły składnika.

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

Przykłady

Pokaż szczegóły składnika o określonej nazwie i wersji

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

Pokaż szczegóły składnika w rejestrze o określonej nazwie i wersji

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

Parametry wymagane

--name -n

Nazwa składnika.

Parametry opcjonalne

--label -l

Etykieta składnika.

--registry-name

Jeśli zostanie podana, polecenie będzie dotyczyć rejestru zamiast obszaru roboczego. W związku z tym grupa zasobów i obszar roboczy nie będą wymagane.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--version -v

Wersja składnika.

--workspace-name -w

Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu az configure --defaults workspace=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az ml component update

Aktualizowanie składnika. Obecnie tylko kilka pól (opis, display_name) obsługuje aktualizację.

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

Przykłady

Aktualizowanie opisu składnika

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

Parametry wymagane

--name -n

Nazwa składnika.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--workspace-name -w

Nazwa obszaru roboczego usługi Azure ML. Domyślny obszar roboczy można skonfigurować przy użyciu az configure --defaults workspace=<name>.

Parametry opcjonalne

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>.

Domyślna wartość: []
--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

Domyślna wartość: False
--label -l

Etykieta składnika.

--registry-name

Jeśli zostanie podana, polecenie będzie dotyczyć rejestru zamiast obszaru roboczego. W związku z tym grupa zasobów i obszar roboczy nie będą wymagane.

--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Domyślna wartość: []
--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.

Domyślna wartość: []
--version -v

Wersja składnika.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Aby uzyskać więcej informacji i przykładów, zobacz http://jmespath.org/.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.