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

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

 Toestel Preview uitvoeren
az quantum job output

Haal de resultaten van het uitvoeren van een taak op.

 Toestel Preview uitvoeren
az quantum job show

De status en details van de taak ophalen.

 Toestel Preview uitvoeren
az quantum job submit

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

 Toestel Preview uitvoeren
az quantum job wait

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

 Toestel Preview uitvoeren

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
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 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
                    [--created-after]
                    [--created-before]
                    [--item-type]
                    [--job-name]
                    [--job-type]
                    [--order]
                    [--orderby]
                    [--provider-id]
                    [--skip]
                    [--status]
                    [--target-id]
                    [--top]

Voorbeelden

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

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

Taken weergeven die gebruikmaken van de provider van Microsoft-elementen.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --provider-id microsoft-elements

Taken weergeven die zijn uitgevoerd op het microsoft.dft-doel.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --target-id microsoft.dft

Taken weergeven die zijn voltooid.

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

Taken weergeven die na 15 januari 2025 zijn gemaakt.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --created-after 2025-01-15

Taken weergeven waarvan de namen beginnen met 'Genereren...'.

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

Sla de eerste 50 taken over, begin met de vermelding bij de 51e taak en vermeld 10 taken.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --skip 50 --top 10

Sorteer de takenlijst op doel-id en geef deze weer in tabelvorm.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Target -o table

Sorteer de takenlijst op taaknaam in aflopende volgorde, weergegeven in tabelvorm.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Name --order desc -o table

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.

Optionele parameters

--created-after

Taken die na deze datum zijn gemaakt om te worden weergegeven.

--created-before

Taken die vóór deze datum zijn gemaakt om te worden weergegeven.

--item-type

Itemtype dat moet worden weergegeven, 'taak' of 'sessie'.

--job-name

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

--job-type

Taaktype dat moet worden weergegeven, voorbeeld 'QuantumComputing'.

--order

De lijst rangschikt: asc of desc.

--orderby

Het veld waarop de lijst moet worden gesorteerd.

--provider-id -p

Id van een Azure Quantum-provider.

--skip

Hoeveel taken u moet overslaan bij het retourneren van een takenlijst.

--status

De status van taken die moeten worden weergegeven.

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

--top

Het aantal taken dat per pagina wordt weergegeven.

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 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
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 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
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 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 --job-input-file
                      --job-input-format
                      --location
                      --resource-group
                      --target-id
                      --workspace-name
                      [--entry-point]
                      [--job-name]
                      [--job-output-format]
                      [--job-params]
                      [--shots]
                      [--storage]
                      [--target-capability]

Voorbeelden

Verzend QIR-bitcode 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

Dien een Quil-passthrough-taak in bij de Rigetti-simulator.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t rigetti.sim.qvm --job-name MyJob --job-input-file MyProgram.quil \
   --job-input-format rigetti.quil.v1 --job-output-format rigetti.quil-results.v1

Dien een Qiskit-circuit in bij de IonQ-simulator met taakparameters.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t ionq.simulator --job-name MyJobName --job-input-file MyCircuit.json \
   --job-input-format ionq.circuit.v1 --job-output-format ionq.quantum-results.v1 \
   --job-params count=100 content-type=application/json

Vereiste parameters

--job-input-file

De locatie van het invoerbestand dat moet worden verzonden.

--job-input-format

De indeling van het bestand dat moet worden verzonden.

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

--job-name

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

--job-output-format

De verwachte indeling van de taakuitvoer.

--job-params

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

--shots

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

--storage

Indien opgegeven, wordt de ConnectionString van een Azure Storage gebruikt voor het opslaan van taakgegevens en -resultaten.

--target-capability

De parameter Target-capability doorgegeven aan de compiler.

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

Default value: 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
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.