az ml batch-endpoint

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 batch-endpoint parancs első futtatásakor. További információ a bővítményekről.

Azure ML-kötegvégpontok kezelése.

Az Azure ML-végpontok egyszerű felületet biztosítanak a modelltelepítések létrehozásához és kezeléséhez. Minden végpont rendelkezhet egy vagy több üzembe helyezéssel. A kötegvégpontok offline kötegelt pontozáshoz használatosak.

Parancsok

Name Description Típus Állapot
az ml batch-endpoint create

Hozzon létre egy végpontot.

Mellék FE
az ml batch-endpoint delete

Végpont törlése.

Mellék FE
az ml batch-endpoint invoke

Végpont meghívása.

Mellék FE
az ml batch-endpoint list

Végpontok listázása egy munkaterületen.

Mellék FE
az ml batch-endpoint list-jobs

A kötegvégpontozási feladatok listázása.

Mellék FE
az ml batch-endpoint show

Végpont részleteinek megjelenítése.

Mellék FE
az ml batch-endpoint update

Végpont frissítése.

Mellék FE

az ml batch-endpoint create

Hozzon létre egy végpontot.

Végpont létrehozásához adjon meg egy YAML-fájlt kötegelt végpontkonfigurációval. Ha a végpont már létezik, az új beállításokkal felül lesz írva.

az ml batch-endpoint create --resource-group
                            --workspace-name
                            [--file]
                            [--name]
                            [--no-wait]
                            [--set]

Példák

Végpont létrehozása YAML-specifikációs fájlból

az ml batch-endpoint create --file endpoint.yml --resource-group my-resource-group --workspace-name my-workspace

Végpont létrehozása névvel

az ml batch-endpoint create --name endpointname --resource-group my-resource-group --workspace-name my-workspace

Kötelező paraméterek

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>: .

Opcionális paraméterek

--file -f

Az Azure ML batch-endpoint specifikációját tartalmazó YAML-fájl helyi elérési útja. A batch-endpoint YAML-referencia-dokumentációja a következő helyen található: https://aka.ms/ml-cli-v2-endpoint-batch-yaml-reference.

--name -n

A kötegvégpont neve.

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik. Az alapértelmezett érték Hamis.

alapértelmezett érték: False
--set

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=.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

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: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml batch-endpoint delete

Végpont törlése.

az ml batch-endpoint delete --name
                            --resource-group
                            --workspace-name
                            [--no-wait]
                            [--yes]

Példák

Batch-végpont törlése, beleértve az összes üzemelő példányt

az ml batch-endpoint delete --name my-batch-endpoint --resource-group my-resource-group --workspace-name my-workspace

Kötelező paraméterek

--name -n

A kötegvégpont neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>: .

Opcionális paraméterek

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik. Az alapértelmezett érték Hamis.

alapértelmezett érték: False
--yes -y

Ne kérje a megerősítést.

alapértelmezett érték: False
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

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: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml batch-endpoint invoke

Végpont meghívása.

A kötegelt következtetést úgy indíthatja el, hogy a végpontot néhány adattal invoktálja. Kötegvégpontok esetén a meghívás egy aszinkron kötegpontozási feladatot indít el.

az ml batch-endpoint invoke --name
                            --resource-group
                            --workspace-name
                            [--deployment-name]
                            [--experiment-name]
                            [--file]
                            [--input]
                            [--input-type]
                            [--inputs]
                            [--instance-count]
                            [--job-name]
                            [--mini-batch-size]
                            [--output-path]
                            [--outputs]
                            [--set]

Példák

Batch-végpont meghívása egy regisztrált Azure ML-adategység bemeneti adataival, és felülbírálja az alapértelmezett üzembe helyezési beállítást mini_batch_size

az ml batch-endpoint invoke --name my-batch-endpoint --input azureml:my-dataset:1 --mini-batch-size 64 --resource-group my-resource-group --workspace-name my-workspace

Batch-végpont meghívása bemeneti fájllal egy nyilvános URI-ból

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_file --input https://pipelinedata.blob.core.windows.net/sampledata/mnist/0.png --resource-group my-resource-group --workspace-name my-workspace

Batch-végpont meghívása egy regisztrált adattárból származó bemeneti fájllal

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_file --input azureml://datastores/workspaceblobstore/paths/{path_to_data}/mnist/0.png --resource-group my-resource-group --workspace-name my-workspace

Batch-végpont meghívása bemeneti mappával egy nyilvános URI-ból

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_folder --input https://pipelinedata.blob.core.windows.net/sampledata/mnist --resource-group my-resource-group --workspace-name my-workspace

Batch-végpont meghívása egy regisztrált adattárból származó bemeneti mappával

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_folder --input azureml://datastores/workspaceblobstore/paths/{path_to_data}/mnist --resource-group my-resource-group --workspace-name my-workspace

Batch-végpont meghívása helyi mappában lévő fájlokkal

az ml batch-endpoint invoke --name my-batch-endpoint --input ./mnist_folder --resource-group my-resource-group --workspace-name my-workspace

Batch-végpont meghívása helyi mappával bemeneti és kimeneti elérési útként, és a végponthívás során felülír néhány kötegelt üzembehelyezési beállítást

