Hantera Azure Machine Learning-arbetsytor med Azure CLI-tillägget v1

GÄLLER FÖR: Azure CLI ml-tillägget v1

Viktigt!

Några av Azure CLI-kommandona i den här artikeln använder azure-cli-mltillägget , eller v1, för Azure Machine Learning. Stödet för v1-tillägget upphör den 30 september 2025. Du kommer att kunna installera och använda v1-tillägget fram till det datumet.

Vi rekommenderar att du övergår till mltillägget , eller v2, före den 30 september 2025. Mer information om v2-tillägget finns i Azure ML CLI-tillägget och Python SDK v2.

I den här artikeln får du lära dig hur du skapar och hanterar Azure Machine Learning-arbetsytor med hjälp av Azure CLI. Azure CLI tillhandahåller kommandon för att hantera Azure-resurser och är utformat för att få dig att arbeta snabbt med Azure, med fokus på automatisering. Maskininlärningstillägget för CLI innehåller kommandon för att arbeta med Azure Machine Learning-resurser.

Förutsättningar

• En Azure-prenumeration. Om du inte har någon kan du prova den kostnadsfria eller betalda versionen av Azure Machine Learning.

• Om du vill använda CLI-kommandona i det här dokumentet från din lokala miljö behöver du Azure CLI.

  Om du använder Azure Cloud Shell nås CLI via webbläsaren och finns i molnet.

Begränsningar

• När du skapar en ny arbetsyta kan du antingen automatiskt skapa tjänster som behövs av arbetsytan eller använda befintliga tjänster. Om du vill använda befintliga tjänster från en annan Azure-prenumeration än arbetsytan måste du registrera Azure Machine Learning-namnområdet i prenumerationen som innehåller dessa tjänster. Om du till exempel skapar en arbetsyta i prenumeration A som använder ett lagringskonto i prenumeration B måste Azure Machine Learning-namnområdet registreras i prenumeration B innan arbetsytan kan använda lagringskontot.

  Resursprovidern för Azure Machine Learning är Microsoft.MachineLearningServices. Information om hur du ser om den är registrerad eller registrerar den finns i Azure-resursprovidrar och typer.

  Viktigt!

  Den här informationen gäller endast för resurser som tillhandahålls när arbetsytan skapas: Azure Storage-konton, Azure Container Registry, Azure Key Vault och Application Insights.

Dricks

En Azure Application Insights-instans skapas när du skapar arbetsytan. Du kan ta bort Application Insights-instansen när klustret har skapats om du vill. Om du tar bort den begränsas den information som samlas in från arbetsytan och kan göra det svårare att felsöka problem. Om du tar bort Application Insights-instansen som skapats av arbetsytan är det enda sättet att återskapa den att ta bort och återskapa arbetsytan.

Mer information om hur du använder Application Insights-instansen finns i Övervaka och samla in data från Machine Learning-webbtjänstslutpunkter.

Säker CLI-kommunikation

Vissa Av Azure CLI-kommandona kommunicerar med Azure Resource Manager via Internet. Den här kommunikationen skyddas med HTTPS/TLS 1.2.

Med Azure Machine Learning CLI-tillägget v1 (azure-cli-ml) kommunicerar bara några av kommandona med Azure Resource Manager. Mer specifikt kommandon som skapar, uppdaterar, tar bort, listar eller visar Azure-resurser. Åtgärder som att skicka ett träningsjobb kommunicerar direkt med Azure Machine Learning-arbetsytan. Om din arbetsyta skyddas med en privat slutpunkt räcker det för att skydda kommandon som tillhandahålls av azure-cli-ml tillägget.

Ansluta CLI till din Azure-prenumeration

Viktigt!

Om du använder Azure Cloud Shell kan du hoppa över det här avsnittet. Cloud Shell autentiserar dig automatiskt med det konto som du loggar in på din Azure-prenumeration.

Det finns flera sätt att autentisera till din Azure-prenumeration från CLI. Det enklaste är att interaktivt autentisera med hjälp av en webbläsare. Om du vill autentisera interaktivt öppnar du en kommandorad eller terminal och använder följande kommando:

az login

Om CLI kan öppna din standardwebbläsare så sker det och en inloggningssida läses in. Annars måste du öppna en webbläsare och följa anvisningarna på kommandoraden. Anvisningarna omfattar att bläddra till https://aka.ms/devicelogin och ange en auktoriseringskod.

Dricks

När du har loggat in visas en lista över prenumerationer som är associerade med ditt Azure-konto. Prenumerationsinformationen med isDefault: true är den för närvarande aktiverade prenumerationen för Azure CLI-kommandon. Den här prenumerationen måste vara samma som innehåller din Azure Machine Learning-arbetsyta. Du hittar prenumerationsinformationen på översiktssidan för din arbetsyta i Azure Portal.

