az ml service

  • Reference

Poznámka:

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

Správa zprovozněných služeb

Příkazy

Name Description Typ Stav
az ml service delete

Odstraňte službu z pracovního prostoru.

 Rozšíření GA
az ml service get-access-token

Získání tokenu pro vydávání žádostí o službu

 Rozšíření GA
az ml service get-keys

Získejte klíče k vydávání požadavků na službu.

 Rozšíření GA
az ml service get-logs

Získejte protokoly pro službu.

 Rozšíření GA
az ml service list

Vypisujte služby v pracovním prostoru.

 Rozšíření GA
az ml service regen-key

Znovu vygenerujte klíče pro službu.

 Rozšíření GA
az ml service run

Spusťte službu v pracovním prostoru.

 Rozšíření GA
az ml service show

Zobrazí podrobnosti o službě v pracovním prostoru.

 Rozšíření GA
az ml service update

Aktualizujte službu v pracovním prostoru.

 Rozšíření GA

az ml service delete

Odstraňte službu z pracovního prostoru.

az ml service delete --name
                     [--path]
                     [--resource-group]
                     [--subscription-id]
                     [--workspace-name]
                     [-v]

Povinné parametry

--name -n

Název služby, který chcete odstranit.

Volitelné parametry

--path

Cesta ke složce projektu Výchozí: aktuální adresář.

--resource-group -g

Skupina prostředků odpovídající poskytnutému pracovnímu prostoru

--subscription-id

Určuje ID předplatného.

--workspace-name -w

Název pracovního prostoru obsahujícího službu, která se má odstranit.

-v

Příznak podrobností.

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 service get-access-token

Získání tokenu pro vydávání žádostí o službu

az ml service get-access-token --name
                               [--path]
                               [--resource-group]
                               [--subscription-id]
                               [--workspace-name]
                               [-v]

Povinné parametry

--name -n

Název služby.

Volitelné parametry

--path

Cesta ke složce projektu Výchozí: aktuální adresář.

--resource-group -g

Skupina prostředků odpovídající poskytnutému pracovnímu prostoru

--subscription-id

Určuje ID předplatného.

--workspace-name -w

Název pracovního prostoru obsahujícího službu, která se má zobrazit.

-v

Příznak podrobností.

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 service get-keys

Získejte klíče k vydávání požadavků na službu.

az ml service get-keys --name
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

Povinné parametry

--name -n

Název služby.

Volitelné parametry

--path

Cesta ke složce projektu Výchozí: aktuální adresář.

--resource-group -g

Skupina prostředků odpovídající poskytnutému pracovnímu prostoru

--subscription-id

Určuje ID předplatného.

--workspace-name -w

Název pracovního prostoru obsahujícího službu, která se má zobrazit.

-v

Příznak podrobností.

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 service get-logs

Získejte protokoly pro službu.

az ml service get-logs --name
                       [--init]
                       [--num_lines]
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

Povinné parametry

--name -n

Název služby.

Volitelné parametry

--init -i

Místo kontejneru bodování získejte protokoly inicializačního kontejneru.

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

Počet řádků protokolu, které se mají vrátit z konce (výchozí hodnota je 5000).

výchozí hodnota: 5000
--path

Cesta ke složce projektu Výchozí: aktuální adresář.

--resource-group -g

Skupina prostředků odpovídající poskytnutému pracovnímu prostoru

--subscription-id

Určuje ID předplatného.

--workspace-name -w

Název pracovního prostoru obsahujícího službu, která se má zobrazit.

-v

Příznak podrobností.

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

Vypisujte služby v pracovním prostoru.

az ml service list [--compute-type]
                   [--image-digest]
                   [--model-id]
                   [--model-name]
                   [--path]
                   [--property]
                   [--resource-group]
                   [--subscription-id]
                   [--tag]
                   [--workspace-name]
                   [-v]

Volitelné parametry

--compute-type -c

Pokud je k dispozici, zobrazí se jenom služby, které mají zadaný typ výpočetního objektu. (Možnosti jsou ACI, AKS).

--image-digest

Pokud je k dispozici, zobrazí se pouze služby, které mají zadanou hodnotou hash obrázku.

--model-id

Pokud je k dispozici, zobrazí se jenom služby, které mají zadané ID modelu.

--model-name

Pokud je k dispozici, zobrazí se jenom služby, které mají zadaný název modelu.

--path

Cesta ke složce projektu Výchozí: aktuální adresář.

