Delen via

az ml component

  • 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 az ml-onderdeelopdracht uitvoert. Meer informatie over extensies.

Azure ML-onderdelen beheren.

Het Azure ML-onderdeel definieert de configuratie van het onderdeel voor pijplijntaken. U kunt de invoer-/uitvoerpoorten, de uitvoeringsomgeving en de opdracht van het onderdeel configureren. Nadat het onderdeel is gemaakt, kunt u verwijzen naar de onderdelen in de pijplijntaak om ze uit te voeren in docker-containers.

Opdracht

Name Description Type Status
az ml component archive

Een onderdeel archiveren.

 Toestel GA
az ml component create

Maak een onderdeel.

 Toestel GA
az ml component list

Onderdelen in een werkruimte weergeven.

 Toestel GA
az ml component restore

Een gearchiveerd onderdeel herstellen.

 Toestel GA
az ml component show

Details voor een onderdeel weergeven.

 Toestel GA
az ml component update

Een onderdeel bijwerken. Momenteel ondersteunen slechts enkele velden (beschrijving, display_name) update.

 Toestel GA

az ml component archive

Een onderdeel archiveren.

Als u een onderdeel archivert, wordt dit standaard verborgen in lijstquery's (az ml component list). U kunt nog steeds verwijzen naar en een gearchiveerd onderdeel in uw pijplijnen gebruiken. U kunt een onderdeelcontainer of een specifieke onderdeelversie archiveren. Als u een onderdeelcontainer archivert, worden alle versies van het onderdeel onder die naam gearchiveerd. U kunt een gearchiveerd onderdeel herstellen met behulp van az ml component restore. Als de hele onderdeelcontainer is gearchiveerd, kunt u geen afzonderlijke versies van het onderdeel herstellen. U moet de onderdeelcontainer herstellen.

az ml component archive --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

Voorbeelden

Een onderdeelcontainer archiveren (alle versies van dat onderdeel archiveren)

az ml component archive --name my-component --resource-group my-resource-group --workspace-name my-workspace

Een specifieke onderdeelversie archiveren

az ml component archive --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Vereiste parameters

--name -n

Naam van het onderdeel.

Optionele parameters

--label -l

Label van het onderdeel.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

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

--version -v

Versie van het onderdeel.

--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
standaardwaarde: 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 component create

Maak een onderdeel.

az ml component create --file
                       [--name]
                       [--registry-name]
                       [--resource-group]
                       [--set]
                       [--skip-validation]
                       [--version]
                       [--workspace-name]

Voorbeelden

Een onderdeel maken op basis van een YAML-specificatiebestand

az ml component create --file my_component.yml --resource-group my-resource-group --workspace-name my-workspace

Een onderdeel maken op basis van een YAML-specificatiebestand met de opgegeven versie

az ml component create --file my_component.yml --version 1 --resource-group my-resource-group --workspace-name my-workspace

Een onderdeel in het register maken op basis van een YAML-specificatiebestand

az ml component create --file my_component.yml --registry-name my-registry-name --resource-group my-resource-group

Een onderdeel in het register maken op basis van een YAML-specificatiebestand met de opgegeven versie

az ml component create --file my_component.yml --version 1 --registry-name my-registry-name --resource-group my-resource-group

Vereiste parameters

--file -f

Lokaal pad naar het YAML-bestand met de specificatie van het Azure ML-onderdeel. De YAML-referentiedocumenten voor het onderdeel vindt u op: https://aka.ms/ml-cli-v2-component-command-yaml-reference.

Optionele parameters

--name -n

Naam van het onderdeel.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

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

--set

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

--skip-validation

Validatie overslaan bij het maken van de resource. Houd er rekening mee dat afhankelijke resources hun validatie bij het maken niet overslaan.

standaardwaarde: False
--version -v

Versie van het onderdeel.

--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
standaardwaarde: 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 component list

Onderdelen in een werkruimte weergeven.

az ml component list [--archived-only]
                     [--include-archived]
                     [--max-results]
                     [--name]
                     [--registry-name]
                     [--resource-group]
                     [--workspace-name]