Om du vill välja en annan prenumeration som ska användas för Azure CLI-kommandon kör az account set -s <subscription> du kommandot och anger prenumerationsnamnet eller ID:t att växla till. Mer information om val av prenumeration finns i Använda flera Azure-prenumerationer.

Andra metoder för autentisering finns i Logga in med Azure CLI.

Skapa en resursgrupp

Azure Machine Learning-arbetsytan måste skapas i en resursgrupp. Du kan välja en befintlig resursgrupp eller skapa en ny. Använd följande kommando för att skapa en ny resursgrupp. Ersätt <resource-group-name> med namnet som ska användas för den här resursgruppen. Ersätt <location> med den Azure-region som ska användas för den här resursgruppen:

Kommentar

Du bör välja en region där Azure Machine Learning är tillgängligt. Mer information finns i Produkter som är tillgängliga per region.

az group create --name <resource-group-name> --location <location>

Svaret från det här kommandot liknar följande JSON. Du kan använda utdatavärdena för att hitta de skapade resurserna eller parsa dem som indata till efterföljande CLI-steg för automatisering.

{
  "id": "/subscriptions/<subscription-GUID>/resourceGroups/<resourcegroupname>",
  "location": "<location>",
  "managedBy": null,
  "name": "<resource-group-name>",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null,
  "type": null
}

Mer information om hur du arbetar med resursgrupper finns i az group.

Skapa en arbetsyta

När du distribuerar en Azure Machine Learning-arbetsyta krävs olika andra tjänster som beroende associerade resurser. När du använder CLI för att skapa arbetsytan kan CLI antingen skapa nya associerade resurser åt dig eller koppla befintliga resurser.

Viktigt!

När du kopplar ett eget lagringskonto kontrollerar du att det uppfyller följande kriterier:

• Lagringskontot är inte ett Premium-konto (Premium_LRS och Premium_GRS)
• Både Azure Blob- och Azure File-funktioner aktiverade
• Hierarkiskt namnområde (ADLS Gen 2) är inaktiverat Dessa krav gäller endast för det standardlagringskonto som används av arbetsytan.

När du kopplar Azure-containerregistret måste du ha administratörskontot aktiverat innan det kan användas med en Azure Machine Learning-arbetsyta.

Skapa med nya resurser

Om du vill skapa en ny arbetsyta där tjänsterna skapas automatiskt använder du följande kommando:

az ml workspace create -w <workspace-name> -g <resource-group-name>

Ta med befintliga resurser

Om du vill skapa en arbetsyta som använder befintliga resurser måste du ange resurs-ID:t för varje resurs. Du kan hämta det här ID:t antingen via fliken Egenskaper för varje resurs via Azure Portal eller genom att köra följande kommandon med hjälp av Azure CLI.

• Azure Storage-konto: az storage account show --name <storage-account-name> --query "id"
• Azure Application Insights: az monitor app-insights component show --app <application-insight-name> -g <resource-group-name> --query "id"
• Azure Key Vault: az keyvault show --name <key-vault-name> --query "ID"
• Azure Container Registry: az acr show --name <acr-name> -g <resource-group-name> --query "id"

Det returnerade resurs-ID:t har följande format: "/subscriptions/<service-GUID>/resourceGroups/<resource-group-name>/providers/<provider>/<subresource>/<resource-name>".

När du har ID:t för de resurser som du vill använda med arbetsytan använder du baskommandot az workspace create -w <workspace-name> -g <resource-group-name> och lägger till parametrarna och ID:na för de befintliga resurserna. Följande kommando skapar till exempel en arbetsyta som använder ett befintligt containerregister:

az ml workspace create -w <workspace-name>
                       -g <resource-group-name>
                       --container-registry "/subscriptions/<service-GUID>/resourceGroups/<resource-group-name>/providers/Microsoft.ContainerRegistry/registries/<acr-name>"

Viktigt!

När du kopplar befintliga resurser behöver du inte ange alla. Du kan ange en eller flera. Du kan till exempel ange ett befintligt lagringskonto så skapar arbetsytan de andra resurserna.

Utdata från kommandot för att skapa arbetsytor liknar följande JSON. Du kan använda utdatavärdena för att hitta de skapade resurserna eller parsa dem som indata till efterföljande CLI-steg.

