Delen via

az ml batch-endpoint

  • Referentie

Notitie

Deze verwijzing maakt deel uit van de ml-extensie voor de Azure CLI (versie 2.15.0 of hoger). De extensie installeert automatisch de eerste keer dat u een opdracht az ml batch-endpoint uitvoert. Meer informatie over extensies.

Azure ML-batcheindpunten beheren.

Azure ML-eindpunten bieden een eenvoudige interface voor het maken en beheren van modelimplementaties. Elk eindpunt kan een of meer implementaties hebben. Batch-eindpunten worden gebruikt voor het scoren van offline batches.

Opdracht

Name Description Type Status
az ml batch-endpoint create

Maak een eindpunt.

 Toestel GA
az ml batch-endpoint delete

Een eindpunt verwijderen.

 Toestel GA
az ml batch-endpoint invoke

Een eindpunt aanroepen.

 Toestel GA
az ml batch-endpoint list

Lijst met eindpunten in een werkruimte.

 Toestel GA
az ml batch-endpoint list-jobs

Vermeld de batchscoretaken voor een batch-eindpunt.

 Toestel GA
az ml batch-endpoint show

Details voor een eindpunt weergeven.

 Toestel GA
az ml batch-endpoint update

Een eindpunt bijwerken.

 Toestel GA

az ml batch-endpoint create

Maak een eindpunt.

Als u een eindpunt wilt maken, geeft u een YAML-bestand op met een configuratie van een batcheindpunt. Als het eindpunt al bestaat, wordt het overschreven met de nieuwe instellingen.

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

Voorbeelden

Een eindpunt maken op basis van een YAML-specificatiebestand

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

Een eindpunt met de naam maken

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

Vereiste parameters

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.

Optionele parameters

--file -f

Lokaal pad naar het YAML-bestand met de Specificatie van het Azure ML-batcheindpunt. De YAML-referentiedocumenten voor batch-eindpunten vindt u op: https://aka.ms/ml-cli-v2-endpoint-batch-yaml-reference.

--name -n

Naam van het batch-eindpunt.

--no-wait

Wacht niet tot de langdurige bewerking is voltooid. De standaardwaarde is Onwaar.

Default value: False
--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az ml batch-endpoint delete

Een eindpunt verwijderen.

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

Voorbeelden

Een batch-eindpunt verwijderen, inclusief alle bijbehorende implementaties

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

Vereiste parameters

--name -n

Naam van het batch-eindpunt.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.

Optionele parameters

--no-wait

Wacht niet tot de langdurige bewerking is voltooid. De standaardwaarde is Onwaar.

Default value: False
--yes -y

Niet vragen om bevestiging.

Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az ml batch-endpoint invoke

Een eindpunt aanroepen.

U kunt batchdeductie starten door het eindpunt aan te roepen met enkele gegevens. Voor batch-eindpunten activeert aanroep een asynchrone batchscoretaak.

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]

Voorbeelden

Een batch-eindpunt aanroepen met invoergegevens van een geregistreerde Azure ML-gegevensasset en standaardimplementatie-instelling voor 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

Een batch-eindpunt aanroepen met een invoerbestand van een openbare 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

Een batch-eindpunt aanroepen met invoerbestand uit een geregistreerd gegevensarchief

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

Een batch-eindpunt aanroepen met invoermap van een openbare 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

Een batch-eindpunt aanroepen met invoermap uit een geregistreerd gegevensarchief

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

Een batch-eindpunt aanroepen met bestanden in een lokale map

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

Een batch-eindpunt aanroepen met een lokale map als het invoer- en uitvoerpad en sommige batchimplementatie-instellingen overschrijven tijdens het aanroepen van het eindpunt

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

Vereiste parameters

--name -n

Naam van het batch-eindpunt.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.

Optionele parameters

--deployment-name -d

De naam van de implementatie die moet worden gericht.

--experiment-name

Naam van het experiment voor de implementatie van pijplijnonderdelen.

--file -f

De naam van het bestand dat wordt gebruikt voor batch-aanroep.

--input

Verwijzing naar invoergegevens die moeten worden gebruikt voor batchdeductie. Dit kan een pad zijn in het gegevensarchief, de openbare URI, een geregistreerde gegevensasset of een pad naar een lokale map.

--input-type

Type invoer, waarbij wordt opgegeven of het een bestand of een map is. Gebruik dit wanneer u een pad gebruikt voor het gegevensarchief of de openbare URI. Ondersteunde waarden: uri_folder, uri_file.

--inputs

Woordenlijst van invoer van aanroepende taken.

--instance-count -c

Het aantal exemplaren waarop de voorspelling wordt uitgevoerd.

--job-name

Naam van de taak voor batch-aanroep.

--mini-batch-size -m

Grootte van elke minibatch waarvan de invoergegevens worden gesplitst voor voorspelling.

--output-path

Pad in het gegevensarchief waarnaar uitvoerbestanden worden geüpload.

--outputs

Woordenlijst om op te geven waar de resultaten moeten worden opgeslagen.

--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az ml batch-endpoint list

Lijst met eindpunten in een werkruimte.

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

Voorbeelden

Alle batch-eindpunten in een werkruimte weergeven

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

Alle batch-eindpunten in een werkruimte weergeven

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

Vermeld alle batcheindpunten in een werkruimte met behulp van het argument --query om een JMESPath-query uit te voeren op de resultaten van opdrachten.

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

Vereiste parameters

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az ml batch-endpoint list-jobs

Vermeld de batchscoretaken voor een batch-eindpunt.

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

Voorbeelden

Alle batchscoretaken voor een eindpunt weergeven

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

Vereiste parameters

--name -n

Naam van het batch-eindpunt.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az ml batch-endpoint show

Details voor een eindpunt weergeven.

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

Voorbeelden

De details voor een batch-eindpunt weergeven

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

Geef de inrichtingsstatus van een eindpunt weer met behulp van het argument --query om een JMESPath-query uit te voeren op de resultaten van opdrachten.

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

Vereiste parameters

--name -n

Naam van het batch-eindpunt.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az ml batch-endpoint update

Een eindpunt bijwerken.

De eigenschappen 'description', 'tags' en 'defaults' van een eindpunt kunnen worden bijgewerkt. Daarnaast kunnen nieuwe implementaties worden toegevoegd aan een eindpunt en kunnen bestaande implementaties worden bijgewerkt.

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

Voorbeelden

Een eindpunt bijwerken vanuit een YAML-specificatiebestand

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

Een nieuwe implementatie toevoegen aan een bestaand eindpunt

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

Vereiste parameters

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.

Optionele parameters

--add

Voeg een object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string or JSON string>.

Default value: []
--defaults

Werk deployment_name bij in de standaardinstellingen voor het aanroepen van eindpunten.

--file -f

Lokaal pad naar het YAML-bestand met de Specificatie van het Azure ML-batcheindpunt. De YAML-referentiedocumenten voor batch-eindpunten vindt u op: https://aka.ms/ml-cli-v2-endpoint-batch-yaml-reference.

--force-string

Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.

Default value: False
--name -n

Naam van het batch-eindpunt.

--no-wait

Wacht niet tot de langdurige bewerking is voltooid. De standaardwaarde is Onwaar.

Default value: False
--remove

Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove> OF --remove propertyToRemove.

Default value: []
--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>.

Default value: []
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.