Voorbeelden

Alle onderdelen in een werkruimte weergeven

az ml component list --resource-group my-resource-group --workspace-name my-workspace

Alle onderdeelversies voor de opgegeven naam in een werkruimte weergeven

az ml component list --name my-component --resource-group my-resource-group --workspace-name my-workspace

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

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

Alle onderdelen in een register weergeven

az ml component list --registry-name my-registry-name --resource-group my-resource-group

Alle onderdeelversies voor de opgegeven naam in een register weergeven

az ml component list --name my-component --registry-name my-registry-name --resource-group my-resource-group

Geef alle onderdelen in een register weer met behulp van het argument --query om een JMESPath-query uit te voeren op de resultaten van opdrachten.

az ml component list --query "[].{Name:name}"  --output table --registry-name my-registry-name --resource-group my-resource-group

Optionele parameters

--archived-only

Alleen gearchiveerde onderdelen weergeven.

standaardwaarde: False
--include-archived

Gearchiveerde onderdelen en actieve onderdelen weergeven.

standaardwaarde: False
--max-results -r

Maximum aantal resultaten dat moet worden geretourneerd.

--name -n

Naam van het onderdeel.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--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
standaardwaarde: 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 component restore

Een gearchiveerd onderdeel herstellen.

Wanneer een gearchiveerd onderdeel wordt hersteld, wordt het niet meer verborgen voor lijstquery's (az ml component list). Als een hele onderdeelcontainer is gearchiveerd, kunt u die gearchiveerde container herstellen. Hiermee worden alle versies van het onderdeel onder die naam hersteld. U kunt alleen een specifieke onderdeelversie herstellen als de hele onderdeelcontainer is gearchiveerd. U moet de hele container herstellen. Als alleen een afzonderlijke onderdeelversie is gearchiveerd, kunt u die specifieke versie herstellen.

az ml component restore --name
                        [--label]
                        [--registry-name]
                        [--resource-group]
                        [--version]
                        [--workspace-name]

Voorbeelden

Een gearchiveerde onderdeelcontainer herstellen (herstelt alle versies van dat onderdeel)

az ml component restore --name my-component --resource-group my-resource-group --workspace-name my-workspace

Een specifieke gearchiveerde onderdeelversie herstellen

az ml component restore --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Vereiste parameters

--name -n

Naam van het onderdeel.

Optionele parameters

--label -l

Label van het onderdeel.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

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

--version -v

Versie van het onderdeel.

--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
standaardwaarde: 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 component show

Details voor een onderdeel weergeven.

az ml component show --name
                     [--label]
                     [--registry-name]
                     [--resource-group]
                     [--version]
                     [--workspace-name]

Voorbeelden

Details weergeven voor een onderdeel met de opgegeven naam en versie

az ml component show --name my-component --version 1 --resource-group my-resource-group --workspace-name my-workspace

Details weergeven voor een onderdeel in het register met de opgegeven naam en versie

az ml component show --name my-component --version 1 --registry-name my-registry-name --resource-group my-resource-group

Vereiste parameters

--name -n

Naam van het onderdeel.

Optionele parameters

--label -l

Label van het onderdeel.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

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

--version -v

Versie van het onderdeel.

--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
standaardwaarde: 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 component update

Een onderdeel bijwerken. Momenteel ondersteunen slechts enkele velden (beschrijving, display_name) update.

az ml component update --name
                       --resource-group
                       --workspace-name
                       [--add]
                       [--force-string]
                       [--label]
                       [--registry-name]
                       [--remove]
                       [--set]
                       [--version]

Voorbeelden

De beschrijving van een onderdeel bijwerken

az ml component update -n my_component -v 1 --set description="new description" -g my-resource-group -w my-workspace

Vereiste parameters

--name -n

Naam van het onderdeel.

--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>.

standaardwaarde: []
--force-string

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

standaardwaarde: False
--label -l

Label van het onderdeel.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--remove

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

standaardwaarde: []
--set

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

standaardwaarde: []
--version -v

Versie van het onderdeel.

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
standaardwaarde: 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.