{
  "applicationInsights": "/subscriptions/<service-GUID>/resourcegroups/<resource-group-name>/providers/microsoft.insights/components/<application-insight-name>",
  "containerRegistry": "/subscriptions/<service-GUID>/resourcegroups/<resource-group-name>/providers/microsoft.containerregistry/registries/<acr-name>",
  "creationTime": "2019-08-30T20:24:19.6984254+00:00",
  "description": "",
  "friendlyName": "<workspace-name>",
  "id": "/subscriptions/<service-GUID>/resourceGroups/<resource-group-name>/providers/Microsoft.MachineLearningServices/workspaces/<workspace-name>",
  "identityPrincipalId": "<GUID>",
  "identityTenantId": "<GUID>",
  "identityType": "SystemAssigned",
  "keyVault": "/subscriptions/<service-GUID>/resourcegroups/<resource-group-name>/providers/microsoft.keyvault/vaults/<key-vault-name>",
  "location": "<location>",
  "name": "<workspace-name>",
  "resourceGroup": "<resource-group-name>",
  "storageAccount": "/subscriptions/<service-GUID>/resourcegroups/<resource-group-name>/providers/microsoft.storage/storageaccounts/<storage-account-name>",
  "type": "Microsoft.MachineLearningServices/workspaces",
  "workspaceid": "<GUID>"
}

Avancerade konfigurationer

Konfigurera arbetsyta för privat nätverksanslutning

Beroende på ditt användningsfall och organisationens krav kan du välja att konfigurera Azure Machine Learning med hjälp av privata nätverksanslutningar. Du kan använda Azure CLI för att distribuera en arbetsyta och en slutpunkt för privat länk för arbetsyteresursen. Mer information om hur du använder en privat slutpunkt och ett virtuellt nätverk (VNet) med din arbetsyta finns i Översikt över isolering och sekretess för virtuella nätverk. För komplexa resurskonfigurationer, se även mallbaserade distributionsalternativ, inklusive Azure Resource Manager.

Om du vill begränsa arbetsytans åtkomst till ett virtuellt nätverk kan du använda följande parametrar som en del av az ml workspace create kommandot eller använda az ml workspace private-endpoint kommandona.

az ml workspace create -w <workspace-name>
                       -g <resource-group-name>
                       --pe-name "<pe name>"
                       --pe-auto-approval "<pe-autoapproval>"
                       --pe-resource-group "<pe name>"
                       --pe-vnet-name "<pe name>"
                       --pe-subnet-name "<pe name>"

• --pe-name: Namnet på den privata slutpunkt som skapas.
• --pe-auto-approval: Om privata slutpunktsanslutningar till arbetsytan ska godkännas automatiskt.
• --pe-resource-group: Resursgruppen som den privata slutpunkten ska skapas i. Måste vara samma grupp som innehåller det virtuella nätverket.
• --pe-vnet-name: Det befintliga virtuella nätverket för att skapa den privata slutpunkten i.
• --pe-subnet-name: Namnet på det undernät som den privata slutpunkten ska skapas i. Standardvärdet är default.

Mer information om hur du använder dessa kommandon finns på CLI-referenssidorna.

Kundhanterad nyckel och arbetsyta med hög affärspåverkan

Som standard lagras metadata för arbetsytan i en Azure Cosmos DB-instans som Microsoft underhåller. Dessa data krypteras med hjälp av Microsoft-hanterade nycklar. I stället för att använda den Microsoft-hanterade nyckeln kan du även ange en egen nyckel. På så sätt skapas en extra uppsättning resurser i din Azure-prenumeration för att lagra dina data.

Mer information om de resurser som skapas när du tar med din egen nyckel för kryptering finns i Datakryptering med Azure Machine Learning.

Använd parametern --cmk-keyvault för att ange det Azure Key Vault som innehåller nyckeln och --resource-cmk-uri för att ange resurs-ID och URI för nyckeln i valvet.

Om du vill begränsa de data som Microsoft samlar in på din arbetsyta kan du dessutom ange parametern --hbi-workspace .

az ml workspace create -w <workspace-name>
                       -g <resource-group-name>
                       --cmk-keyvault "<cmk keyvault name>"
                       --resource-cmk-uri "<resource cmk uri>"
                       --hbi-workspace

Kommentar

Auktorisera Machine Learning-appen (i Identitets- och åtkomsthantering) med deltagarbehörigheter för din prenumeration för att hantera ytterligare resurser för datakryptering.

Kommentar

Azure Cosmos DB används inte för att lagra information som modellprestanda, information som loggas av experiment eller information som loggas från dina modelldistributioner. Mer information om hur du övervakar dessa objekt finns i avsnittet Övervakning och loggning i artikeln arkitektur och begrepp.

Viktigt!

Du kan bara välja hög affärspåverkan när du skapar en arbetsyta. Du kan inte ändra den här inställningen när arbetsytan har skapats.

Mer information om kundhanterade nycklar och arbetsyta med hög affärspåverkan finns i Företagssäkerhet för Azure Machine Learning.

Använda CLI för att hantera arbetsytor

Hämta information om arbetsytan

Använd följande kommando för att få information om en arbetsyta:

az ml workspace show -w <workspace-name> -g <resource-group-name>

