az ml model
Feljegyzés
Ez a hivatkozás az Azure CLI ml-bővítményének része (2.15.0-s vagy újabb verzió). A bővítmény automatikusan telepíti az az ml-modell parancs első futtatásakor. További információ a bővítményekről.
Azure ML-modellek kezelése.
Az Azure ML-modellek a gépi tanulási modellt és a hozzájuk tartozó metaadatokat képviselő bináris fájl(ok)ból állnak. Ezek a modellek a végpontok üzembe helyezésében használhatók valós idejű és kötegelt következtetéshez.
Parancsok
Name | Description | Típus | Állapot |
---|---|---|---|
az ml model archive |
Modell archiválása. |
Mellék | FE |
az ml model create |
Hozzon létre egy modellt. |
Mellék | FE |
az ml model download |
Töltse le az összes modellhez kapcsolódó fájlt. |
Mellék | FE |
az ml model list |
Modellek listázása egy munkaterületen/beállításjegyzékben. Ha beállításjegyzéket használ, cserélje le |
Mellék | FE |
az ml model package |
Modell becsomagolása környezetbe. |
Mellék | Előnézet |
az ml model restore |
Archivált modell visszaállítása. |
Mellék | FE |
az ml model share |
Egy adott modell megosztása a munkaterületről a beállításjegyzékbe. |
Mellék | FE |
az ml model show |
Modell részleteinek megjelenítése egy munkaterületen/beállításjegyzékben. Ha beállításjegyzéket használ, cserélje le |
Mellék | FE |
az ml model update |
Modell frissítése egy munkaterületen/beállításjegyzékben. |
Mellék | FE |
az ml model archive
Modell archiválása.
A modell archiválása alapértelmezés szerint elrejti azt a lista lekérdezéseiből (az ml model list
). Továbbra is hivatkozhat és használhat archivált modellt a munkafolyamatokban. Archiválhat egy modelltárolót vagy egy adott modellverziót. A modelltároló archiválása archiválja a modell összes verzióját a megadott név alatt. Archivált modellt a következővel az ml model restore
állíthat vissza: . Ha a teljes modelltároló archiválva van, nem állíthatja vissza a modell egyes verzióit – a modelltárolót vissza kell állítania.
az ml model archive --name
[--label]
[--registry-name]
[--resource-group]
[--version]
[--workspace-name]
Példák
Modelltároló archiválása (a modell összes verziójának archiválása)
az ml model archive --name my-model --resource-group my-resource-group --workspace-name my-workspace
Adott modellverzió archiválása
az ml model archive --name my-model --version 1 --resource-group my-resource-group --workspace-name my-workspace
Kötelező paraméterek
A modell neve.
Opcionális paraméterek
A modell címkéje.
Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
A modell verziója.
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID
: .
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
az ml model create
Hozzon létre egy modellt.
A modellek helyi fájlból, helyi könyvtárból, adattárból vagy feladatkimenetből hozhatók létre. A létrehozott modell nyomon lesz követve a munkaterületen/beállításjegyzékben a megadott név és verzió alatt. Ha beállításjegyzéket használ, cserélje le --workspace-name my-workspace
a --registry-name <registry-name>
beállítást.
az ml model create [--datastore]
[--description]
[--file]
[--name]
[--no-wait]
[--path]
[--registry-name]
[--resource-group]
[--set]
[--stage]
[--tags]
[--type]
[--version]
[--workspace-name]
Példák
Modell létrehozása YAML specifikációs fájlból
az ml model create --file model.yml --resource-group my-resource-group --workspace-name my-workspace
Modell létrehozása helyi mappából parancsbeállítások használatával
az ml model create --name my-model --version 1 --path ./my-model --resource-group my-resource-group --workspace-name my-workspace
Modell létrehozása mlflow-futtatási URI-formátummal (futtatások:/<run-id><path-to-model-relative-to-the-root-of-the-artifact-location>/) és parancsbeállítások
az ml model create --name my-model --version 1 --path runs:/c42d2507-4953-4a7c-a4c1-2b5bfe0ac64e/model/ --type mlflow_model --resource-group my-resource-group --workspace-name my-workspace
Hozzon létre egy modellt egy elnevezett feladat kimenetéből az Azureml-feladat URI-formátuma "azureml://jobs/<job-name>/outputs/<named-output>/paths/<path-to-model-relative-to-the-named-output-location>" és a parancsbeállítások használatával. Az alapértelmezett elnevezett kimenet az összetevők
az ml model create --name my-model --version 1 --path azureml://jobs/c42d2507-4953-4a7c-a4c1-2b5bfe0ac64e/outputs/artifacts/paths/model/ --resource-group my-resource-group --workspace-name my-workspace
Modell létrehozása "azureml://datastores/<datastore-name>/paths/<path-to-model-relative-to-the-root-of-the-datastore-location>" adattárból parancsbeállítások használatával
az ml model create --name my-model --version 1 --path azureml://datastores/myblobstore/paths/models/cifar10/cifar.pt --resource-group my-resource-group --workspace-name my-workspace
Opcionális paraméterek
A helyi összetevő feltöltésére szolgáló adattár.
A modell leírása.
Az Azure ML-modell specifikációját tartalmazó YAML-fájl helyi elérési útja. A modell YAML referencia-dokumentációja a következő helyen található: https://aka.ms/ml-cli-v2-model-yaml-reference.
A modell neve.
Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.
A modellfájl(ok) elérési útja. Ez lehet helyi vagy távoli hely. Ha meg van adva, a --name/-n és a --version/-v értéket is meg kell adni.
Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
Frissítsen egy objektumot egy beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=.
A modell fázisa.
Szóközzel elválasztott kulcs-érték párok az objektum címkéihez.
A modell típusa, az engedélyezett értékek custom_model, mlflow_model és triton_model. Az alapértelmezett típus a custom_model.
A modell verziója.
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID
: .
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
az ml model download
Töltse le az összes modellhez kapcsolódó fájlt.
A rendszer letölti a fájlokat a modell neve után elnevezett mappába. Ha beállításjegyzéket használ, cserélje le --workspace-name my-workspace
a --registry-name <registry-name>
beállítást.
az ml model download --name
--version
[--download-path]
[--registry-name]
[--resource-group]
[--workspace-name]
Példák
Modell letöltése a megadott névvel és verzióval
az ml model download --name my-model --version 1 --resource-group my-resource-group --workspace-name my-workspace
Modell letöltése a megadott névvel és verzióval egy megadott helyi elérési útra
az ml model download --name my-model --version 1 --download-path local_path --resource-group my-resource-group --workspace-name my-workspace
Kötelező paraméterek
A modell neve.
A modell verziója.
Opcionális paraméterek
A modellfájlok letöltésének elérési útja, alapértelmezés szerint az aktuális munkakönyvtár.
Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID
: .
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
az ml model list
Modellek listázása egy munkaterületen/beállításjegyzékben. Ha beállításjegyzéket használ, cserélje le --workspace-name my-workspace
a --registry-name <registry-name>
beállítást.
az ml model list [--archived-only]
[--include-archived]
[--max-results]
[--name]
[--registry-name]
[--resource-group]
[--stage]
[--workspace-name]
Példák
A munkaterület összes modelljének listázása
az ml model list --resource-group my-resource-group --workspace-name my-workspace
A munkaterület megadott nevének összes modellverziójának listázása
az ml model list --name my-model --resource-group my-resource-group --workspace-name my-workspace
A munkaterület összes modelljének listázása a --query argumentum használatával JMESPath-lekérdezés végrehajtásához a parancsok eredményein.
az ml model list --query "[].{Name:name}" --output table --resource-group my-resource-group --workspace-name my-workspace
Opcionális paraméterek
Csak archivált modellek listázása.
Archivált modellek és aktív modellek listázása.
A visszaadandó eredmények maximális száma.
A modell neve. Ha meg van adva, a rendszer az ezen a néven szereplő összes modellverziót visszaadja.
Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
A modell fázisa.
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID
: .
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
az ml model package
Ez a parancs előzetes verzióban és fejlesztés alatt áll. Referencia- és támogatási szintek: https://aka.ms/CLI_refstatus
Modell becsomagolása környezetbe.
Amikor egy modell be van csomagolva, létrejön egy környezet, amely az összes függőséggel rendelkezik.
az ml model package --file
--name
--version
[--registry-name]
[--resource-group]
[--workspace-name]
Példák
Modell csomagolása a megadott névvel és verzióval
az ml model package --name my-model --version my-version --resource-group my-resource-group --workspace-name my-workspace --file my-package.yml
Kötelező paraméterek
A modellcsomag definícióját tartalmazó YAML-fájl helyi elérési útja.
A modell neve.
A modell verziója.
Opcionális paraméterek
Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID
: .
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
az ml model restore
Archivált modell visszaállítása.
Az archivált modell visszaállításakor az többé nem lesz elrejtve a lista lekérdezései elől (az ml model list
). Ha egy teljes modelltároló archiválva van, visszaállíthatja az archivált tárolót. Ezzel visszaállítja a modell összes verzióját az adott név alatt. Nem állíthat vissza csak egy adott modellverziót, ha a teljes modelltároló archiválva van – a teljes tárolót vissza kell állítania. Ha csak egy adott modellverzió lett archiválva, visszaállíthatja az adott verziót.
az ml model restore --name
[--label]
[--registry-name]
[--resource-group]
[--version]
[--workspace-name]
Példák
Archivált modelltároló visszaállítása (a modell összes verzióját visszaállítja)
az ml model restore --name my-model --resource-group my-resource-group --workspace-name my-workspace
Adott archivált modellverzió visszaállítása
az ml model restore --name my-model --version 1 --resource-group my-resource-group --workspace-name my-workspace
Kötelező paraméterek
A modell neve.
Opcionális paraméterek
A modell címkéje.
Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
A modell verziója.
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID
: .
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
az ml model share
Egy adott modell megosztása a munkaterületről a beállításjegyzékbe.
Másolja a meglévő modellt egy munkaterületről egy beállításjegyzékbe a munkaterületek közötti újrafelhasználáshoz.
az ml model share --name
--registry-name
--share-with-name
--share-with-version
--version
[--resource-group]
[--workspace-name]
Példák
Meglévő környezet megosztása a munkaterületről a beállításjegyzékbe
az ml model share --name my-model --version my-version --resource-group my-resource-group --workspace-name my-workspace --share-with-name new-name-in-registry --share-with-version new-version-in-registry --registry-name my-registry
Kötelező paraméterek
A modell neve.
Céljegyzék.
A létrehozandó modell neve.
A létrehozandó modell verziója.
A modell verziója.
Opcionális paraméterek
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID
: .
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
az ml model show
Modell részleteinek megjelenítése egy munkaterületen/beállításjegyzékben. Ha beállításjegyzéket használ, cserélje le --workspace-name my-workspace
a --registry-name <registry-name>
beállítást.
az ml model show --name
[--label]
[--registry-name]
[--resource-group]
[--version]
[--workspace-name]
Példák
A megadott névvel és verzióval rendelkező modell részleteinek megjelenítése
az ml model show --name my-model --version 1 --resource-group my-resource-group --workspace-name my-workspace
Kötelező paraméterek
A modell neve.
Opcionális paraméterek
A modell címkéje.
Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
A modell verziója.
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID
: .
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.
az ml model update
Modell frissítése egy munkaterületen/beállításjegyzékben.
A "leírás" és a "címkék" tulajdonságok frissíthetők. Ha beállításjegyzéket használ, cserélje le --workspace-name my-workspace
a --registry-name <registry-name>
beállítást.
az ml model update --name
--resource-group
[--add]
[--force-string]
[--label]
[--registry-name]
[--remove]
[--set]
[--stage]
[--version]
[--workspace-name]
Példák
Modell ízeinek frissítése
az ml model update --name my-model --version 1 --set flavors.python_function.python_version=3.8 --resource-group my-resource-group --workspace-name my-workspace
Kötelező paraméterek
A modell neve.
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
Opcionális paraméterek
Adjon hozzá egy objektumot az objektumok listájához egy elérési út és egy kulcsértékpár megadásával. Példa: --add property.listProperty <key=value, string or JSON string>
A "set" vagy a "add" használata esetén a JSON-ra való konvertálás helyett őrizze meg a sztringkonstansokat.
A modell címkéje.
Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.
Tulajdonság vagy elem eltávolítása a listából. Példa: --remove property.list <indexToRemove>
VAGY --remove propertyToRemove
.
Frissítsen egy objektumot egy beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=<value>
A modell fázisa.
A modell verziója.
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID
: .
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.