az ml service

Notitie

Deze referentie maakt deel uit van de azure-cli-ml-extensie voor Azure CLI en vereist versie 2.0.28 of hoger. De extensie wordt automatisch geïnstalleerd wanneer u de opdracht az ml service voor het eerst hebt uitgevoerd. Meer informatie over extensies.

Operationele services beheren.

Opdracht

az ml service delete

Verwijder een service uit de werkruimte.

az ml service get-access-token

Haal een token op om aanvragen voor een service uit te geven.

az ml service get-keys

Sleutels ophalen om aanvragen voor een service uit te geven.

az ml service get-logs

Logboeken voor een service op te halen.

az ml service list

Lijst met services in de werkruimte.

az ml service regen-key

Sleutels voor een service opnieuw maken.

az ml service run

Voer een service uit in de werkruimte.

az ml service show

Details voor een service in de werkruimte tonen.

az ml service update

Werk een service in de werkruimte bij.

az ml service delete

Verwijder een service uit de werkruimte.

az ml service delete --name
                     [--path]
                     [--resource-group]
                     [--subscription-id]
                     [--workspace-name]
                     [-v]

Vereiste parameters

--name -n

De servicenaam die moet worden verwijderd.

Optionele parameters

--path

Pad naar een projectmap. Standaardinstelling: huidige map.

--resource-group -g

Resourcegroep die overeenkomt met de opgegeven werkruimte.

--subscription-id

Hiermee geeft u de abonnements-id op.

--workspace-name -w

Naam van de werkruimte die de service bevat die moet worden verwijderd.

-v

Meerheidsvlag.

az ml service get-access-token

Haal een token op om aanvragen voor een service uit te geven.

az ml service get-access-token --name
                               [--path]
                               [--resource-group]
                               [--subscription-id]
                               [--workspace-name]
                               [-v]

Vereiste parameters

--name -n

Servicenaam.

Optionele parameters

--path

Pad naar een projectmap. Standaardinstelling: huidige map.

--resource-group -g

Resourcegroep die overeenkomt met de opgegeven werkruimte.

--subscription-id

Hiermee geeft u de abonnements-id op.

--workspace-name -w

Naam van de werkruimte met de service die moet worden weer gegeven.

-v

Meerheidsvlag.

az ml service get-keys

Sleutels ophalen om aanvragen voor een service uit te geven.

az ml service get-keys --name
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

Vereiste parameters

--name -n

Servicenaam.

Optionele parameters

--path

Pad naar een projectmap. Standaardinstelling: huidige map.

--resource-group -g

Resourcegroep die overeenkomt met de opgegeven werkruimte.

--subscription-id

Hiermee geeft u de abonnements-id op.

--workspace-name -w

Naam van de werkruimte met de service die moet worden weer gegeven.

-v

Meerheidsvlag.

az ml service get-logs

Logboeken voor een service op te halen.

az ml service get-logs --name
                       [--init]
                       [--num_lines]
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]
                       [-v]

Vereiste parameters

--name -n

Servicenaam.

Optionele parameters

--init -i

Haal logboeken van de init-container op in plaats van de scoring-container.

--num_lines -l

Het aantal logboekregels dat moet worden terug keren van tail (de standaardwaarde is 5000).

standaardwaarde: 5000
--path

Pad naar een projectmap. Standaardinstelling: huidige map.

--resource-group -g

Resourcegroep die overeenkomt met de opgegeven werkruimte.

--subscription-id

Hiermee geeft u de abonnements-id op.

--workspace-name -w

Naam van de werkruimte met de service die moet worden weer gegeven.

-v

Meerheidsvlag.

az ml service list

Lijst met services in de werkruimte.

az ml service list [--compute-type]
                   [--image-digest]
                   [--model-id]
                   [--model-name]
                   [--path]
                   [--property]
                   [--resource-group]
                   [--subscription-id]
                   [--tag]
                   [--workspace-name]
                   [-v]

Optionele parameters

--compute-type -c

Indien opgegeven, worden alleen services met het opgegeven rekentype weer gegeven. (Opties zijn 'ACI', 'AKS').

--image-digest

Als deze is opgegeven, worden alleen services met de opgegeven samenvatting van de afbeelding.

--model-id

Indien opgegeven, worden alleen services met de opgegeven model-id.

--model-name

Indien opgegeven, worden alleen services met de opgegeven modelnaam.

--path

Pad naar een projectmap. Standaardinstelling: huidige map.

--property

