Dela via

az ml workspace

  • Referens

Not

Den här referensen är en del av ml-tillägget för Azure CLI (version 2.15.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az ml workspace kommando. Läs mer om tillägg.

Hantera Azure ML-arbetsytor.

En Azure ML-arbetsyta är resursen på den översta nivån för Azure Machine Learning. Det ger en central plats för att spåra de tillgångar och resurser som används i dina ML-arbetsflöden, tillsammans med loggarna och artefakterna som skapas från dina träningsjobb.

Om du uppgraderar från CLI v1 till v2 behöver du följande två ändringar i omfånget för arbetsytehantering:

  • Uppgradera az ml workspace private-endpoint kommandon till motsvarande az network private-endpoint kommandon.
  • Uppgradera även az ml workspace share kommandon till motsvarande az role assignment create kommandon.

Kommandon

Name Description Typ Status
az ml workspace create

Skapa en arbetsyta.

 Förlängning GA
az ml workspace delete

Ta bort en arbetsyta.

 Förlängning GA
az ml workspace diagnose

Diagnostisera problem med konfiguration av arbetsytor.

 Förlängning GA
az ml workspace list

Visa en lista över alla arbetsytor i en prenumeration.

 Förlängning GA
az ml workspace list-keys

Visa en lista över arbetsytenycklar för beroende resurser som Azure Storage, Azure Container Registry och Azure Application Insights.

 Förlängning GA
az ml workspace outbound-rule

Hantera regler för utgående trafik för det hanterade nätverket på en Azure ML-arbetsyta.

 Förlängning GA
az ml workspace outbound-rule list

Visa en lista över alla regler för utgående trafik för ett hanterat nätverk för en arbetsyta.

 Förlängning GA
az ml workspace outbound-rule remove

Ta bort en regel för utgående trafik från det hanterade nätverket för en arbetsyta.

 Förlängning GA
az ml workspace outbound-rule set

Lägga till eller uppdatera en regel för utgående trafik i det hanterade nätverket för en arbetsyta.

 Förlängning GA
az ml workspace outbound-rule show

Visa information om en utgående regel för ett hanterat nätverk för en arbetsyta.

 Förlängning GA
az ml workspace provision-network

Etablera ett hanterat nätverk för arbetsytan.

 Förlängning GA
az ml workspace show

Visa information för en arbetsyta.

 Förlängning GA
az ml workspace sync-keys

Synkronisera arbetsytenycklar för beroende resurser som Azure Storage, Azure Container Registry och Azure Application Insights.

 Förlängning GA
az ml workspace update

Uppdatera en arbetsyta.

 Förlängning GA

az ml workspace create

Skapa en arbetsyta.

När en arbetsyta skapas skapas också flera Azure-resurser som ska användas av Azure ML som standard: Azure Storage, Azure Container Registry, Azure Key Vault och Azure Application Insights. Du kan i stället använda befintliga Azure-resursinstanser för dem när du skapar arbetsytan genom att ange resurs-ID:t i YAML-filen för arbetsytans konfiguration.

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]
                       [--provision-network-now]
                       [--public-network-access]
                       [--set]
                       [--storage-account]
                       [--system-datastores-auth-mode]
                       [--tags]
                       [--update-dependent-resources]

Exempel

Skapa en arbetsyta från en YAML-specifikationsfil.

az ml workspace create --file workspace.yml --resource-group my-resource-group

Obligatoriska parametrar

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--allow-roleassignment-on-rg -r
Förhandsgranskning

En flagga för att avgöra om en arbetsyta kan ha rolltilldelningar på resursgruppsnivå.

Standardvärde: True
--application-insights -a

ARM-ID för de programinsikter som är associerade med den här arbetsytan.

--container-registry -c

ARM-ID för containerregistret som är associerat med den här arbetsytan.

--default-resource-group
Förhandsgranskning

Hubbtyp endast. Om det anges får underordnade projekt i den här hubben sin resursgrupp inställd som standard.

--description

Beskrivning av Azure ML-arbetsytan.

--display-name

Visningsnamn för arbetsytan.

--enable-data-isolation -e

En flagga för att avgöra om en arbetsyta har dataisolering aktiverat. Flaggan kan bara anges i skapandefasen, den kan inte uppdateras.

Standardvärde: False
--file -f

Lokal sökväg till YAML-filen som innehåller specifikationen för Azure ML-arbetsytan. YAML-referensdokumenten för arbetsytan finns på: https://aka.ms/ml-cli-v2-workspace-yaml-reference.

--hub-id
Förhandsgranskning

Endast projekttyp: Ett ARM-ID som definierar projektets överordnade hubb.

--image-build-compute -i

Namnet på beräkningsmålet som ska användas för att skapa Docker-avbildningar i miljön när containerregistret ligger bakom ett virtuellt nätverk.

--key-vault -k

ARM-ID för nyckelvalvet som är associerat med den här arbetsytan.

--kind
Förhandsgranskning

