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

Azure ML online vé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 üzemelő példánysal, így az egyetlen pontozási végpont forgalmát szükség esetén több üzemelő példány is kiszolgálhatja. Ez olyan helyzetekben hasznos, mint a szabályozott bevezetés.

Az Azure ML kétféle végponttípust támogat: online és kötegelt. Az online végpontok támogatják a valós idejű következtetést, míg a kötegelt végpontok offline kötegelt pontozáshoz használatosak.

Parancsok

az ml online-endpoint create	Hozzon létre egy végpontot.
az ml online-endpoint delete	Végpont törlése.
az ml online-endpoint get-credentials	Egy online végpont jogkivonatának/kulcsainak listázása.
az ml online-endpoint invoke	Végpont meghívása.
az ml online-endpoint list	Egy munkaterület végpontjainak listázása.
az ml online-endpoint regenerate-keys	Hozza létre újra egy online végpont kulcsait.
az ml online-endpoint show	A végpont részleteinek megjelenítése.
az ml online-endpoint update	Végpont frissítése.

az ml online-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 online-endpoint create --resource-group
                             --workspace-name
                             [--auth-mode]
                             [--file]
                             [--local {false, true}]
                             [--name]
                             [--no-wait]
                             [--set]

Példák

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

az ml online-endpoint create --file endpoint.yml --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

--auth-mode

A végpont hitelesítési módszere. Megengedett értékek: kulcs, aml_token. Alapértelmezett: kulcs.

--file -f

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

--local

Hozzon létre helyileg végpontot. Megjegyzés: a forgalom és a hitelesítés helyileg nem támogatott. Közvetlenül használhatja az "az ml online-deployment create --local" parancsot. Létrehoz egy végpontot, ha még nem létezik.

elfogadott értékek: false, true

--name -n

Az online vé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).

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

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml online-endpoint delete

Végpont törlése.

az ml online-endpoint delete --name
                             --resource-group
                             --workspace-name
                             [--local {false, true}]
                             [--no-wait]
                             [--yes]

Példák

Online végpont törlése az összes üzemelő példányával együtt

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

Kötelező paraméterek

--name -n

Az online vé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.

Opcionális paraméterek

--local

Helyi végpont törlése.

elfogadott értékek: false, true

--no-wait

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

--yes -y

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

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml online-endpoint get-credentials

Egy online végpont jogkivonatának/kulcsainak listázása.

az ml online-endpoint get-credentials --name
                                      --resource-group
                                      --workspace-name

Példák

Online végpont kulcsainak listázása

az ml online-endpoint get-credentials --name my-online-endpoint --resource-group my-resource-group --workspace-name my-workspace

Kötelező paraméterek

--name -n

Az online vé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.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml online-endpoint invoke

Végpont meghívása.

Meghívhat egy online végpontot néhány kérelemadattal. Ez valós idejű következtetés, és a pontozási eredmények azonnal vissza lesznek adva.

az ml online-endpoint invoke --name
                             --resource-group
                             --workspace-name
                             [--deployment-name]
                             [--local {false, true}]
                             [--request-file]

Példák

Online végpont meghívása néhány kérelemadattal

az ml online-endpoint invoke --name my-online-endpoint --request-file sample_request.json --resource-group my-resource-group --workspace-name my-workspace

Online végpont meghívása egy adott üzemelő példány megcélzásával

az ml online-endpoint invoke --name my-online-endpoint --deployment my-deployment --request-file sample_request.json --resource-group my-resource-group --workspace-name my-workspace

Kötelező paraméterek

--name -n

Az online vé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.

Opcionális paraméterek

--deployment-name -d

A célként megadott üzemelő példány neve.

--local

Helyi végpont meghívása. Ez csak akkor működik, ha helyi üzembe helyezést hoztak létre ehhez a végponthoz.

elfogadott értékek: false, true

--request-file -r

A kérelemadatokat tartalmazó JSON-fájl helyi elérési útja.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml online-endpoint list

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

az ml online-endpoint list --resource-group
                           --workspace-name
                           [--local {false, true}]

Példák

Egy munkaterület összes online végpontjának listázása

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

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

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

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

az ml online-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 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

--local

Listázd az összes helyi végpontot.

elfogadott értékek: false, true

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml online-endpoint regenerate-keys

Hozza létre újra egy online végpont kulcsait.

az ml online-endpoint regenerate-keys --name
                                      --resource-group
                                      --workspace-name
                                      [--key-type]
                                      [--no-wait]

Példák

Kulcsok újragenerálása egy online végponthoz

az ml online-endpoint regenerate-keys --name my-online-endpoint --resource-group my-resource-group --workspace-name my-workspace

Kötelező paraméterek

--name -n

Az online vé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.

Opcionális paraméterek

--key-type

Az újragenerálandó kulcs típusa. Engedélyezett értékek: elsődleges, másodlagos.

alapértelmezett érték: primary

--no-wait

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

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml online-endpoint show

A végpont részleteinek megjelenítése.

az ml online-endpoint show --name
                           --resource-group
                           --workspace-name
                           [--local {false, true}]

Példák

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

az ml online-endpoint show --name my-online-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 online-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

Az online vé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.

Opcionális paraméterek

--local

Helyi végpont megjelenítése.

elfogadott értékek: false, true

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml online-endpoint update

Végpont frissítése.

A végpontok "description", "tags" és "traffic" 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 online-endpoint update --resource-group
                             --workspace-name
                             [--add]
                             [--file]
                             [--force-string]
                             [--local {false, true}]
                             [--mirror-traffic]
                             [--name]
                             [--no-wait]
                             [--remove]
                             [--set]
                             [--traffic]

Példák

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

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

Végpont forgalmi beállításainak frissítése

az ml online-endpoint update --name my-online-endpoint  --traffic "my-new-deployment=100" --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>.

--file -f

Az Azure ML online végpont specifikációját tartalmazó YAML-fájl helyi elérési útja. Az online végpont YAML-referencia-dokumentumai a következő helyen találhatók: https://aka.ms/ml-cli-v2-endpoint-online-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.

--local

Frissítse a helyi végpontot.

elfogadott értékek: false, true

--mirror-traffic

Az élő forgalom duplikált százalékát egy üzemelő példány betanítása felé irányítja.

--name -n

Az online vé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=.

--traffic -r

Szóközzel elválasztott kulcs-érték párok idézőjelek között a végpont forgalmi beállításaihoz.

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.

--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 a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.