az ml batch-endpoint

  • 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 ett az ml batch-endpoint-kommando . Läs mer om tillägg.

Hantera Azure ML-batchslutpunkter.

Azure ML-slutpunkter tillhandahåller ett enkelt gränssnitt för att skapa och hantera modelldistributioner. Varje slutpunkt kan ha en eller flera distributioner. Batchslutpunkter används för batchbedömning offline.

Kommandon

Name Description Typ Status
az ml batch-endpoint create

Skapa en slutpunkt.

 Anknytning Allmän tillgänglighet
az ml batch-endpoint delete

Ta bort en slutpunkt.

 Anknytning Allmän tillgänglighet
az ml batch-endpoint invoke

Anropa en slutpunkt.

 Anknytning Allmän tillgänglighet
az ml batch-endpoint list

Visa en lista över slutpunkter i en arbetsyta.

 Anknytning Allmän tillgänglighet
az ml batch-endpoint list-jobs

Lista batchbedömningsjobben för en batchslutpunkt.

 Anknytning Allmän tillgänglighet
az ml batch-endpoint show

Visa information för en slutpunkt.

 Anknytning Allmän tillgänglighet
az ml batch-endpoint update

Uppdatera en slutpunkt.

 Anknytning Allmän tillgänglighet

az ml batch-endpoint create

Skapa en slutpunkt.

Om du vill skapa en slutpunkt anger du en YAML-fil med en batchslutpunktskonfiguration. Om slutpunkten redan finns skrivs den över med de nya inställningarna.

az ml batch-endpoint create --resource-group
                            --workspace-name
                            [--file]
                            [--name]
                            [--no-wait]
                            [--set]

Exempel

Skapa en slutpunkt från en YAML-specifikationsfil

az ml batch-endpoint create --file endpoint.yml --resource-group my-resource-group --workspace-name my-workspace

Skapa en slutpunkt med namn

az ml batch-endpoint create --name endpointname --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

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

Valfria parametrar

--file -f

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

--name -n

Namnet på batchslutpunkten.

--no-wait

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

standardvärde: False
--set

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

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 batch-endpoint delete

Ta bort en slutpunkt.

az ml batch-endpoint delete --name
                            --resource-group
                            --workspace-name
                            [--no-wait]
                            [--yes]

Exempel

Ta bort en batchslutpunkt, inklusive alla dess distributioner

az ml batch-endpoint delete --name my-batch-endpoint --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--name -n

Namnet på batchslutpunkten.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

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

Valfria parametrar

--no-wait

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

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 batch-endpoint invoke

Anropa en slutpunkt.

Du kan starta batchinferenskörningen genom att anropa slutpunkten med vissa data. För batchslutpunkter utlöser anrop ett asynkront batchbedömningsjobb.

az ml batch-endpoint invoke --name
                            --resource-group
                            --workspace-name
                            [--deployment-name]
                            [--experiment-name]
                            [--file]
                            [--input]
                            [--input-type]
                            [--inputs]
                            [--instance-count]
                            [--job-name]
                            [--mini-batch-size]
                            [--output-path]
                            [--outputs]
                            [--set]

Exempel

Anropa en batchslutpunkt med indata från en registrerad Azure ML-datatillgång och åsidosätt standarddistributionsinställningen för mini_batch_size

az ml batch-endpoint invoke --name my-batch-endpoint --input azureml:my-dataset:1 --mini-batch-size 64 --resource-group my-resource-group --workspace-name my-workspace

Anropa en batchslutpunkt med indatafil från en offentlig URI

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_file --input https://pipelinedata.blob.core.windows.net/sampledata/mnist/0.png --resource-group my-resource-group --workspace-name my-workspace

Anropa en batchslutpunkt med indatafil från ett registrerat datalager

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_file --input azureml://datastores/workspaceblobstore/paths/{path_to_data}/mnist/0.png --resource-group my-resource-group --workspace-name my-workspace

Anropa en batchslutpunkt med indatamappen från en offentlig URI

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_folder --input https://pipelinedata.blob.core.windows.net/sampledata/mnist --resource-group my-resource-group --workspace-name my-workspace

Anropa en batchslutpunkt med indatamappen från ett registrerat datalager

az ml batch-endpoint invoke --name my-batch-endpoint --input-type uri_folder --input azureml://datastores/workspaceblobstore/paths/{path_to_data}/mnist --resource-group my-resource-group --workspace-name my-workspace

