Dela via

az ml workspace

  • Referens

Kommentar

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 kommandot az ml workspace . Läs mer om tillägg.

Hantera Azure ML-arbetsytor.

En Azure ML-arbetsyta är resursen på den översta nivån för Azure Mašinsko učenje. 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.
  • az ml workspace share Uppgradera även kommandon till motsvarande az role assignment create kommandon.

Kommandon

Name Description Typ Status
az ml workspace create

Skapa en arbetsyta.

 Anknytning Allmän tillgänglighet
az ml workspace delete

Ta bort en arbetsyta.

 Anknytning Allmän tillgänglighet
az ml workspace diagnose

Diagnostisera problem med konfiguration av arbetsytor.

 Anknytning Allmän tillgänglighet
az ml workspace list

Visa en lista över alla arbetsytor i en prenumeration.

 Anknytning Allmän tillgänglighet
az ml workspace list-keys

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

 Anknytning Allmän tillgänglighet
az ml workspace outbound-rule

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

 Anknytning Allmän tillgänglighet
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.

 Anknytning Allmän tillgänglighet
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.

 Anknytning Allmän tillgänglighet
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.

 Anknytning Allmän tillgänglighet
az ml workspace outbound-rule show

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

 Anknytning Allmän tillgänglighet
az ml workspace provision-network

Etablera ett hanterat nätverk för arbetsytan.

 Anknytning Allmän tillgänglighet
az ml workspace show

Visa information för en arbetsyta.

 Anknytning Allmän tillgänglighet
az ml workspace sync-keys

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

 Anknytning Allmän tillgänglighet
az ml workspace update

Uppdatera en arbetsyta.

 Anknytning Allmän tillgänglighet

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

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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
Förhandsgranskning

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.

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

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

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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 .az configure --defaults workspace=<name>

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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 .az configure --defaults workspace=<name>

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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 .az configure --defaults workspace=<name>

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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 .az configure --defaults workspace=<name>

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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 .az configure --defaults workspace=<name>

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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 .az configure --defaults workspace=<name>

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .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]
                       [--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 .az configure --defaults workspace=<name>

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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
Förhandsgranskning

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

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

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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