az ml deployment-template

  • Wersja zapoznawcza

Uwaga / Notatka

To odwołanie jest częścią rozszerzenia ml dla Azure CLI (wersja 2.15.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az ml deployment-template . Dowiedz się więcej o rozszerzeniach.

Ta grupa poleceń jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Zarządzanie szablonami wdrażania Azure ML.

Szablony wdrażania to szablony wielokrotnego użytku, które definiują konfiguracje wdrażania dla usługi Azure ML. Obsługują one tylko operacje oparte na rejestrze (nie oparte na obszarze roboczym) i zapewniają sposób standaryzacji i udostępniania konfiguracji wdrażania między zespołami i projektami.

Polecenia

Nazwa Opis Typ Stan
az ml deployment-template archive

Archiwizowanie szablonu wdrożenia.

 Extension Preview
az ml deployment-template create

Utwórz nowy szablon wdrożenia na podstawie pliku YAML.

 Extension Preview
az ml deployment-template list

Wyświetlanie listy szablonów wdrażania w rejestrze.

 Extension Preview
az ml deployment-template restore

Przywracanie zarchiwizowanego szablonu wdrożenia.

 Extension Preview
az ml deployment-template show

Pobierz określony szablon wdrożenia według nazwy i wersji.

 Extension Preview
az ml deployment-template update

Aktualizowanie określonych pól istniejącego szablonu wdrożenia.

 Extension Preview

az ml deployment-template archive

Wersja zapoznawcza

Grupa poleceń "ml deployment-template" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Archiwizowanie szablonu wdrożenia.

Zarchiwizuj szablon wdrożenia, aby oznaczyć go jako nieaktywny. Zarchiwizowane szablony nie są domyślnie zwracane w operacjach listy. Można zarchiwizować określoną wersję lub wszystkie wersje szablonu.

az ml deployment-template archive --name
                                  --registry-name
                                  --version
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--no-wait]

Przykłady

Archiwizowanie określonej wersji

az ml deployment-template archive --name my-template --version 1 --registry-name myregistry

Archiwum bez oczekiwania na ukończenie

az ml deployment-template archive --name my-template --version 1 --registry-name myregistry --no-wait

Parametry wymagane

--name -n

Nazwa szablonu wdrożenia.

--registry-name -r

Nazwa rejestru. Jest to wymagane, ponieważ szablony wdrażania obsługują tylko nazwę rejestru, a nie obszar roboczy.

--version -v

Wersja szablonu wdrożenia.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--no-wait

Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.

Właściwość Wartość
Domyślna wartość: False
Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Właściwość Wartość
Domyślna wartość: False

az ml deployment-template create

Wersja zapoznawcza

Grupa poleceń "ml deployment-template" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Utwórz nowy szablon wdrożenia na podstawie pliku YAML.

Utwórz nowy szablon wdrożenia przy użyciu pliku konfiguracji YAML. Plik YAML powinien zawierać pełną definicję szablonu wdrożenia, w tym punkty końcowe, parametry i metadane. Określone wartości można zastąpić przy użyciu parametrów wiersza polecenia.

az ml deployment-template create --registry-name
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--file]
                                 [--name]
                                 [--no-wait]
                                 [--set]
                                 [--version]

Przykłady

Tworzenie szablonu wdrożenia na podstawie pliku YAML

az ml deployment-template create --file template.yml --registry-name myregistry

Tworzenie przy użyciu nazw i przesłonięć wersji

az ml deployment-template create --file template.yml --name custom-template --version 2 --registry-name myregistry

Tworzenie bez oczekiwania na ukończenie

az ml deployment-template create --file template.yml --registry-name myregistry --no-wait

Parametry wymagane

--registry-name -r

Nazwa rejestru. Jest to wymagane, ponieważ szablony wdrażania obsługują tylko nazwę rejestru, a nie obszar roboczy.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--file -f

Ścieżka lokalna do pliku YAML zawierającego specyfikację szablonu wdrożenia Azure ML. Dokumentację referencyjną YAML dotyczącą szablonu wdrożenia można znaleźć na stronie: https://aka.ms/ml-cli-v2-deployment-template-yaml.

--name -n

Nazwa szablonu wdrożenia.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.

Właściwość Wartość
Domyślna wartość: False
--set

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

--version -v

Wersja szablonu wdrożenia.

Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Właściwość Wartość
Domyślna wartość: False

az ml deployment-template list

Wersja zapoznawcza

Grupa poleceń "ml deployment-template" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Wyświetlanie listy szablonów wdrażania w rejestrze.

