Delen via

az quantum job

  • Preview
  • Referentie

Notitie

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

De opdrachtgroep 'quantum' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Taken voor Azure Quantum beheren.

Opdracht

Name Description Type Status
az quantum job cancel

Aanvraag om een taak in Azure Quantum te annuleren als deze nog niet is voltooid.

 Toestel Preview
az quantum job list

Haal de lijst met taken op in een Quantum-werkruimte.

 Toestel Preview
az quantum job output

Haal de resultaten van het uitvoeren van een taak op.

 Toestel Preview
az quantum job show

De status en details van de taak ophalen.

 Toestel Preview
az quantum job submit

Dien een programma of circuit in dat moet worden uitgevoerd op Azure Quantum.

 Toestel Preview
az quantum job wait

Plaats de CLI in een wachtstatus totdat de taak is uitgevoerd.

 Toestel Preview

az quantum job cancel

Preview

De opdrachtgroep 'quantum' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Aanvraag om een taak in Azure Quantum te annuleren als deze nog niet is voltooid.

az quantum job cancel --job-id
                      --location
                      --resource-group
                      --workspace-name

Voorbeelden

AnNuleer een Azure Quantum-taak op id.

az quantum job cancel -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy

Vereiste parameters

--job-id -j

Unieke taak-id in GUID-indeling.

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--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 Kwantumwerkruimte. U kunt de standaardwerkruimte configureren met behulp van az quantum workspace set.

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 quantum job list

Preview

De opdrachtgroep 'quantum' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Haal de lijst met taken op in een Quantum-werkruimte.

az quantum job list --location
                    --resource-group
                    --workspace-name

Voorbeelden

Haal de lijst met taken op uit een Azure Quantum-werkruimte.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation

Vereiste parameters

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--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 Kwantumwerkruimte. U kunt de standaardwerkruimte configureren met behulp van az quantum workspace set.

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 quantum job output

Preview

De opdrachtgroep 'quantum' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Haal de resultaten van het uitvoeren van een taak op.

az quantum job output --job-id
                      --location
                      --resource-group
                      --workspace-name
                      [--item]

Voorbeelden

De resultaten van een geslaagde Azure Quantum-taak afdrukken.

az quantum job output -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy -o table

Vereiste parameters

--job-id -j

Unieke taak-id in GUID-indeling.

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--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 Kwantumwerkruimte. U kunt de standaardwerkruimte configureren met behulp van az quantum workspace set.

Optionele parameters

--item

De itemindex in een batchtaak.

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 quantum job show

Preview

De opdrachtgroep 'quantum' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

De status en details van de taak ophalen.

az quantum job show --job-id
                    --location
                    --resource-group
                    --workspace-name

Voorbeelden

De status van een Azure Quantum-taak ophalen.

az quantum job show -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --query status

Vereiste parameters

--job-id -j

Unieke taak-id in GUID-indeling.

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--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 Kwantumwerkruimte. U kunt de standaardwerkruimte configureren met behulp van az quantum workspace set.

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 quantum job submit

Preview

De opdrachtgroep 'quantum' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Dien een programma of circuit in dat moet worden uitgevoerd op Azure Quantum.

az quantum job submit --location
                      --resource-group
                      --target-id
                      --workspace-name
                      [--entry-point]
                      [--job-input-file]
                      [--job-input-format]
                      [--job-name]
                      [--job-output-format]
                      [--job-params]
                      [--no-build]
                      [--project]
                      [--shots]
                      [--storage]
                      [--target-capability]
                      [<PROGRAM_ARGS>]

Voorbeelden

Dien een Q#-programma in vanuit de huidige map.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob

Dien een Q#-programma in vanuit de huidige map met taakparameters voor een doel.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob --job-params param1=value1 param2=value2

Dien een Q#-programma in met programmaparameters (bijvoorbeeld n-qubits = 2).

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob -- --n-qubits=2

Dien een Q#-programma in vanuit de huidige map met een doelfunctieparameter.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --target-capability MyTargetCapability

Verzend QIR-bitcode of door mensen leesbare LLVM-code uit een bestand in de huidige map.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
    --entry-point MyQirEntryPoint

Vereiste parameters

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--resource-group -g

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

--target-id -t

Uitvoeringsengine voor kwantumcomputingstaken. Wanneer een werkruimte is geconfigureerd met een set providers, schakelen ze elk een of meer doelen in. U kunt het standaarddoel configureren met behulp van az quantum target set.

--workspace-name -w

Naam van de Kwantumwerkruimte. U kunt de standaardwerkruimte configureren met behulp van az quantum workspace set.

Optionele parameters

--entry-point

Het toegangspunt voor het QIR-programma of -circuit. Vereist voor QIR. Genegeerd voor Q#-taken.

--job-input-file

De locatie van het invoerbestand dat moet worden verzonden. Vereist voor QIR-, QIO- en passthrough-taken. Genegeerd voor Q#-taken.

--job-input-format

De indeling van het bestand dat moet worden verzonden. Laat deze parameter weg voor Q#-taken.

--job-name

Een beschrijvende naam om aan deze uitvoering van het programma te geven.

--job-output-format

De verwachte indeling van de taakuitvoer. Genegeerd voor Q#-taken.

--job-params

Taakparameters die aan het doel zijn doorgegeven als een lijst met sleutel-=waardeparen, json-tekenreeks of @{file} met json-inhoud.

--no-build

[Afgeschaft] Indien opgegeven, wordt het Q#-programma niet gebouwd voordat het wordt ingediend.

standaardwaarde: False
--project

[Afgeschaft] De locatie van het Q#-project dat moet worden verzonden. De standaardinstelling is de huidige map.

--shots

Het aantal keren dat het Q#-programma op het opgegeven doel moet worden uitgevoerd.

--storage

Indien opgegeven, wordt de Verbinding maken ionString van een Azure Storage gebruikt om taakgegevens en -resultaten op te slaan.

--target-capability

De parameter Target-capability doorgegeven aan de compiler.

<PROGRAM_ARGS>

Lijst met argumenten die worden verwacht door de Q#-bewerking die is opgegeven als --name=value after --.

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 quantum job wait

Preview

De opdrachtgroep 'quantum' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Plaats de CLI in een wachtstatus totdat de taak is uitgevoerd.

az quantum job wait --job-id
                    --location
                    --resource-group
                    --workspace-name
                    [--max-poll-wait-secs]

Voorbeelden

Wacht op voltooiing van een taak, controleer met intervallen van 60 seconden.

az quantum job wait -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --max-poll-wait-secs 60 -o table

Vereiste parameters

--job-id -j

Unieke taak-id in GUID-indeling.

--location -l

Locatie. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--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 Kwantumwerkruimte. U kunt de standaardwerkruimte configureren met behulp van az quantum workspace set.

Optionele parameters

--max-poll-wait-secs

Polltijd in seconden om een query uit te voeren op Azure Quantum voor resultaten van de bijbehorende taak.

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