az quantum
Note
Deze verwijzing maakt deel uit van de kwantumextensie voor de Azure CLI (versie 2.73.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az quantum-opdracht uitvoert. Meer informatie over uitbreidingen.
Deze opdrachtgroep is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus
Azure Quantum-werkruimten beheren en taken verzenden naar Azure Quantum Providers.
Opdracht
| Name | Description | Type | Status |
|---|---|---|---|
| az quantum execute |
Dien een taak in die moet worden uitgevoerd in Azure Quantum en wacht tot het resultaat wordt weergegeven. Gelijk aan |
Extension | Preview |
| az quantum job |
Taken voor Azure Quantum beheren. |
Extension | Preview |
| az quantum job cancel |
Aanvraag om een taak in Azure Quantum te annuleren als deze nog niet is voltooid. |
Extension | Preview |
| az quantum job list |
Haal de lijst met taken op in een Quantum-werkruimte. |
Extension | Preview |
| az quantum job output |
Haal de resultaten van het uitvoeren van een taak op. |
Extension | Preview |
| az quantum job show |
De status en details van de taak ophalen. |
Extension | Preview |
| az quantum job submit |
Dien een programma of circuit in dat moet worden uitgevoerd op Azure Quantum. |
Extension | Preview |
| az quantum job wait |
Plaats de CLI in een wachtstatus totdat de taak is uitgevoerd. |
Extension | Preview |
| az quantum offerings |
Provideraanbiedingen voor Azure Quantum beheren. |
Extension | Preview |
| az quantum offerings accept-terms |
Accepteer de voorwaarden van een provider en een SKU-combinatie om deze in te schakelen voor het maken van werkruimten. |
Extension | Preview |
| az quantum offerings list |
Haal de lijst op met alle provideraanbiedingen die beschikbaar zijn op de opgegeven locatie. |
Extension | Preview |
| az quantum offerings show-terms |
De voorwaarden van een provider en SKU-combinatie weergeven, inclusief licentie-URL en acceptatiestatus. |
Extension | Preview |
| az quantum run |
Dien een taak in die moet worden uitgevoerd in Azure Quantum en wacht tot het resultaat wordt weergegeven. Gelijk aan |
Extension | Preview |
| az quantum target |
Beheer doelen voor Azure Quantum-werkruimten. |
Extension | Preview |
| az quantum target clear |
Wis de standaarddoel-id. |
Extension | Preview |
| az quantum target list |
Haal de lijst met providers en hun doelen op in een Azure Quantum-werkruimte. |
Extension | Preview |
| az quantum target set |
Selecteer het standaarddoel dat moet worden gebruikt bij het verzenden van taken naar Azure Quantum. |
Extension | Preview |
| az quantum target show |
Haal de doel-id op van het huidige standaarddoel dat moet worden gebruikt bij het verzenden van taken naar Azure Quantum. |
Extension | Preview |
| az quantum workspace |
Azure Quantum-werkruimten beheren. |
Extension | Preview |
| az quantum workspace clear |
Wis de standaard Azure Quantum-werkruimte. |
Extension | Preview |
| az quantum workspace create |
Maak een nieuwe Azure Quantum-werkruimte. |
Extension | Preview |
| az quantum workspace delete |
Verwijder de opgegeven (of huidige) Azure Quantum-werkruimte. |
Extension | Preview |
| az quantum workspace keys |
Api-sleutels voor Azure Quantum Workspace beheren. |
Extension | Preview |
| az quantum workspace keys list |
Api-sleutels weergeven voor de opgegeven (of huidige) Azure Quantum-werkruimte. |
Extension | Preview |
| az quantum workspace keys regenerate |
Genereer api-sleutel opnieuw voor de opgegeven (of huidige) Azure Quantum-werkruimte. |
Extension | Preview |
| az quantum workspace list |
Haal de lijst met Beschikbare Azure Quantum-werkruimten op. |
Extension | Preview |
| az quantum workspace quotas |
Geef de quota voor de opgegeven (of huidige) Azure Quantum-werkruimte weer. |
Extension | Preview |
| az quantum workspace set |
Selecteer een standaard Azure Quantum-werkruimte voor toekomstige opdrachten. |
Extension | Preview |
| az quantum workspace show |
De details van de opgegeven (of huidige) Azure Quantum-werkruimte ophalen. |
Extension | Preview |
| az quantum workspace update |
Werk de opgegeven (of huidige) Azure Quantum-werkruimte bij. |
Extension | Preview |
az quantum execute
De opdrachtgroep 'quantum' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus
Dien een taak in die moet worden uitgevoerd in Azure Quantum en wacht tot het resultaat wordt weergegeven. Gelijk aan az quantum run.
az quantum execute --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
Voer QIR-bitcode uit vanuit een bestand in de huidige map en wacht op het resultaat.
az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
--job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
--entry-point MyQirEntryPoint
Voer een Quil-passthrough-taak uit op de Rigetti-simulator en wacht op het resultaat.
az quantum execute -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 taakparams en wacht op de resultaten.
az quantum execute -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
De locatie van het invoerbestand dat moet worden verzonden.
De indeling van het bestand dat moet worden verzonden.
Location. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
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.
Naam van de Kwantumwerkruimte. U kunt de standaardwerkruimte configureren met az quantum workspace set.
Optionele parameters
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Het toegangspunt voor het QIR-programma of -circuit. Vereist voor sommige QIR-taken van de provider.
Een beschrijvende naam om aan deze uitvoering van het programma te geven.
De verwachte indeling van de taakuitvoer.
Taakparameters die aan het doel zijn doorgegeven als een lijst met sleutel-=waardeparen, json-tekenreeks of @{file} met json-inhoud.
Het aantal keren dat het programma op het opgegeven doel moet worden uitgevoerd.
Indien opgegeven, wordt de ConnectionString van een Azure Storage gebruikt voor het opslaan van taakgegevens en -resultaten.
De parameter Target-capability doorgegeven aan de compiler.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
az quantum run
De opdrachtgroep 'quantum' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus
Dien een taak in die moet worden uitgevoerd in Azure Quantum en wacht tot het resultaat wordt weergegeven. Gelijk aan az quantum execute.
az quantum run --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
Voer QIR-bitcode uit vanuit een bestand in de huidige map en wacht op het resultaat.
az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
--job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
--entry-point MyQirEntryPoint
Voer een Quil-passthrough-taak uit op de Rigetti-simulator en wacht op het resultaat.
az quantum run -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 taakparams en wacht op de resultaten.
az quantum run -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
De locatie van het invoerbestand dat moet worden verzonden.
De indeling van het bestand dat moet worden verzonden.
Location. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.
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.
Naam van de Kwantumwerkruimte. U kunt de standaardwerkruimte configureren met az quantum workspace set.
Optionele parameters
De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.
Het toegangspunt voor het QIR-programma of -circuit. Vereist voor sommige QIR-taken van de provider.
Een beschrijvende naam om aan deze uitvoering van het programma te geven.
De verwachte indeling van de taakuitvoer.
Taakparameters die aan het doel zijn doorgegeven als een lijst met sleutel-=waardeparen, json-tekenreeks of @{file} met json-inhoud.
Het aantal keren dat het programma op het opgegeven doel moet worden uitgevoerd.
Indien opgegeven, wordt de ConnectionString van een Azure Storage gebruikt voor het opslaan van taakgegevens en -resultaten.
De parameter Target-capability doorgegeven aan de compiler.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |
Uitvoerindeling.
| Eigenschap | Waarde |
|---|---|
| Default value: | json |
| Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van 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.
| Eigenschap | Waarde |
|---|---|
| Default value: | False |