Anger arbetsytorna som en specifik typ, vilket åsidosätter värdet som tilldelats i YAML, om det finns. Standardvärdet är standard. Giltiga typer är: standard, hubb och projekt.

--location -l

Den plats som ska användas för den nya arbetsytan.

--managed-network -m

Läget för hanterad nätverksisolering för arbetsytan.

--name -n

Namnet på Azure ML-arbetsytan.

--no-wait

Vänta inte tills arbetsytan har skapats.

Standardvärde: False
--primary-user-assigned-identity -p

ARM-identifierare för den primära användartilldelade hanterade identiteten, om flera har angetts. Även standardhanterad identitet för klusterlös beräkning.

--provision-network-now
Förhandsgranskning

Ställ in för att utlösa etableringen av det hanterade nätverket när du skapar en arbetslösning med det bemannade nätverket aktiverat, annars gör det ingenting.

Standardvärde: False
--public-network-access

Tillåt offentlig slutpunktsanslutning när en arbetsyta är privat länk aktiverad.

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=value.

--storage-account -s

ARM-ID för lagringskontot som är associerat med den här arbetsytan.

--system-datastores-auth-mode -d
Förhandsgranskning

Anger autentiseringsläget för systemdatalager. Giltiga lägen är: accesskey och identitet.

--tags

Blankstegsavgränsade nyckel/värde-par för objektets taggar.

--update-dependent-resources -u

Om du anger --update_dependent_resources ger du ditt medgivande att uppdatera de arbetsyteberoende resurserna. Uppdatering av den arbetsyteanslutna Azure Container Registry- eller Application Insights-resursen kan bryta ursprunget för tidigare jobb, distribuerade slutpunkter för slutsatsdragning eller din möjlighet att köra tidigare jobb på den här arbetsytan igen.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml workspace delete

Ta bort en arbetsyta.

Som standard tas inte de beroende resurser som är associerade med arbetsytan (Azure Storage, Azure Container Registry, Azure Key Vault, Azure Application Insights) bort. Ta även bort dem genom att inkludera --all-resources. Om du vill ta bort arbetsytan permanent tar du med --permanent-delete.

az ml workspace delete --name
                       --resource-group
                       [--all-resources]
                       [--no-wait]
                       [--permanently-delete]
                       [--yes]

Obligatoriska parametrar

--name -n

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--all-resources

Ta bort alla beroende resurser som är associerade med arbetsytan (Azure Storage-konto, Azure Container Registry, Azure Application Insights, Azure Key Vault).

Standardvärde: False
--no-wait

Vänta inte tills den tidskrävande åtgärden har slutförts. Standardvärdet är Falskt.

Standardvärde: False
--permanently-delete -p

Arbetsytor är mjukt borttagna som standard för att tillåta återställning av arbetsytedata. Ange den här flaggan för att åsidosätta beteendet för mjuk borttagning och ta bort arbetsytan permanent.

Standardvärde: False
--yes -y

Fråga inte efter bekräftelse.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml workspace diagnose

Diagnostisera problem med konfiguration av arbetsytor.

Om arbetsytan inte fungerar som förväntat kan du köra den här diagnosen för att kontrollera om arbetsytan har brutits. För den privata slutpunktsarbetsytan hjälper den också till att kontrollera om nätverkskonfigurationen på den här arbetsytan och dess beroende resurs har problem eller inte.

az ml workspace diagnose --name
                         --resource-group
                         [--no-wait]

Exempel

diagnostisera en arbetsyta.

az ml workspace diagnose --name my-workspace-name --no-wait -g my-resource-group

Obligatoriska parametrar

--name -n

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--no-wait

Vänta inte tills den tidskrävande åtgärden har slutförts. Standardvärdet är Falskt.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml workspace list

Visa en lista över alla arbetsytor i en prenumeration.

Listan över arbetsytor kan filtreras efter resursgrupp.

az ml workspace list [--filtered-kinds]
                     [--max-results]
                     [--resource-group]

Exempel

Visa en lista över alla arbetsytor i en resursgrupp

az ml workspace list --resource-group my-resource-group

Visa en lista över alla arbetsytor med argumentet --query för att köra en JMESPath-fråga på resultatet av kommandon.

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

Valfria parametrar

--filtered-kinds
Förhandsgranskning

Lista endast de angivna typerna av arbetsytor som en kommaavgränsad lista. Giltiga typer är: standard, hubb och projekt.

--max-results -r

Maximalt antal resultat som ska returneras.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml workspace list-keys

Visa en lista över arbetsytenycklar för beroende resurser som Azure Storage, Azure Container Registry och Azure Application Insights.

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

Obligatoriska parametrar

--name -n

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml workspace provision-network

Etablera ett hanterat nätverk för arbetsytan.

Utlöser arbetsytan för att etablera det hanterade nätverket. När du anger spark-aktiverad flagga förbereds arbetsytans hanterade nätverk för stöd för Spark. Standardvärdet är falskt om det inte anges men kan aktiveras senare genom att köra det här kommandot igen med den här flaggan. När den är aktiverad kan den inte inaktiveras.

