az ml component

  • Odwołanie

Uwaga

Ta dokumentacja jest częścią rozszerzenia ml dla interfejsu wiersza polecenia platformy Azure (wersja 2.15.0 lub nowsza). Rozszerzenie automatycznie zainstaluje polecenie az ml component po raz pierwszy. 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.

 Numer wewnętrzny Ogólna dostępność
az ml component create

Utwórz składnik.

 Numer wewnętrzny Ogólna dostępność
az ml component list

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

 Numer wewnętrzny Ogólna dostępność
az ml component restore

Przywracanie zarchiwizowanego składnika.

 Numer wewnętrzny Ogólna dostępność
az ml component show

Pokaż szczegóły składnika.

 Numer wewnętrzny Ogólna dostępność
az ml component update

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

 Numer wewnętrzny Ogólna dostępność

az ml component archive

Archiwizowanie składnika.

Archiwizowanie składnika spowoduje ukrycie go domyślnie 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 polecenia 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 polecenia 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 polecenia 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.

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

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

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia 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 polecenia 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=.

--skip-validation

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

wartość domyślna: 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 polecenia 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.

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

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

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia 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.

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

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

wartość domyślna: 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 polecenia 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 polecenia 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.

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

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

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia 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 polecenia 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 polecenia 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.

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

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

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia 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 polecenia 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 polecenia 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.

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

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

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia 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 polecenia 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 polecenia 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>.

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

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

wartość domyślna: 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.

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

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

wartość domyślna: []
--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.

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

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

--subscription

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

--verbose

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