Wyświetl listę wszystkich szablonów wdrażania dostępnych w określonym rejestrze. To polecenie zwraca wszystkie szablony wraz z ich metadanymi, w tym nazwa, wersja, opis i tagi.

az ml deployment-template list --registry-name

Przykłady

Wyświetlanie listy wszystkich szablonów wdrażania w rejestrze

az ml deployment-template list --registry-name myregistry

Wyświetlanie listy szablonów wdrażania z określonym formatem danych wyjściowych

az ml deployment-template list --registry-name myregistry --output table

Parametry wymagane

--registry-name -r

Nazwa rejestru. Jest to wymagane, ponieważ szablony wdrażania obsługują tylko nazwę rejestru, a nie obszar roboczy.

Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Właściwość Wartość
Domyślna wartość: False

az ml deployment-template restore

Wersja zapoznawcza

Grupa poleceń "ml deployment-template" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Przywracanie zarchiwizowanego szablonu wdrożenia.

Przywróć wcześniej zarchiwizowany szablon wdrożenia, aby ponownie go uaktywnić. Przywrócone szablony będą wyświetlane w operacjach listy. Można przywrócić określoną wersję lub wszystkie wersje szablonu.

az ml deployment-template restore --name
                                  --registry-name
                                  --version
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--no-wait]

Przykłady

Przywracanie określonej wersji

az ml deployment-template restore --name my-template --version 1 --registry-name myregistry

Przywracanie bez oczekiwania na ukończenie

az ml deployment-template restore --name my-template --version 1 --registry-name myregistry --no-wait

Parametry wymagane

--name -n

Nazwa szablonu wdrożenia.

--registry-name -r

Nazwa rejestru. Jest to wymagane, ponieważ szablony wdrażania obsługują tylko nazwę rejestru, a nie obszar roboczy.

--version -v

Wersja szablonu wdrożenia.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--no-wait

Nie czekaj na zakończenie długotrwałej operacji. Wartość domyślna to False.

Właściwość Wartość
Domyślna wartość: False
Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Właściwość Wartość
Domyślna wartość: False

az ml deployment-template show

Wersja zapoznawcza

Grupa poleceń "ml deployment-template" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Pobierz określony szablon wdrożenia według nazwy i wersji.

Pobierz szczegółowe informacje o określonym szablonie wdrożenia. Jeśli wersja nie zostanie określona, zostanie zwrócona najnowsza wersja.

az ml deployment-template show --name
                               --registry-name
                               --version

Przykłady

Pobieranie konkretnej wersji szablonu wdrożenia

az ml deployment-template show --name my-template --version 1 --registry-name myregistry

Parametry wymagane

--name -n

Nazwa szablonu wdrożenia.

--registry-name -r

Nazwa rejestru. Jest to wymagane, ponieważ szablony wdrażania obsługują tylko nazwę rejestru, a nie obszar roboczy.

--version -v

Wersja szablonu wdrożenia.

Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Właściwość Wartość
Domyślna wartość: False

az ml deployment-template update

Wersja zapoznawcza

Grupa poleceń "ml deployment-template" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Aktualizowanie określonych pól istniejącego szablonu wdrożenia.

Aktualizowanie pól metadanych (opis i tagi) istniejącego szablonu wdrożenia bez konieczności używania pliku YAML. To polecenie jest zgodne z konwencjami Azure CLI i akceptuje tylko określone aktualizacje pól. Tagi są scalane z istniejącymi tagami, a nie zastępowane.

W przypadku zmian strukturalnych w szablonie wdrożenia (punktach końcowych, konfiguracji wdrożenia itp.) użyj polecenia "create" z plikiem YAML.

az ml deployment-template update --name
                                 --registry-name
                                 --version
                                 [--acquire-policy-token]
                                 [--add]
                                 [--change-reference]
                                 [--force-string]
                                 [--remove]
                                 [--set]

Przykłady

Opis szablonu wdrożenia aktualizacji

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "description=Updated description"

Aktualizowanie tagów szablonu wdrożenia

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "tags=environment=production owner=ml-team"

Aktualizowanie zarówno opisu, jak i tagów

az ml deployment-template update --name my-template --version 1 --registry-name myregistry --set "description=Production template" --set "tags=status=active"

Parametry wymagane

--name -n

Nazwa szablonu wdrożenia.

--registry-name -r

Nazwa rejestru. Jest to wymagane, ponieważ szablony wdrażania obsługują tylko nazwę rejestru, a nie obszar roboczy.

--version -v

Wersja szablonu wdrożenia.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--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>.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: []
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--force-string

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

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: False
--remove

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

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
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>.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Domyślna wartość: []
Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Właściwość Wartość
Domyślna wartość: False