Indien opgegeven, filtert op basis van de opgegeven sleutel/waarde (bijvoorbeeld sleutel of sleutel=waarde). Er kunnen meerdere eigenschappen worden opgegeven met meerdere --eigenschapsopties.

--resource-group -g

Resourcegroep die overeenkomt met de opgegeven werkruimte.

--subscription-id

Hiermee geeft u de abonnements-id op.

--tag

Indien opgegeven, filtert op basis van de opgegeven sleutel/waarde (bijvoorbeeld sleutel of sleutel=waarde). Er kunnen meerdere tags worden opgegeven met meerdere --tag-opties.

--workspace-name -w

Naam van de werkruimte met de services die moeten worden weergegeven.

-v

Meerheidsvlag.

az ml service regen-key

Sleutels voor een service opnieuw maken.

az ml service regen-key --key
                        --name
                        [--path]
                        [--resource-group]
                        [--set-key]
                        [--subscription-id]
                        [--workspace-name]
                        [-v]

Vereiste parameters

--key -k

Welke sleutel opnieuw moet worden ge regenereerd als regen is opgegeven. Opties: Primair, Secundair.

--name -n

Servicenaam.

Optionele parameters

--path

Pad naar een projectmap. Standaardinstelling: huidige map.

--resource-group -g

Resourcegroep die overeenkomt met de opgegeven werkruimte.

--set-key -s

Geef de auth-waarde op voor de opgegeven sleutel.

--subscription-id

Hiermee geeft u de abonnements-id op.

--workspace-name -w

Naam van de werkruimte met de service die moet worden weer gegeven.

-v

Meerheidsvlag.

az ml service run

Voer een service uit in de werkruimte.

az ml service run --name
                  [--input-data]
                  [--path]
                  [--resource-group]
                  [--subscription-id]
                  [--workspace-name]
                  [-v]

Vereiste parameters

--name -n

De servicenaam waar u op moet scoren.

Optionele parameters

--input-data -d

De gegevens die moeten worden gebruikt voor het aanroepen van de webservice.

--path

Pad naar een projectmap. Standaardinstelling: huidige map.

--resource-group -g

Resourcegroep die overeenkomt met de opgegeven werkruimte.

--subscription-id

Hiermee geeft u de abonnements-id op.

--workspace-name -w

Naam van de werkruimte met de service die moet worden uitgevoerd.

-v

Meerheidsvlag.

az ml service show

Details voor een service in de werkruimte tonen.

az ml service show --name
                   [--path]
                   [--resource-group]
                   [--subscription-id]
                   [--workspace-name]
                   [-v]

Vereiste parameters

--name -n

De naam van de webservice die moet worden weer gegeven.

Optionele parameters

--path

Pad naar een projectmap. Standaardinstelling: huidige map.

--resource-group -g

Resourcegroep die overeenkomt met de opgegeven werkruimte.

--subscription-id

Hiermee geeft u de abonnements-id op.

--workspace-name -w

Naam van de werkruimte met de service die moet worden weer gegeven.

-v

Meerheidsvlag.

az ml service update

Werk een service in de werkruimte bij.

az ml service update --name
                     [--add-property]
                     [--add-tag]
                     [--ae]
                     [--ai]
                     [--ar]
                     [--as]
                     [--at]
                     [--autoscale-max-replicas]
                     [--autoscale-min-replicas]
                     [--base-image]
                     [--base-image-registry]
                     [--cc]
                     [--ccl]
                     [--cf]
                     [--collect-model-data]
                     [--cuda-version]
                     [--dc]
                     [--description]
                     [--dn]
                     [--ds]
                     [--ed]
                     [--eg]
                     [--entry-script]
                     [--environment-name]
                     [--environment-version]
                     [--failure-threshold]
                     [--gb]
                     [--gbl]
                     [--gc]
                     [--ic]
                     [--id]
                     [--kp]
                     [--ks]
                     [--lo]
                     [--max-request-wait-time]
                     [--model]
                     [--model-metadata-file]
                     [--no-wait]
                     [--nr]
                     [--path]
                     [--period-seconds]
                     [--po]
                     [--remove-tag]
                     [--replica-max-concurrent-requests]
                     [--resource-group]
                     [--rt]
                     [--sc]
                     [--scoring-timeout-ms]
                     [--sd]
                     [--se]
                     [--sk]
                     [--sp]
                     [--st]
                     [--subscription-id]
                     [--timeout-seconds]
                     [--token-auth-enabled]
                     [--workspace-name]
                     [-v]

