az ml workspace

  • Referencia

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 Tanulás 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 Elemzések 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 Elemzések 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 Elemzések. 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
                       [--application-insights]
                       [--container-registry]
                       [--description]
                       [--display-name]
                       [--enable-data-isolation]
                       [--file]
                       [--image-build-compute]
                       [--key-vault]
                       [--location]
                       [--managed-network]
                       [--name]
                       [--no-wait]
                       [--primary-user-assigned-identity]
                       [--public-network-access]
                       [--set]
                       [--storage-account]
                       [--tags]
                       [--update-dependent-resources]
                       [--workspace-hub]

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

--resource-group -g

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

Opcionális paraméterek

--application-insights -a

A munkaterülethez társított alkalmazáselemzések ARM-azonosítója.

--container-registry -c

A munkaterülethez társított tárolóregisztrációs adatbázis ARM-azonosítója.

--description

Az Azure ML-munkaterület leírása.

--display-name

A munkaterület megjelenítendő neve.

--enable-data-isolation -e

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

alapértelmezett érték: False
--file -f

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.

--image-build-compute -i

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

--key-vault -k

A munkaterülethez társított kulcstartó ARM-azonosítója.

--location -l

Az új munkaterülethez használandó hely.

--managed-network -m
Előnézet

Felügyelt hálózatelkülönítési mód a munkaterülethez.

--name -n

Az Azure ML-munkaterület neve.

--no-wait

Ne várja meg, amíg a munkaterület létrehozása befejeződik.

alapértelmezett érték: False
--primary-user-assigned-identity -p

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.

--public-network-access

Nyilvános végpontkapcsolat engedélyezése, ha egy munkaterület engedélyezve van a privát kapcsolaton.

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

--storage-account -s

A munkaterülethez társított tárfiók ARM-azonosítója.

--tags

Szóközzel elválasztott kulcs-érték párok az objektum címkéihez.

--update-dependent-resources -u

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 alkalmazás Elemzések erőforrás frissítése megszakíthatja a korábbi feladatok, az üzembe helyezett következtetési végpontok, illetve a munkaterület korábbi feladatainak újrafuttatásának képességét.

alapértelmezett érték: False
--workspace-hub
Előnézet

A munkaterület létrehozásához megadott ARM-azonosító projekt-munkaterület lesz, és minden függő erőforrás a WorkspaceHubról lesz felhasználva.

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 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 Elemzések) 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

--name -n

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

--resource-group -g

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

Opcionális paraméterek

--all-resources

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 Elemzések, Azure Key Vault).

alapértelmezett érték: False
--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
--permanently-delete -p

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.

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

--name -n

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

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<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
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 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 [--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

--max-results -r

A visszaadandó eredmények maximális száma.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<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 workspace list-keys

A függő erőforrások, például az Azure Storage, az Azure Container Registry és a Azure-alkalmazás Elemzések munkaterületkulcsainak listázása.

az ml workspace list-keys --name
                          --resource-group

Kötelező paraméterek

--name -n

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

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<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 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

--name -n

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

--resource-group -g

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

Opcionális paraméterek

--include-spark

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.

alapértelmezett érték: False
--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
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 workspace show

Munkaterület részleteinek megjelenítése.

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

Kötelező paraméterek

--name -n

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

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<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 workspace sync-keys

A függő erőforrások, például az Azure Storage, az Azure Container Registry és a Azure-alkalmazás Elemzések 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

--name -n

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

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<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
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 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]
                       [--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]
                       [--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

--name -n

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

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<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: []
--application-insights -a

A munkaterülethez társított alkalmazáselemzések ARM-azonosítója.

--container-registry -c

A munkaterülethez társított tárolóregisztrációs adatbázis ARM-azonosítója.

--description

Az Azure ML-munkaterület leírása.

--display-name

A munkaterület megjelenítendő neve.

--file -f

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.

--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
--image-build-compute -i

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

--managed-network -m
Előnézet

Felügyelt hálózatelkülönítési mód a munkaterülethez.

--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
--primary-user-assigned-identity -p

A munkaterülethez társított elsődleges felhasználó által hozzárendelt identitás ARM-azonosítója.

--public-network-access

Nyilvános végpontkapcsolat engedélyezése, ha egy munkaterület engedélyezve van a privát kapcsolaton.

--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: []
--update-dependent-resources -u

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 alkalmazás Elemzések erőforrás frissítése megszakíthatja a korábbi feladatok, az üzembe helyezett következtetési végpontok, illetve a munkaterület korábbi feladatainak újrafuttatásának képességét.

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.