az ml workspace provision-network --name
                                  --resource-group
                                  [--include-spark]
                                  [--no-wait]

Exempel

etablera ett hanterat nätverk.

az ml workspace provision-network --include-spark --name my-workspace-name --no-wait -g my-resource-group

Obligatoriska parametrar

--name -n

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--include-spark

Booleskt [sant/falskt] för om det hanterade nätverket ska etableras för att ta hänsyn till Spark-jobb. Standardvärdet är falskt om flaggan inte har angetts. Det kan aktiveras senare genom att köra det här kommandot igen med den här flaggan.

Standardvärde: False
--no-wait

Vänta inte tills den tidskrävande åtgärden har slutförts. Standardvärdet är Falskt.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml workspace show

Visa information för en arbetsyta.

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

Obligatoriska parametrar

--name -n

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml workspace sync-keys

Synkronisera arbetsytenycklar för beroende resurser som Azure Storage, Azure Container Registry och Azure Application Insights.

Om nycklarna för en resurs på arbetsytan ändras kan det ta ungefär en timme innan de uppdateras automatiskt. Det här kommandot utlöser arbetsytan för att omedelbart synkronisera nycklar. Ett möjligt scenario är att behöva omedelbar åtkomst till lagring när lagringsnycklarna har återskapats.

az ml workspace sync-keys --name
                          --resource-group
                          [--no-wait]

Obligatoriska parametrar

--name -n

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--no-wait

Vänta inte tills den tidskrävande åtgärden har slutförts. Standardvärdet är Falskt.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml workspace update

Uppdatera en arbetsyta.

Egenskaperna "description", "tags" och "friendly_name" kan uppdateras.

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]
                       [--network-acls]
                       [--no-wait]
                       [--primary-user-assigned-identity]
                       [--public-network-access]
                       [--remove]
                       [--set]
                       [--system-datastores-auth-mode]
                       [--update-dependent-resources]

Exempel

uppdatera en arbetsyta från en YAML-specifikationsfil.

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

Obligatoriska parametrar

--name -n

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az configure --defaults workspace=<name>.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

Standardvärde: []
--allow-roleassignment-on-rg -r
Förhandsgranskning

En flagga för att avgöra om en arbetsyta kan ha rolltilldelningar på resursgruppsnivå.

--application-insights -a

ARM-ID för de programinsikter som är associerade med den här arbetsytan.

--container-registry -c

ARM-ID för containerregistret som är associerat med den här arbetsytan.

--description

Beskrivning av Azure ML-arbetsytan.

--display-name

Visningsnamn för arbetsytan.

--file -f

Lokal sökväg till YAML-filen som innehåller specifikationen för Azure ML-arbetsytan. YAML-referensdokumenten för arbetsytan finns på: https://aka.ms/ml-cli-v2-workspace-yaml-reference.

--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

Standardvärde: False
--image-build-compute -i

Namnet på beräkningsmålet som ska användas för att skapa Docker-avbildningar i miljön när containerregistret ligger bakom ett virtuellt nätverk.

--managed-network -m

Läget för hanterad nätverksisolering för arbetsytan.

--network-acls

Kommaavgränsad lista över IP-adresser eller IP-intervall i CIDR-notation som tillåts komma åt arbetsytan. Exempel: "XX.XX.XX.XX,XX.XX.XX.XX/32". Om du vill ange offentlig nätverksåtkomst till "Aktiverad" skickar du networkAcls som "none" (dvs. detta återställer nätverksacls) tillsammans med PNA-flaggan inställd som "Aktiverad". Om du vill inaktivera anger du PNA-flaggan som "Inaktiverad". Om du vill ange offentlig nätverksåtkomst som "Aktiverad från valda IP-adresser" anger du PNA-flaggan som "Aktiverad" och skickar en kommaavgränsad lista med IP-adresser i CIDR-notation i "network-acls".

--no-wait

Vänta inte tills den tidskrävande åtgärden har slutförts. Standardvärdet är Falskt.

Standardvärde: False
--primary-user-assigned-identity -p

ARM-ID för den primära användartilldelade identiteten som är associerad med den här arbetsytan.

--public-network-access

Tillåt offentlig slutpunktsanslutning när en arbetsyta är privat länk aktiverad.

--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

Standardvärde: []
--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

Standardvärde: []
--system-datastores-auth-mode -d
Förhandsgranskning

Anger autentiseringsläget för systemdatalager. Giltiga lägen är: accesskey och identitet.

--update-dependent-resources -u

Om du anger --update_dependent_resources ger du ditt medgivande att uppdatera de arbetsyteberoende resurserna. Uppdatering av den arbetsyteanslutna Azure Container Registry- eller Application Insights-resursen kan bryta ursprunget för tidigare jobb, distribuerade slutpunkter för slutsatsdragning eller din möjlighet att köra tidigare jobb på den här arbetsytan igen.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.