az ml batch-endpoint

Megjegyzé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 batch-végpontok offline kötegelt pontozáshoz használatosak.

Parancsok

az ml batch-endpoint create

Hozzon létre egy végpontot.

az ml batch-endpoint delete

Végpont törlése.

az ml batch-endpoint invoke

Végpont meghívása.

az ml batch-endpoint list

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

az ml batch-endpoint list-jobs

A kötegelt pontozási feladatok listázása egy kötegvégponthoz.

az ml batch-endpoint show

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

az ml batch-endpoint update

Végpont frissítése.

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 a következővel az configure --defaults group=<name>konfigurálhatja: .

--workspace-name -w

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

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.

--set

Objektum frissítése egy beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=.

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 a következővel az configure --defaults group=<name>konfigurálhatja: .

--workspace-name -w

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

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.

--yes -y

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

az ml batch-endpoint invoke

Végpont meghívása.

A kötegkövetkeztetés futtatását a végpont egyes adatokkal való meghívásával indíthatja el. Kötegelt végpontok esetén a hívás egy aszinkron kötegelt pontozási feladatot indít el.

az ml batch-endpoint invoke --input
                            --name
                            --resource-group
                            --workspace-name
                            [--deployment-name]
                            [--input-type]
                            [--instance-count]
                            [--job-name]
                            [--mini-batch-size]
                            [--output-path]
                            [--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

Kötegelt végpont meghívása bemeneti fájllal 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 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

Helyi mappával rendelkező kötegelt végpont meghívása 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

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

--name -n

A kötegvégpont neve.

--resource-group -g

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

--workspace-name -w

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

Opcionális paraméterek

--deployment-name -d

A cél üzembe helyezésének neve.

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

--instance-count -c

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

--job-name

A kötegelt hí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.

--set

Objektum frissítése egy beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=.

az ml batch-endpoint list

Egy munkaterület végpontjainak listázása.

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 egy munkaterület összes kötegelt vé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 a következővel az configure --defaults group=<name>konfigurálhatja: .

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett csoportot a használatával az configure --defaults workspace=<name>konfigurálhatja.

az ml batch-endpoint list-jobs

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

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 a használatával az configure --defaults group=<name>konfigurálhatja.

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett csoportot a használatával az configure --defaults workspace=<name>konfigurálhatja.

az ml batch-endpoint show

A 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 a --query argumentummal 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 a használatával az configure --defaults group=<name>konfigurálhatja.

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett csoportot a használatával az configure --defaults workspace=<name>konfigurálhatja.

az ml batch-endpoint update

Végpont frissítése.

A végpontok "description", "tags" és "defaults" tulajdonságai frissíthetők. Emellett új üzemelő példányok is hozzáadhatók a végpontokhoz, é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 a használatával az configure --defaults group=<name>konfigurálhatja.

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett csoportot a használatával az configure --defaults workspace=<name>konfigurálhatja.

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 vagy JSON string>.

--defaults

Frissítse deployment_name a végponthívás alapértelmezett beállításain belül.

--file -f

Az Azure ML batch-endpoint specifikációját tartalmazó YAML-fájl helyi elérési útja. A kötegelt végpont 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 az "add" használatakor őrizze meg a sztringkonstansokat ahelyett, hogy JSON-ra próbálnál konvertálni.

--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 a False (Hamis).

--remove

Tulajdonság vagy elem eltávolítása egy listából. Példa: --remove property.list OR --remove propertyToRemove.

--set

Objektum frissítése a beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=.