Uppdatera en arbetsyta

Om du vill uppdatera en arbetsyta använder du följande kommando:

az ml workspace update -n <workspace-name> -g <resource-group-name>

Synkronisera nycklar för beroende resurser

Om du ändrar åtkomstnycklar för en av de resurser som används av din arbetsyta tar det ungefär en timme innan arbetsytan synkroniseras med den nya nyckeln. Om du vill tvinga arbetsytan att synkronisera de nya nycklarna omedelbart använder du följande kommando:

az ml workspace sync-keys -w <workspace-name> -g <resource-group-name>

Mer information om hur du ändrar nycklar finns i Återskapa åtkomstnycklar för lagring.

Ta bort en arbetsyta

Varning

Om mjuk borttagning är aktiverat för arbetsytan kan den återställas efter borttagningen. Om mjuk borttagning inte är aktiverat eller om du väljer alternativet att ta bort arbetsytan permanent kan den inte återställas. Mer information finns i Återställa en borttagen arbetsyta.

Om du vill ta bort en arbetsyta när den inte längre behövs använder du följande kommando:

az ml workspace delete -w <workspace-name> -g <resource-group-name>

Viktigt!

Om du tar bort en arbetsyta tas inte programinsikten, lagringskontot, nyckelvalvet eller containerregistret bort som används av arbetsytan.

Du kan också ta bort resursgruppen, som tar bort arbetsytan och alla andra Azure-resurser i resursgruppen. Om du vill ta bort resursgruppen använder du följande kommando:

az group delete -g <resource-group-name>

Dricks

Standardbeteendet för Azure Machine Learning är att mjuk borttagning av arbetsytan. Det innebär att arbetsytan inte tas bort omedelbart, utan i stället markeras för borttagning. Mer information finns i Mjuk borttagning.

Felsökning

Resursproviderfel

När du skapar en Azure Machine Learning-arbetsyta eller en resurs som används av arbetsytan kan du få ett fel som liknar följande meddelanden:

• No registered resource provider found for location {location}
• The subscription is not registered to use namespace {resource-provider-namespace}

De flesta resursprovidrar registreras automatiskt, men inte alla. Om du får det här meddelandet måste du registrera den angivna providern.

Följande tabell innehåller en lista över de resursprovidrar som krävs av Azure Machine Learning:

Resursprovider	Varför det behövs
Microsoft.MachineLearningServices	Skapa Azure Machine Learning-arbetsytan.
Microsoft.Storage	Azure Storage-kontot används som standardlagring för arbetsytan.
Microsoft.ContainerRegistry	Azure Container Registry används av arbetsytan för att skapa Docker-avbildningar.
Microsoft.KeyVault	Azure Key Vault används av arbetsytan för att lagra hemligheter.
Microsoft.Notebooks	Integrerade notebook-filer på Azure Machine Learning-beräkningsinstansen.
Microsoft.ContainerService	Om du planerar att distribuera tränade modeller till Azure Kubernetes Services.

Om du planerar att använda en kundhanterad nyckel med Azure Machine Learning måste följande tjänsteleverantörer registreras:

Resursprovider	Varför det behövs
Microsoft.DocumentDB	Azure CosmosDB-instans som loggar metadata för arbetsytan.
Microsoft.Search	Azure Search tillhandahåller indexeringsfunktioner för arbetsytan.

Om du planerar att använda ett hanterat virtuellt nätverk med Azure Machine Learning måste resursprovidern Microsoft.Network vara registrerad. Den här resursprovidern används av arbetsytan när du skapar privata slutpunkter för det hanterade virtuella nätverket.

Information om hur du registrerar resursprovidrar finns i Lösa fel för registrering av resursprovider.

Flytta arbetsytan

Varning

Det går inte att flytta din Azure Machine Learning-arbetsyta till en annan prenumeration eller flytta den ägande prenumerationen till en ny klientorganisation. Detta kan orsaka fel.

Ta bort Azure Container Registry

Azure Machine Learning-arbetsytan använder Azure Container Registry (ACR) för vissa åtgärder. Den skapar automatiskt en ACR-instans när den först behöver en.

Varning

När ett Azure Container Registry har skapats för en arbetsyta ska du inte ta bort det. Detta bryter din Azure Machine Learning-arbetsyta.

Nästa steg

Mer information om Azure CLI-tillägget för maskininlärning finns i dokumentationen om az ml (v1).

Information om hur du söker efter problem med din arbetsyta finns i Så här använder du arbetsytediagnostik.

Information om hur du flyttar en arbetsyta till en ny Azure-prenumeration finns i Så här flyttar du en arbetsyta.

Information om hur du håller Din Azure Machine Learning uppdaterad med de senaste säkerhetsuppdateringarna finns i Sårbarhetshantering.