Vereiste parameters

--name -n

De servicenaam die moet worden bijgewerkt.

Optionele parameters

--add-property

De eigenschap Sleutel/waarde die moet worden toevoegen (bijvoorbeeld sleutel=waarde). Er kunnen meerdere eigenschappen worden opgegeven met meerdere --add-property-opties.

--add-tag

Sleutel-waardetag die moet worden toevoegen (bijvoorbeeld sleutel=waarde). Er kunnen meerdere tags worden opgegeven met meerdere --add-tag-opties.

--ae --auth-enabled

Hiermee wordt bepaald of sleutel auth voor deze webservice moet worden ingeschakeld. Standaard ingesteld op False.

--ai --enable-app-insights

Hiermee wordt bepaald of AppInsights moet worden ingeschakeld voor deze webservice. Standaard ingesteld op False.

--ar --autoscale-refresh-seconds

Hoe vaak de automatische schaalvergroting moet proberen deze webservice te schalen. Standaardwaarde is 1.

--as --autoscale-enabled

Hiermee wordt bepaald of automatisch schalen voor deze webservice moet worden ingeschakeld. De standaardwaarde is Waar als num_replicas is ingesteld op Geen.

--at --autoscale-target-utilization

Het doelgebruik (in procenten van de 100) moet de automatische schaalverdeder proberen te onderhouden voor deze webservice. De standaardwaarde is 70.

--autoscale-max-replicas --ma

Het maximum aantal containers dat moet worden gebruikt bij het automatisch schalen van deze webservice. De standaardwaarde is 10.

--autoscale-min-replicas --mi

Het minimale aantal containers dat moet worden gebruikt bij het automatisch schalen van deze webservice. Standaardwaarde is 1.

--base-image --bi

Een aangepaste afbeelding die moet worden gebruikt als basisafbeelding. Als er geen basisafbeelding is opgegeven, wordt de basisafbeelding gebruikt op basis van de opgegeven runtimeparameter.

--base-image-registry --ir

Het register met de basisafbeelding.

--cc --cpu-cores

Het aantal CPU-kernen dat voor deze webservice moet worden toegewezen. Kan een decimaal zijn. De standaardwaarde is 0.1.

--ccl --cpu-cores-limit

Het maximum aantal CPU-kernen dat deze webservice mag gebruiken. Kan een decimaal zijn.

--cf --conda-file

Pad naar een lokaal bestand met een conda-omgevingsdefinitie die moet worden gebruikt voor de afbeelding.

--collect-model-data --md

Hiermee wordt bepaald of het verzamelen van modelgegevens voor deze webservice moet worden ingeschakeld. Standaard ingesteld op False.

--cuda-version --cv

Versie van CUDA die moet worden geïnstalleerd voor installatie van installatie-installatie die GPU-ondersteuning nodig heeft. De GPU-afbeelding moet worden gebruikt voor Microsoft Azure Services zoals Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines en Azure Kubernetes Service. Ondersteunde versies zijn 9.0, 9.1 en 10.0. Als 'enable_gpu' is ingesteld, wordt deze standaard ingesteld op '9.1'.

--dc --deploy-config-file

Pad naar een JSON-bestand met metagegevens van de implementatie.

--description -d

Beschrijving van de service.

--dn --dns-name-label

De DNS-naam voor deze webservice.

--ds --extra-docker-file-steps

Pad naar het lokale bestand met aanvullende Docker-stappen die moeten worden uitgevoerd bij het instellen van de afbeelding.

--ed --environment-directory

Map voor Azure Machine Learning omgeving voor implementatie. Dit is hetzelfde mappad als is opgegeven in de opdracht 'az ml environment scaffold'.

--eg --enable-gpu

Of GPU-ondersteuning in de afbeelding moet worden ingeschakeld. De GPU-afbeelding moet worden gebruikt voor Microsoft Azure Services zoals Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines en Azure Kubernetes Service. Standaard ingesteld op False.

--entry-script --es

Pad naar het lokale bestand dat de code bevat die moet worden uitgevoerd voor de service (relatief pad source_directory als er een is opgegeven).

--environment-name -e

Naam van Azure Machine Learning omgeving voor implementatie.

--environment-version --ev

Versie van een bestaande Azure Machine Learning omgeving voor implementatie.

--failure-threshold --ft

Wanneer een pod wordt gestart en de liveheidstest mislukt, probeert Kubernetes --failure-threshold keer voordat het opgeeft. Standaardwaarde is 3. Minimumwaarde is 1.