--property

Pokud je k dispozici, vyfiltruje se na základě zadaného klíče nebo hodnoty (e.g. key nebo key=value). Pomocí několika možností --property je možné zadat více vlastností.

výchozí hodnota: []
--resource-group -g

Skupina prostředků odpovídající poskytnutému pracovnímu prostoru

--subscription-id

Určuje ID předplatného.

--tag

Pokud je k dispozici, vyfiltruje se na základě zadaného klíče nebo hodnoty (e.g. key nebo key=value). Více značek lze zadat pomocí několika možností --tag.

výchozí hodnota: []
--workspace-name -w

Název pracovního prostoru obsahujícího služby, které se mají zobrazit.

-v

Příznak podrobností.

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 service regen-key

Znovu vygenerujte klíče pro službu.

az ml service regen-key --key
                        --name
                        [--path]
                        [--resource-group]
                        [--set-key]
                        [--subscription-id]
                        [--workspace-name]
                        [-v]

Povinné parametry

--key -k

Který klíč k opětovnému vygenerování, pokud je zadán regen. Možnosti: Primární, Sekundární.

--name -n

Název služby.

Volitelné parametry

--path

Cesta ke složce projektu Výchozí: aktuální adresář.

--resource-group -g

Skupina prostředků odpovídající poskytnutému pracovnímu prostoru

--set-key -s

Zadejte hodnotu ověřování pro zadaný klíč.

--subscription-id

Určuje ID předplatného.

--workspace-name -w

Název pracovního prostoru obsahujícího službu, která se má zobrazit.

-v

Příznak podrobností.

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

Spusťte službu v pracovním prostoru.

az ml service run --name
                  [--input-data]
                  [--path]
                  [--resource-group]
                  [--subscription-id]
                  [--workspace-name]
                  [-v]

Povinné parametry

--name -n

Název služby, který má být vyhodnocen jako výsledek.

Volitelné parametry

--input-data -d

Data, která se mají použít pro volání webové služby.

--path

Cesta ke složce projektu Výchozí: aktuální adresář.

--resource-group -g

Skupina prostředků odpovídající poskytnutému pracovnímu prostoru

--subscription-id

Určuje ID předplatného.

--workspace-name -w

Název pracovního prostoru obsahujícího službu, která se má spustit.

-v

Příznak podrobností.

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

Zobrazí podrobnosti o službě v pracovním prostoru.

az ml service show --name
                   [--path]
                   [--resource-group]
                   [--subscription-id]
                   [--workspace-name]
                   [-v]

Povinné parametry

--name -n

Název webové služby, která se má zobrazit.

Volitelné parametry

--path

Cesta ke složce projektu Výchozí: aktuální adresář.

--resource-group -g

Skupina prostředků odpovídající poskytnutému pracovnímu prostoru

--subscription-id

Určuje ID předplatného.

--workspace-name -w

Název pracovního prostoru obsahujícího službu, která se má zobrazit.

-v

Příznak podrobností.

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

Aktualizujte službu v pracovním prostoru.

az ml service update --name
                     [--add-property]
                     [--add-tag]
                     [--ae]
                     [--ai]
                     [--ar]
                     [--as]
                     [--at]
                     [--autoscale-max-replicas]
                     [--autoscale-min-replicas]
                     [--base-image]
                     [--base-image-registry]
                     [--cc]
                     [--ccl]
                     [--cf]
                     [--collect-model-data]
                     [--compute-target]
                     [--cuda-version]
                     [--dc]
                     [--description]
                     [--dn]
                     [--ds]
                     [--ed]
                     [--eg]
                     [--entry-script]
                     [--environment-name]
                     [--environment-version]
                     [--failure-threshold]
                     [--gb]
                     [--gbl]
                     [--gc]
                     [--ic]
                     [--id]
                     [--is-migration]
                     [--kp]
                     [--ks]
                     [--lo]
                     [--max-request-wait-time]
                     [--model]
                     [--model-metadata-file]
                     [--no-wait]
                     [--nr]
                     [--path]
                     [--period-seconds]
                     [--po]
                     [--remove-tag]
                     [--replica-max-concurrent-requests]
                     [--resource-group]
                     [--rt]
                     [--sc]
                     [--scoring-timeout-ms]
                     [--sd]
                     [--se]
                     [--sk]
                     [--sp]
                     [--st]
                     [--subscription-id]
                     [--timeout-seconds]
                     [--token-auth-enabled]
                     [--workspace-name]
                     [-v]