Anropa en batchslutpunkt med filer i en lokal mapp

az ml batch-endpoint invoke --name my-batch-endpoint --input ./mnist_folder --resource-group my-resource-group --workspace-name my-workspace

Anropa en batchslutpunkt med en lokal mapp som sökväg för indata och utdata och skriv över vissa inställningar för batchdistribution under slutpunktsanrop

az ml batch-endpoint invoke --name my-batch-endpoint --input ./mnist_folder --instance-count 2 --mini-batch-size 5 --output-path azureml://datastores/workspaceblobstore/paths/tests/output --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--name -n

Namnet på batchslutpunkten.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

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

Valfria parametrar

--deployment-name -d

Namnet på distributionen till målet.

--experiment-name

Namnet på experimentet för distribution av pipelinekomponenter.

--file -f

Namnet på filen som används för batch-anropa.

--input

Referens till indata som ska användas för batchinferens. Det kan vara en sökväg i datalager, offentlig URI, en registrerad datatillgång eller en lokal mappsökväg.

--input-type

Typ av indata som anger om det är en fil eller en mapp. Använd detta när du använder en sökväg i datalager eller offentlig URI. Värden som stöds: uri_folder, uri_file.

--inputs

Ordlista över indata för anropande jobb.

--instance-count -c

Antal instanser som förutsägelsen körs på.

--job-name

Namnet på jobbet för batch-anropa.

--mini-batch-size -m

Storleken på varje minibatch som indata delas upp i för förutsägelse.

--output-path

Sökväg till det datalager där utdatafiler laddas upp till.

--outputs

Ordlista för att ange var resultatet ska lagras.

--set

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

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 batch-endpoint list

Visa en lista över slutpunkter i en arbetsyta.

az ml batch-endpoint list --resource-group
                          --workspace-name

Exempel

Visa en lista över alla batchslutpunkter i en arbetsyta

az ml batch-endpoint list --resource-group my-resource-group --workspace-name my-workspace

Visa en lista över alla batchslutpunkter i en arbetsyta

az ml batch-endpoint list  --resource-group my-resource-group --workspace-name my-workspace

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

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

Obligatoriska parametrar

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<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 batch-endpoint list-jobs

Lista batchbedömningsjobben för en batchslutpunkt.

az ml batch-endpoint list-jobs --name
                               --resource-group
                               --workspace-name

Exempel

Visa en lista över alla batchbedömningsjobb för en slutpunkt

az ml batch-endpoint list-jobs --name my-batch-endpoint --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--name -n

Namnet på batchslutpunkten.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<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 batch-endpoint show

Visa information för en slutpunkt.

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

Exempel

Visa information för en batchslutpunkt

az ml batch-endpoint show --name my-batch-endpoint  --resource-group my-resource-group --workspace-name my-workspace

Visa etableringstillståndet för en slutpunkt med argumentet --query för att köra en JMESPath-fråga på resultatet av kommandon.

az ml batch-endpoint show -n my-endpoint --query "{Name:name,State:provisioning_state}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--name -n

Namnet på batchslutpunkten.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<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 batch-endpoint update

Uppdatera en slutpunkt.

Egenskaperna "description", "tags" och "defaults" för en slutpunkt kan uppdateras. Dessutom kan nya distributioner läggas till i en slutpunkt och befintliga distributioner kan uppdateras.

az ml batch-endpoint update --resource-group
                            --workspace-name
                            [--add]
                            [--defaults]
                            [--file]
                            [--force-string]
                            [--name]
                            [--no-wait]
                            [--remove]
                            [--set]

Exempel

Uppdatera en slutpunkt från en YAML-specifikationsfil

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

Lägga till en ny distribution till en befintlig slutpunkt

az ml batch-endpoint update --name my-batch-endpoint  --set defaults.deployment_name=depname  --resource-group my-resource-group --workspace-name my-workspace

Obligatoriska parametrar

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<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: []
--defaults

Uppdatera deployment_name i standardinställningarna för slutpunktsanrop.

--file -f

Lokal sökväg till YAML-filen som innehåller Azure ML-batchslutpunktsspecifikationen. YAML-referensdokumenten för batchslutpunkten finns på: https://aka.ms/ml-cli-v2-endpoint-batch-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
--name -n

Namnet på batchslutpunkten.

--no-wait

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

standardvärde: False
--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: []
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.