--gb --memory-gb

De hoeveelheid geheugen (in GB) die moet worden toegewezen voor deze webservice. Kan een decimaal zijn.

--gbl --memory-gb-limit

De maximale hoeveelheid geheugen (in GB) die deze webservice mag gebruiken. Kan een decimaal zijn.

--gc --gpu-cores

Het aantal gpu-kernen dat moet worden toegewezen voor deze webservice. Standaard is 1.

--ic --inference-config-file

Pad naar een JSON- of YAML-bestand met de deferentieconfiguratie.

--id --initial-delay-seconds

Aantal seconden nadat de container is gestart voordat de activiteitstests worden gestart. De standaardwaarde is 310.

--kp --primary-key

Een primaire auth-sleutel voor deze webservice.

--ks --secondary-key

Een secundaire auth-sleutel voor deze webservice.

--lo --location

De Azure-regio om deze webservice in te implementeren. Als deze niet wordt opgegeven, wordt de werkruimtelocatie gebruikt. Meer informatie over beschikbare regio's vindt u hier: https://azure.microsoft.com/en-us/global-infrastructure/services/?regions=all&products=container-instances .

--max-request-wait-time --mr

De maximale tijd dat een aanvraag in de wachtrij blijft (in milliseconden) voordat een 503-fout wordt retourneert. De standaardwaarde is 500.

--model -m

De id van het model dat moet worden geïmplementeerd. Er kunnen meerdere modellen worden opgegeven met extra -m-argumenten. Modellen moeten eerst worden geregistreerd.

--model-metadata-file -f

Pad naar een JSON-bestand met metagegevens van modelregistratie. Meerdere modellen kunnen worden opgegeven met behulp van meerdere -f parameters.

--no-wait

Vlag om niet te wachten op asynchrone aanroepen.

--nr --num-replicas

Het aantal containers dat voor deze webservice moet worden toegewezen. Geen standaardinstelling: als deze parameter niet is ingesteld, wordt de automatische schaalset standaard ingeschakeld.

--path

Pad naar een projectmap. Standaardinstelling: huidige map.

--period-seconds --ps

Hoe vaak (in seconden) de activiteitstest moet worden uitgevoerd. De standaardwaarde is 10 seconden. Minimumwaarde is 1.

--po --port

De lokale poort waarop het HTTP-eindpunt van de service beschikbaar wordt gemaakt.

--remove-tag

De sleutel van de tag die moet worden verwijderd. Er kunnen meerdere tags worden opgegeven met meerdere --remove-tag-opties.

--replica-max-concurrent-requests --rm

Het maximum aantal gelijktijdige aanvragen per knooppunt dat is toegestaan voor deze webservice. Standaardwaarde is 1.

--resource-group -g

Resourcegroep die overeenkomt met de opgegeven werkruimte.

--rt --runtime

Welke runtime moet worden gebruikt voor de afbeelding. De huidige ondersteunde runtimes zijn 'spark-py' en 'python'spark-py|python|python-slim.

--sc --ssl-cname

De cname voor als SSL is ingeschakeld. Alleen van toepassing bij het bijwerken van een ACI-service.

--scoring-timeout-ms --tm

Een time-out die moet worden afgedwongen voor scoring-aanroepen naar deze webservice. De standaardwaarde is 60000.

--sd --source-directory

Pad naar mappen die alle bestanden bevatten om de afbeelding te maken.

--se --ssl-enabled

Hiermee wordt bepaald of SSL moet worden ingeschakeld voor deze webservice. Standaard ingesteld op False.

--sk --ssl-key-pem-file

Het sleutelbestand dat nodig is als SSL is ingeschakeld.

--sp --ssl-cert-pem-file

Het certificaatbestand dat nodig is als SSL is ingeschakeld.

--st --success-threshold

De minimale opeenvolgende successen voor de activiteitstest voordat de test succesvol of mislukt is. Standaardwaarde is 1. Minimumwaarde is 1.

--subscription-id

Hiermee geeft u de abonnements-id op.

--timeout-seconds --ts

Het aantal seconden waarna er een times-out is voor de liveness-test. De standaardwaarde is 2 seconden. Minimumwaarde is 1.

--token-auth-enabled

Hiermee wordt bepaald of token-auth voor deze webservice moet worden ingeschakeld. Alleen beschikbaar voor AKS-webservices. Standaard ingesteld op False.

--workspace-name -w

Naam van de werkruimte met de service die moet worden bijgewerkt.

-v

Meerheidsvlag.