Povinné parametry

--name -n

Název služby, který se má aktualizovat.

Volitelné parametry

--add-property

Vlastnost klíč/hodnota, kterou chcete přidat (e.g. key=value). Pomocí několika možností --add-property lze zadat více vlastností.

výchozí hodnota: []
--add-tag

Značka klíč/hodnota, kterou chcete přidat (e.g. key=value). Více značek lze zadat pomocí několika možností --add-tag.

výchozí hodnota: []
--ae --auth-enabled

Zda má být pro tuto webovou službu povolené ověřování klíčů, nebo ne. Výchozí hodnota je False.

--ai --enable-app-insights

Jestli chcete povolit AppInsights pro tuto webovou službu, nebo ne. Výchozí hodnota je False.

--ar --autoscale-refresh-seconds

Jak často se má automatické škálování pokusit tuto webovou službu škálovat. Výchozí hodnota je 1.

--as --autoscale-enabled

Jestli chcete pro tuto webovou službu povolit automatické škálování, nebo ne. Pokud num_replicas není žádná, výchozí hodnota je True.

--at --autoscale-target-utilization

Cílové využití (v procentech z 100) by se automatické škálování mělo pokoušet udržovat pro tuto webovou službu. Výchozí hodnota je 70.

--autoscale-max-replicas --ma

Maximální počet kontejnerů, které se mají použít při automatickém škálování této webové služby. Výchozí hodnota je 10.

--autoscale-min-replicas --mi

Minimální počet kontejnerů, které se mají použít při automatickém škálování této webové služby. Výchozí hodnota je 1.

--base-image --bi

Vlastní image, která se má použít jako základní image. Pokud není uvedena žádná základní image, použije se základní image na základě daného parametru modulu runtime.

--base-image-registry --ir

Registr image, který obsahuje základní image.

--cc --cpu-cores

Počet jader procesoru, která se mají přidělit pro tuto webovou službu. Může to být desetinné číslo. Výchozí hodnota je 0.1.

--ccl --cpu-cores-limit

Maximální počet jader procesoru, které tato webová služba může používat. Může to být desetinné číslo.

--cf --conda-file

Cesta k místnímu souboru obsahujícímu definici prostředí Conda, která se má použít pro image.

--collect-model-data --md

Jestli chcete povolit shromažďování dat modelu pro tuto webovou službu, nebo ne. Výchozí hodnota je False.

--compute-target

(Preview) Určuje cílový výpočetní objekt s rozšířením AzureML nainstalovaným pro hostování migrovaného online koncového bodu a nasazení Kubernetes.

--cuda-version --cv

Verze CUDA pro instalaci imagí, které potřebují podporu GPU. Image GPU se musí používat ve službách Microsoft Azure, jako jsou Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines a Azure Kubernetes Service. Podporované verze jsou 9.0, 9.1 a 10.0. Pokud je nastavená hodnota enable_gpu, nastaví se výchozí hodnota 9.1.

--dc --deploy-config-file

Cesta k souboru JSON obsahujícímu metadata nasazení

--description -d

Popis služby

--dn --dns-name-label

Název dns pro tuto webovou službu.

--ds --extra-docker-file-steps

Cesta k místnímu souboru obsahujícímu další kroky Dockeru, které se mají spustit při nastavování image.

--ed --environment-directory

Adresář pro prostředí Azure Machine Learning pro nasazení Jedná se o stejnou cestu k adresáři, jakou jste zadali v příkazu az ml environment scaffold.

--eg --enable-gpu

Bez ohledu na to, jestli se má v imagi povolit podpora GPU. Image GPU se musí používat ve službách Microsoft Azure, jako jsou Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines a Azure Kubernetes Service. Výchozí hodnota je False.

--entry-script --es

Cesta k místnímu souboru, který obsahuje kód ke spuštění pro službu (relativní cesta z source_directory pokud je k dispozici).

--environment-name -e

Název prostředí Azure Machine Learning pro nasazení

--environment-version --ev

Verze existujícího prostředí Azure Machine Learning pro nasazení

--failure-threshold --ft

Když se pod spustí a sonda aktivity selže, Kubernetes se pokusí před vyřazením zkusit prahovou hodnotu --failure-threshold times. Výchozí hodnota je 3. Minimální hodnota je 1.

--gb --memory-gb

