az ml job
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 az ml-taakopdracht uitvoert. Meer informatie over extensies.
Azure ML-taken beheren.
Een Azure ML-taak voert een taak uit op basis van een opgegeven rekendoel. U kunt taken configureren om modeltraining uit te schalen in Azure. Azure ML ondersteunt verschillende taaktypen met verschillende mogelijkheden. De meest eenvoudige taak, een opdrachttaak, voert bijvoorbeeld een opdracht uit in een Docker-container en kan worden gebruikt voor één knooppunt en gedistribueerde training. Een sweep-taak voert een hyperparameter-sweep uit over een opgegeven zoekruimte voor het afstemmen van de hyperparameters van een model.
Taken maken ook systematische tracering mogelijk voor uw ML-experimenten en -werkstromen. Zodra een taak is gemaakt, onderhoudt Azure ML een uitvoeringsrecord voor de taak die de metagegevens bevat, metrische gegevens, logboeken en artefacten die zijn gegenereerd tijdens de taak, code die is uitgevoerd en de Gebruikte Azure ML-omgeving. Alle uitvoeringsrecords van uw taken kunnen worden weergegeven in Azure ML Studio.
Opdracht
| Name | Description | Type | Status |
|---|---|---|---|
| az ml job archive |
Een taak archiveren. |
Toestel | GA |
| az ml job cancel |
Een taak annuleren. |
Toestel | GA |
| az ml job connect-ssh |
Stel een ssh-verbinding in en verzendt de aanvraag naar de SSH-service die wordt uitgevoerd in de container van de gebruiker via Tundra. |
Toestel | GA |
| az ml job create |
Maak een job. |
Toestel | GA |
| az ml job download |
Download alle taakgerelateerde bestanden. |
Toestel | GA |
| az ml job list |
Taken in een werkruimte weergeven. |
Toestel | GA |
| az ml job restore |
Een gearchiveerde taak herstellen. |
Toestel | GA |
| az ml job show |
Details voor een taak weergeven. |
Toestel | GA |
| az ml job show-services |
Services van een taak per knooppunt weergeven. |
Toestel | GA |
| az ml job stream |
Stream taaklogboeken naar de console. |
Toestel | GA |
| az ml job update |
Een taak bijwerken. |
Toestel | GA |
| az ml job validate |
Valideer een taak. Deze opdracht werkt alleen voor pijplijntaken. |
Toestel | GA |
az ml job archive
Een taak archiveren.
Als u een taak archivert, wordt deze standaard verborgen in lijstquery's (az ml job list). U kunt nog steeds verwijzen naar en een gearchiveerde taak in uw werkstromen gebruiken. Alleen voltooide taken kunnen worden gearchiveerd.
az ml job archive --name
--resource-group
--workspace-nameVereiste parameters
Naam van de taak.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az ml job cancel
Een taak annuleren.
az ml job cancel --name
--resource-group
--workspace-nameVoorbeelden
Een taak op naam annuleren
az ml job cancel --name my-job-id --resource-group my-resource-group --workspace-name my-workspaceVereiste parameters
Naam van de taak.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az ml job connect-ssh
Stel een ssh-verbinding in en verzendt de aanvraag naar de SSH-service die wordt uitgevoerd in de container van de gebruiker via Tundra.
az ml job connect-ssh --name
--resource-group
--workspace-name
[--node-index]
[--private-key-file-path]Voorbeelden
Stel een ssh-verbinding in en verzendt de aanvraag naar de SSH-service.
az ml job connect-ssh --name my-job-id --node-index 0 --private-key-file-path "C:/Temp/.ssh/id_rsa" --resource-group my-resource-group --workspace-name my-workspaceVereiste parameters
Naam van de taak.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.
Optionele parameters
De index van het knooppunt om verbinding te maken via ssh.
Het pad naar het bestand met de persoonlijke sleutel.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az ml job create
Maak een job.
Als u een taak wilt maken, moet u doorgaans eventuele code configureren die moet worden uitgevoerd, een omgeving waarin de afhankelijkheden worden ingekapseld, een rekendoel voor het uitvoeren van de taak en eventuele aanvullende taakspecifieke instellingen. Wanneer een taak wordt gemaakt, wordt deze verzonden voor uitvoering op basis van de opgegeven rekenresource.
az ml job create --file
--resource-group
--workspace-name
[--name]
[--save-as]
[--set]
[--skip-validation]
[--stream]
[--web]Voorbeelden
Een taak maken op basis van een YAML-specificatiebestand
az ml job create --file job.yml --resource-group my-resource-group --workspace-name my-workspaceEen taak maken op basis van een YAML-specificatiebestand en de uitvoeringsdetails van de taak openen in de Azure ML Studio-portal
az ml job create --file job.yml --web --resource-group my-resource-group --workspace-name my-workspaceVereiste parameters
Lokaal pad naar het YAML-bestand met de Azure ML-taakspecificatie. De YAML-referentiedocumenten voor taken zijn te vinden op: https://aka.ms/ml-cli-v2-job-command-yaml-reference, https://aka.ms/ml-cli-v2-job-sweep-yaml-reference, https://aka.ms/ml-cli-v2-job-pipeline-yaml-reference.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.
Optionele parameters
Naam van de taak.
Bestand waarnaar de status van de gemaakte taak in YAML-indeling wordt geschreven.
Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=.
Validatie overslaan bij het maken van de resource. Houd er rekening mee dat afhankelijke resources hun validatie bij het maken niet overslaan.
Geeft aan of de logboeken van de taak naar de console moeten worden gestreamd.
De uitvoeringsdetails van de taak weergeven in Azure ML Studio in een webbrowser.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az ml job download
Download alle taakgerelateerde bestanden.
De bestanden worden gedownload in een map met de naam van de taak.
az ml job download --name
--resource-group
--workspace-name
[--all]
[--download-path]
[--output-name]Voorbeelden
De logboeken en uitvoer van een taak downloaden naar de huidige werkmap
az ml job download --name my-job --resource-group my-resource-group --workspace-name my-workspaceVereiste parameters
Naam van de taak.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.
Optionele parameters
Download alle uitvoer van de taak.
Pad naar het downloaden van de taakbestanden. Als u dit weglaat, worden taakbestanden gedownload naar de huidige map.
De naam van de door de gebruiker gedefinieerde uitvoer die moet worden gedownload. Dit moet overeenkomen met een sleutel in de uitvoerwoordenlijst van een taak. Als u dit weglaat, worden de standaardartefactuitvoerbestanden van de taak gedownload.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az ml job list
Taken in een werkruimte weergeven.
az ml job list --resource-group
--workspace-name
[--all-results {false, true}]
[--archived-only]
[--include-archived]
[--max-results]
[--parent-job-name]Voorbeelden
Geef alle taakstatussen in een werkruimte weer met behulp van het argument --query om een JMESPath-query uit te voeren op de resultaten van opdrachten.
az ml job list --query "[].{Name:name,Jobstatus:status}" --output table --resource-group my-resource-group --workspace-name my-workspaceVereiste parameters
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.
Optionele parameters
Retourneert alle resultaten.
Alleen gearchiveerde taken weergeven.
Gearchiveerde taken en actieve taken weergeven.
Maximum aantal resultaten dat moet worden geretourneerd. De standaardwaarde is 50.
Naam van de bovenliggende taak. Geeft alle taken weer waarvan parent_job_name overeenkomt met de opgegeven naam.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az ml job restore
Een gearchiveerde taak herstellen.
Wanneer een gearchiveerde taak wordt hersteld, wordt deze niet meer verborgen voor lijstquery's (az ml job list).
az ml job restore --name
--resource-group
--workspace-nameVereiste parameters
Naam van de taak.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az ml job show
Details voor een taak weergeven.
az ml job show --name
--resource-group
--workspace-name
[--web]Voorbeelden
De status van een taak weergeven met behulp van het argument --query om een JMESPath-query uit te voeren op de resultaten van opdrachten.
az ml job show --name my-job-id --query "{Name:name,Jobstatus:status}" --output table --resource-group my-resource-group --workspace-name my-workspaceVereiste parameters
Naam van de taak.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.
Optionele parameters
De uitvoeringsdetails van de taak weergeven in Azure ML Studio in een webbrowser.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az ml job show-services
Services van een taak per knooppunt weergeven.
az ml job show-services --name
--resource-group
--workspace-name
[--node-index]Voorbeelden
De services van een taak per knooppunt weergeven met behulp van het argument --query om een JMESPath-query uit te voeren op de resultaten van opdrachten.
az ml job show-services --name my-job-id --node-index 0 --query "{Name:name,Jobstatus:status}" --output table --resource-group my-resource-group --workspace-name my-workspaceVereiste parameters
Naam van de taak.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.
Optionele parameters
De index van het knooppunt waarvoor de services moeten worden weergegeven.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az ml job stream
Stream taaklogboeken naar de console.
az ml job stream --name
--resource-group
--workspace-nameVereiste parameters
Naam van de taak.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az ml job update
Een taak bijwerken.
Alleen de eigenschappen 'tags' en 'eigenschappen' kunnen worden bijgewerkt.
az ml job update --name
--resource-group
--workspace-name
[--add]
[--force-string]
[--remove]
[--set]
[--web]Vereiste parameters
Naam van de taak.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.
Optionele parameters
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>.
Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.
Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove> OF --remove propertyToRemove.
Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>.
De uitvoeringsdetails van de taak weergeven in Azure ML Studio in een webbrowser.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az ml job validate
Valideer een taak. Deze opdracht werkt alleen voor pijplijntaken.
Met deze opdracht wordt een YAML-specificatiebestand gevalideerd om te controleren of het geldig is voor het maken van een taak en worden alle gevonden problemen geretourneerd. Validatie omvat voornamelijk lokale controle op schema, zoals ontbrekende velden, omgeving zonder opgegeven versie, code waarnaar wordt verwezen naar een niet-bestaand lokaal pad; er wordt ook gecontroleerd of er naar referentie-rekendoelen in de doelwerkruimte wordt verwezen. Het validatieresultaat wordt afgedrukt naar de console, inclusief zowel fouten als waarschuwingen. Alleen fouten veroorzaken dat de validatie mislukt. Er kan een doorgegeven taakvalidatie worden ingediend. Deze opdracht werkt alleen voor pijplijntaken.
az ml job validate --file
--resource-group
--workspace-name
[--set]Voorbeelden
Valideer een YAML-specificatiebestand om te controleren of het geldig is voor het maken van een taak.
az ml job validate --file job.yml --resource-group my-resource-group --workspace-name my-workspaceVereiste parameters
Lokaal pad naar het YAML-bestand met de Azure ML-taakspecificatie. De YAML-referentiedocumenten voor taken vindt u op: https://aka.ms/ml-cli-v2-job-pipeline-yaml-reference.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met behulp van az configure --defaults workspace=<name>.
Optionele parameters
Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
