az ml workspace
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-munkaterület parancsának első futtatásakor. További információ a bővítményekről.
Azure ML-munkaterületek kezelése.
Az Azure ML-munkaterület az Azure Machine Learning legfelső szintű erőforrása. Központosított helyet biztosít az ML-munkafolyamatokban használt eszközök és erőforrások, valamint a betanítási feladatokból előállított naplók és összetevők nyomon követéséhez.
Ha cli v1-ről 2-es verzióra frissít, a munkaterület-kezelés hatókörében az alábbi két módosításra van szükség:
- A parancsok frissítése
az ml workspace private-endpoint
egyenértékűaz network private-endpoint
parancsra. - Emellett frissítse
az ml workspace share
a parancsokat egyenértékűaz role assignment create
parancsra.
Parancsok
Name | Description | Típus | Állapot |
---|---|---|---|
az ml workspace create |
Munkaterület létrehozása. |
Mellék | FE |
az ml workspace delete |
Munkaterület törlése. |
Mellék | FE |
az ml workspace diagnose |
Munkaterület beállítási problémáinak diagnosztizálása. |
Mellék | FE |
az ml workspace list |
Az előfizetés összes munkaterületének listázása. |
Mellék | FE |
az ml workspace list-keys |
A függő erőforrások, például az Azure Storage, az Azure Container Registry és a Azure-alkalmazás Insights munkaterületkulcsainak listázása. |
Mellék | FE |
az ml workspace outbound-rule |
Azure ML-munkaterület felügyelt hálózatának kimenő szabályainak kezelése. |
Mellék | FE |
az ml workspace outbound-rule list |
A munkaterülethez tartozó összes felügyelt hálózati kimenő szabály listázása. |
Mellék | FE |
az ml workspace outbound-rule remove |
Távolítsa el a munkaterület felügyelt hálózatából a kimenő szabályt. |
Mellék | FE |
az ml workspace outbound-rule set |
Kimenő szabály hozzáadása vagy frissítése egy munkaterület felügyelt hálózatában. |
Mellék | FE |
az ml workspace outbound-rule show |
Egy munkaterület felügyelt hálózati kimenő szabályának részleteinek megjelenítése. |
Mellék | FE |
az ml workspace provision-network |
Munkaterület által felügyelt hálózat kiépítése. |
Mellék | FE |
az ml workspace show |
Munkaterület részleteinek megjelenítése. |
Mellék | FE |
az ml workspace sync-keys |
A függő erőforrások, például az Azure Storage, az Azure Container Registry és a Azure-alkalmazás Insights munkaterületkulcsainak szinkronizálása. |
Mellék | FE |
az ml workspace update |
Munkaterület frissítése. |
Mellék | FE |
az ml workspace create
Munkaterület létrehozása.
Munkaterület létrehozásakor az Azure ML által használt számos Azure-erőforrás is létrejön alapértelmezés szerint: Azure Storage, Azure Container Registry, Azure Key Vault és Azure-alkalmazás Insights. Ehelyett használhatja a meglévő Azure-erőforráspéldányokat a munkaterület létrehozásakor a munkaterület konfigurációs YAML-fájljában található erőforrásazonosítók megadásával.
az ml workspace create --resource-group
[--allow-roleassignment-on-rg]
[--application-insights]
[--container-registry]
[--default-resource-group]
[--description]
[--display-name]
[--enable-data-isolation]
[--file]
[--hub-id]
[--image-build-compute]
[--key-vault]
[--kind]
[--location]
[--managed-network]
[--name]
[--no-wait]
[--primary-user-assigned-identity]
[--public-network-access]
[--set]
[--storage-account]
[--system-datastores-auth-mode]
[--tags]
[--update-dependent-resources]
Példák
Munkaterület létrehozása YAML-specifikációs fájlból.
az ml workspace create --file workspace.yml --resource-group my-resource-group
Kötelező paraméterek
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
Opcionális paraméterek
Egy jelölő, amely meghatározza, hogy egy munkaterület rendelkezhet-e szerepkör-hozzárendelésekkel az erőforráscsoport szintjén.
A munkaterülethez társított alkalmazáselemzések ARM-azonosítója.
A munkaterülethez társított tárolóregisztrációs adatbázis ARM-azonosítója.
Csak a központ típusa. Ha be van állítva, akkor a központ gyermekprojektje alapértelmezés szerint ezt az erőforráscsoportot állítja be.
Az Azure ML-munkaterület leírása.
A munkaterület megjelenítendő neve.
Jelölő annak megállapításához, hogy egy munkaterületen engedélyezve van-e az adatelkülönítés. A jelölő csak a létrehozási szakaszban állítható be, nem frissíthető.
Az Azure ML-munkaterület specifikációját tartalmazó YAML-fájl helyi elérési útja. A munkaterület YAML-referencia-dokumentációja a következő helyen található: https://aka.ms/ml-cli-v2-workspace-yaml-reference.
Csak projekttípus: A projekt szülőközpontját meghatározó ARM-azonosító.
Annak a számítási célnak a neve, amelyet a környezet Docker-rendszerképeinek létrehozásához használ, ha a tárolóregisztrációs adatbázis egy virtuális hálózat mögött található.
A munkaterülethez társított kulcstartó ARM-azonosítója.
A munkaterületeket adott típusként adja meg, felül kell bírálni a YAML-ben hozzárendelt értéket, ha az jelen van. Alapértelmezés szerint. Az érvényes típusok a következők: alapértelmezett, központ és projekt.
Az új munkaterülethez használandó hely.
Felügyelt hálózatelkülönítési mód a munkaterülethez.
Az Azure ML-munkaterület neve.
Ne várja meg, amíg a munkaterület létrehozása befejeződik.
Az elsődleges felhasználó által hozzárendelt felügyelt identitás ARM-azonosítója, ha több is meg van adva. A fürt nélküli számítás alapértelmezett felügyelt identitása is.
Nyilvános végpontkapcsolat engedélyezése, ha egy munkaterület engedélyezve van a privát kapcsolaton.
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 munkaterülethez társított tárfiók ARM-azonosítója.
Megadja a rendszeradattárak hitelesítési módját. Az érvényes módok a következők: accesskey és identity.
Szóközzel elválasztott kulcs-érték párok az objektum címkéihez.
A --update_dependent_resources megadásával ön hozzájárul a munkaterülettől függő erőforrások frissítéséhez. A munkaterülethez csatolt Azure Container Registry- vagy Application Insights-erőforrás frissítése megszakíthatja a korábbi feladatok sorát, az üzembe helyezett következtetési végpontokat, illetve a munkaterület korábbi feladatainak újrafuttatását.
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 workspace delete
Munkaterület törlése.
Alapértelmezés szerint a munkaterülethez társított függő erőforrások (Azure Storage, Azure Container Registry, Azure Key Vault, Azure-alkalmazás Insights) nem törlődnek. Ha ezeket is törölni szeretné, vegye fel a --all-resources parancsot. A munkaterület végleges törléséhez adja meg a --permanent-delete parancsot.
az ml workspace delete --name
--resource-group
[--all-resources]
[--no-wait]
[--permanently-delete]
[--yes]
Kötelező paraméterek
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
Opcionális paraméterek
Törölje a munkaterülethez társított összes függő erőforrást (Azure Storage-fiók, Azure Container Registry, Azure-alkalmazás Insights, Azure Key Vault).
Ne várja meg, amíg a hosszú ideig futó művelet befejeződik. Az alapértelmezett érték Hamis.
A munkaterületek alapértelmezés szerint helyreállíthatóan törölt állapotban vannak a munkaterület adatainak helyreállításához. Állítsa be ezt a jelzőt úgy, hogy felülbírálja a helyreállítható törlési viselkedést, és véglegesen törölje a munkaterületet.
Ne kérje a megerősítést.
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 workspace diagnose
Munkaterület beállítási problémáinak diagnosztizálása.
Ha a munkaterület nem a várt módon működik, a diagnózis futtatásával ellenőrizheti, hogy a munkaterület hibás-e. A privát végpont munkaterülete esetében az is segít, hogy ellenőrizze, hogy a munkaterület és a függő erőforrás hálózati beállítása problémás-e vagy sem.
az ml workspace diagnose --name
--resource-group
[--no-wait]
Példák
munkaterület diagnosztizálása.
az ml workspace diagnose --name my-workspace-name --no-wait -g my-resource-group
Kötelező paraméterek
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
Opcionális paraméterek
Ne várja meg, amíg a hosszú ideig futó művelet befejeződik. Az alapértelmezett érték Hamis.
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 workspace list
Az előfizetés összes munkaterületének listázása.
A munkaterületek listája erőforráscsoportonként szűrhető.
az ml workspace list [--filtered-kinds]
[--max-results]
[--resource-group]
Példák
Az erőforráscsoport összes munkaterületének listázása
az ml workspace list --resource-group my-resource-group
Sorolja fel az összes munkaterületet a --query argumentum használatával, hogy JMESPath-lekérdezést hajtson végre a parancsok eredményein.
az ml workspace list --query "[].{Name:name}" --output table --resource-group my-resource-group
Opcionális paraméterek
Csak a megadott típusú munkaterületeket sorolja fel vesszővel tagolt listaként. Az érvényes típusok a következők: alapértelmezett, központ és projekt.
A visszaadandó eredmények maximális száma.
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<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 workspace list-keys
A függő erőforrások, például az Azure Storage, az Azure Container Registry és a Azure-alkalmazás Insights munkaterületkulcsainak listázása.
az ml workspace list-keys --name
--resource-group
Kötelező paraméterek
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<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 workspace provision-network
Munkaterület által felügyelt hálózat kiépítése.
Aktiválja a munkaterületet a felügyelt hálózat kiépítéséhez. A Spark-kompatibilis jelző megadása előkészíti a munkaterület felügyelt hálózatát a Spark támogatásához. Az alapértelmezett érték hamis, ha nincs megadva, de később engedélyezhető a parancs ismételt futtatásával ezzel a jelzővel. Az engedélyezés után nem tiltható le.
az ml workspace provision-network --name
--resource-group
[--include-spark]
[--no-wait]
Példák
felügyelt hálózat kiépítése.
az ml workspace provision-network --include-spark --name my-workspace-name --no-wait -g my-resource-group
Kötelező paraméterek
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
Opcionális paraméterek
Logikai [igaz/hamis], ha a felügyelt hálózatot ki kell építeni a Spark-feladatok figyelembe vételéhez. Az alapértelmezett érték hamis, ha a jelölő nincs beállítva. Később ezt a parancsot ezzel a jelzővel újra futtatva engedélyezheti.
Ne várja meg, amíg a hosszú ideig futó művelet befejeződik. Az alapértelmezett érték Hamis.
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 workspace show
Munkaterület részleteinek megjelenítése.
az ml workspace show --name
--resource-group
Kötelező paraméterek
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<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 workspace sync-keys
A függő erőforrások, például az Azure Storage, az Azure Container Registry és a Azure-alkalmazás Insights munkaterületkulcsainak szinkronizálása.
Ha a munkaterület bármely erőforrásának kulcsait módosítják, az automatikus frissítésük körülbelül egy órát is igénybe vehet. Ez a parancs aktiválja a munkaterületet a kulcsok azonnali szinkronizálásához. Lehetséges forgatókönyv, hogy a tárkulcsok újragenerálása után azonnal hozzá kell férni a tárolóhoz.
az ml workspace sync-keys --name
--resource-group
[--no-wait]
Kötelező paraméterek
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>
: .
Opcionális paraméterek
Ne várja meg, amíg a hosszú ideig futó művelet befejeződik. Az alapértelmezett érték Hamis.
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 workspace update
Munkaterület frissítése.
A "leírás", a "címkék" és a "friendly_name" tulajdonságok frissíthetők.
az ml workspace update --name
--resource-group
[--add]
[--allow-roleassignment-on-rg]
[--application-insights]
[--container-registry]
[--description]
[--display-name]
[--file]
[--force-string]
[--image-build-compute]
[--managed-network]
[--no-wait]
[--primary-user-assigned-identity]
[--public-network-access]
[--remove]
[--set]
[--system-datastores-auth-mode]
[--update-dependent-resources]
Példák
egy munkaterület frissítése YAML-specifikációs fájlból.
az ml workspace update --resource-group my-resource-group --name my-workspace-name --file workspace.yml
Kötelező paraméterek
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>
: .
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>
Egy jelölő, amely meghatározza, hogy egy munkaterület rendelkezhet-e szerepkör-hozzárendelésekkel az erőforráscsoport szintjén.
A munkaterülethez társított alkalmazáselemzések ARM-azonosítója.
A munkaterülethez társított tárolóregisztrációs adatbázis ARM-azonosítója.
Az Azure ML-munkaterület leírása.
A munkaterület megjelenítendő neve.
Az Azure ML-munkaterület specifikációját tartalmazó YAML-fájl helyi elérési útja. A munkaterület YAML-referencia-dokumentációja a következő helyen található: https://aka.ms/ml-cli-v2-workspace-yaml-reference.
A "set" vagy a "add" használata esetén a JSON-ra való konvertálás helyett őrizze meg a sztringkonstansokat.
Annak a számítási célnak a neve, amelyet a környezet Docker-rendszerképeinek létrehozásához használ, ha a tárolóregisztrációs adatbázis egy virtuális hálózat mögött található.
Felügyelt hálózatelkülönítési mód a munkaterülethez.
Ne várja meg, amíg a hosszú ideig futó művelet befejeződik. Az alapértelmezett érték Hamis.
A munkaterülethez társított elsődleges felhasználó által hozzárendelt identitás ARM-azonosítója.
Nyilvános végpontkapcsolat engedélyezése, ha egy munkaterület engedélyezve van a privát kapcsolaton.
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>
Megadja a rendszeradattárak hitelesítési módját. Az érvényes módok a következők: accesskey és identity.
A --update_dependent_resources megadásával ön hozzájárul a munkaterülettől függő erőforrások frissítéséhez. A munkaterülethez csatolt Azure Container Registry- vagy Application Insights-erőforrás frissítése megszakíthatja a korábbi feladatok sorát, az üzembe helyezett következtetési végpontokat, illetve a munkaterület korábbi feladatainak újrafuttatását.
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.