Velikost paměti (v GB) pro přidělení této webové služby. Může to být desetinné číslo.

--gbl --memory-gb-limit

Maximální velikost paměti (v GB), kterou tato webová služba může používat. Může to být desetinné číslo.

--gc --gpu-cores

Počet jader gpu, která se mají přidělit pro tuto webovou službu. Výchozí hodnota je 1.

--ic --inference-config-file

Cesta k souboru JSON nebo YAML obsahujícímu konfiguraci odvozování

--id --initial-delay-seconds

Počet sekund po spuštění kontejneru před inicializováním sondy aktivity Výchozí hodnota je 310.

--is-migration

(Preview) Bez ohledu na to, jestli chcete migrovat webovou službu AKS do online koncového bodu a nasazení Kubernetes. Výchozí hodnota je False.

--kp --primary-key

Primární ověřovací klíč, který se má použít pro tuto webovou službu.

--ks --secondary-key

Sekundární ověřovací klíč, který se má použít pro tuto webovou službu.

--lo --location

Oblast Azure pro nasazení této webové služby do. Pokud nezadáte umístění pracovního prostoru, použije se. Další podrobnosti o dostupných oblastech najdete tady: https://azure.microsoft.com/en-us/global-infrastructure/services/?regions=all& products=container-instances.

--max-request-wait-time --mr

Maximální doba, po kterou požadavek zůstane ve frontě (v milisekundách) před vrácením chyby 503. Výchozí hodnota je 500.

--model -m

ID modelu, který se má nasadit. Pomocí dalších argumentů -m je možné zadat více modelů. Modely musí být zaregistrované jako první.

výchozí hodnota: []
--model-metadata-file -f

Cesta k souboru JSON obsahujícímu metadata registrace modelu Pomocí více parametrů -f je možné zadat více modelů.

výchozí hodnota: []
--no-wait

Příznak, který nečeká na asynchronní volání.

--nr --num-replicas

Počet kontejnerů, které se mají přidělit pro tuto webovou službu. Bez výchozího nastavení, pokud tento parametr není nastavený, je automatické škálování ve výchozím nastavení povolené.

--path

Cesta ke složce projektu Výchozí: aktuální adresář.

--period-seconds --ps

Jak často (v sekundách) se má provést sonda aktivity. Výchozí hodnota je 10 sekund. Minimální hodnota je 1.

--po --port

Místní port, na kterém se má zveřejnit koncový bod HTTP služby.

--remove-tag

Klíč značky, která se má odebrat Více značek lze zadat s několika možnostmi --remove-tag.

výchozí hodnota: []
--replica-max-concurrent-requests --rm

Počet maximálních souběžných požadavků na uzel, které povolí tuto webovou službu. Výchozí hodnota je 1.

--resource-group -g

Skupina prostředků odpovídající poskytnutému pracovnímu prostoru

--rt --runtime

Který modul runtime se má použít pro image. Aktuální podporované moduly runtime jsou spark-py a python-py|python|python-slim.

--sc --ssl-cname

Název cname pro, pokud je povolený protokol SSL. Platí pouze při aktualizaci služby ACI.

--scoring-timeout-ms --tm

Vypršení časového limitu pro volání bodování této webové služby. Výchozí hodnota je 60000.

--sd --source-directory

Cesta ke složkám, které obsahují všechny soubory pro vytvoření image.

--se --ssl-enabled

Zda povolit SSL pro tuto webovou službu, nebo ne. Výchozí hodnota je False.

--sk --ssl-key-pem-file

Soubor klíče potřebný v případě, že je povolený protokol SSL.

--sp --ssl-cert-pem-file

Pokud je povolený protokol SSL, je potřeba soubor certifikátu.

--st --success-threshold

Minimální počet po sobě jdoucích úspěchů pro sondu aktivity, které se mají považovat za úspěšné po selhání. Výchozí hodnota je 1. Minimální hodnota je 1.

--subscription-id

Určuje ID předplatného.

--timeout-seconds --ts

Počet sekund, po kterých vyprší časový limit sondy aktivity Výchozí hodnota je 2 sekundy. Minimální hodnota je 1.

--token-auth-enabled

Jestli chcete povolit ověřování tokenů pro tuto webovou službu, nebo ne. K dispozici pouze pro webové služby AKS. Výchozí hodnota je False.

--workspace-name -w

Název pracovního prostoru obsahujícího službu, která se má aktualizovat.

-v

Příznak podrobností.

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.