az ml batch-endpoint invoke --name my-batch-endpoint --input ./mnist_folder --instance-count 2 --mini-batch-size 5 --output-path azureml://datastores/workspaceblobstore/paths/tests/output --resource-group my-resource-group --workspace-name my-workspace

Kötelező paraméterek

--name -n

A kötegvégpont neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>: .

Opcionális paraméterek

--deployment-name -d

A célként megadott üzembe helyezés neve.

--experiment-name

A folyamatösszetevő üzembe helyezéséhez használt kísérlet neve.

--file -f

A köteghíváshoz használt fájl neve.

--input

Hivatkozás a kötegelt következtetéshez használandó bemeneti adatokra. Ez lehet az adattár elérési útja, a nyilvános URI, a regisztrált adategység vagy a helyi mappa elérési útja.

--input-type

A bemenet típusa, amely megadja, hogy fájlról vagy mappáról van-e szó. Ezt akkor használja, ha adattárban vagy nyilvános URI-n használ elérési utat. Támogatott értékek: uri_folder, uri_file.

--inputs

A meghívási feladatok bemeneteinek szótára.

--instance-count -c

Azon példányok száma, amelyen az előrejelzés futni fog.

--job-name

A kötegelt meghívás feladatának neve.

--mini-batch-size -m

Az egyes mini kötegek mérete, amelyekre a bemeneti adatok fel lesznek osztva az előrejelzéshez.

--output-path

Azon adattár elérési útja, amelybe a kimeneti fájlok fel lesznek töltve.

--outputs

Az eredmények tárolásának helyét meghatározó szótár.

--set

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=.

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

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: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml batch-endpoint list

Végpontok listázása egy munkaterületen.

az ml batch-endpoint list --resource-group
                          --workspace-name

Példák

A munkaterület összes kötegelt végpontjának listázása

az ml batch-endpoint list --resource-group my-resource-group --workspace-name my-workspace

A munkaterület összes kötegelt végpontjának listázása

az ml batch-endpoint list  --resource-group my-resource-group --workspace-name my-workspace

Listázhatja a munkaterület összes kötegvégpontját a --query argumentum használatával, hogy JMESPath-lekérdezést hajtson végre a parancsok eredményein.

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

Kötelező paraméterek

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--workspace-name -w

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
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

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: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml batch-endpoint list-jobs

A kötegvégpontozási feladatok listázása.

az ml batch-endpoint list-jobs --name
                               --resource-group
                               --workspace-name

Példák

Egy végpont összes kötegelt pontozási feladatának listázása

az ml batch-endpoint list-jobs --name my-batch-endpoint --resource-group my-resource-group --workspace-name my-workspace

Kötelező paraméterek

--name -n

A kötegvégpont neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--workspace-name -w

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
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

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: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml batch-endpoint show

Végpont részleteinek megjelenítése.

az ml batch-endpoint show --name
                          --resource-group
                          --workspace-name

Példák

Batch-végpont részleteinek megjelenítése

az ml batch-endpoint show --name my-batch-endpoint  --resource-group my-resource-group --workspace-name my-workspace

Egy végpont kiépítési állapotának megjelenítése --query argumentummal egy JMESPath-lekérdezés végrehajtásához a parancsok eredményein.

az ml batch-endpoint show -n my-endpoint --query "{Name:name,State:provisioning_state}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Kötelező paraméterek

--name -n

A kötegvégpont neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--workspace-name -w

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
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

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: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml batch-endpoint update

Végpont frissítése.

A végpont "leírás", "címkék" és "alapértelmezett" tulajdonságai frissíthetők. Emellett új üzembe helyezéseket is hozzáadhat egy végponthoz, és a meglévő üzemelő példányok frissíthetők.

az ml batch-endpoint update --resource-group
                            --workspace-name
                            [--add]
                            [--defaults]
                            [--file]
                            [--force-string]
                            [--name]
                            [--no-wait]
                            [--remove]
                            [--set]

Példák

Végpont frissítése YAML-specifikációs fájlból

az ml batch-endpoint update --name my-batch-endpoint --file updated_endpoint.yml --resource-group my-resource-group --workspace-name my-workspace

Új üzembe helyezés hozzáadása meglévő végponthoz

az ml batch-endpoint update --name my-batch-endpoint  --set defaults.deployment_name=depname  --resource-group my-resource-group --workspace-name my-workspace

Kötelező paraméterek

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>: .

Opcionális paraméterek

--add

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>

alapértelmezett érték: []
--defaults

Frissítse deployment_name a végponthívás alapértelmezett beállításai között.

--file -f

Az Azure ML batch-endpoint specifikációját tartalmazó YAML-fájl helyi elérési útja. A batch-endpoint YAML-referencia-dokumentációja a következő helyen található: https://aka.ms/ml-cli-v2-endpoint-batch-yaml-reference.

--force-string

A "set" vagy a "add" használata esetén a JSON-ra való konvertálás helyett őrizze meg a sztringkonstansokat.

alapértelmezett érték: False
--name -n

A kötegvégpont neve.

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik. Az alapértelmezett érték Hamis.

alapértelmezett érték: False
--remove

Tulajdonság vagy elem eltávolítása a listából. Példa: --remove property.list <indexToRemove> VAGY --remove propertyToRemove.

alapértelmezett érték: []
--set

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>

alapértelmezett érték: []
Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

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: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.