az quantum
Note
Den här referensen är en del av tillägget quantum för Azure CLI (version 2.73.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az quantum-kommando . Läs mer om tillägg.
Den här kommandogruppen är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Hantera Azure Quantum arbetsytor och skicka jobb till Azure Quantum providers.
Kommandon
| Name | Description | Typ | Status |
|---|---|---|---|
| az quantum execute |
Skicka ett jobb för att köra på Azure Quantum och vänta på resultatet. Motsvarar |
Extension | Preview |
| az quantum job |
Hantera jobb för Azure Quantum. |
Extension | Preview |
| az quantum job cancel |
Begäran om att avbryta ett jobb på Azure Quantum om det inte har slutförts. |
Extension | Preview |
| az quantum job delete |
Ta bort ett jobb från en Azure Quantum arbetsyta. |
Extension | Preview |
| az quantum job file |
Hantera ett kvantjobbs associerade filer. |
Extension | Preview |
| az quantum job file download |
Ladda ned en fil från ett jobbs utdatalagringscontainer. |
Extension | Preview |
| az quantum job file list |
Visa en lista över de filer som lagras i ett jobbs utdatalagringscontainer. |
Extension | Preview |
| az quantum job list |
Hämta listan över jobb på en Kvantarbetsyta. |
Extension | Preview |
| az quantum job output |
Hämta resultatet av att köra ett jobb. |
Extension | Preview |
| az quantum job show |
Hämta jobbets status och information. |
Extension | Preview |
| az quantum job submit |
Skicka ett program eller en krets som ska köras på Azure Quantum. |
Extension | Preview |
| az quantum job update |
Uppdatera ett skickat jobbs namn, prioritet och/eller taggar. |
Extension | Preview |
| az quantum job wait |
Placera CLI i vänteläge tills jobbet har slutförts. |
Extension | Preview |
| az quantum offerings |
Hantera leverantörserbjudanden för Azure Quantum. |
Extension | Preview |
| az quantum offerings accept-terms |
Godkänn villkoren för en provider och en SKU-kombination för att aktivera den för att skapa arbetsytor. |
Extension | Preview |
| az quantum offerings list |
Hämta listan över alla leverantörserbjudanden som är tillgängliga på den angivna platsen. |
Extension | Preview |
| az quantum offerings show-terms |
Visa villkoren för en provider- och SKU-kombination, inklusive licens-URL och godkännandestatus. |
Extension | Preview |
| az quantum run |
Skicka ett jobb för att köra på Azure Quantum och vänta på resultatet. Motsvarar |
Extension | Preview |
| az quantum suite-offer |
Visa Azure Quantum paketerbjudanden för V2-leverantörer som är tillgängliga för prenumerationen. |
Extension | Preview |
| az quantum suite-offer list |
Lista erbjudanden för V2-providerpaket som är tillgängliga för den aktuella prenumerationen, inklusive provider-ID, namn, företag och plats. |
Extension | Preview |
| az quantum suite-offer quotas |
Visa kvotallokeringar och deras förbrukade användningar för ett V2-providerpaketerbjudande i den aktuella prenumerationen. |
Extension | Preview |
| az quantum suite-offer target |
Lista mål som är tillgängliga via ett Azure Quantum suite-erbjudande för en V2-provider. |
Extension | Preview |
| az quantum suite-offer target list |
Visa en lista över mål och deras status som är tillgänglig via ett erbjudande för V2-providerpaket, utan att en arbetsyta krävs. |
Extension | Preview |
| az quantum target |
Hantera mål för Azure Quantum arbetsytor. |
Extension | Preview |
| az quantum target clear |
Rensa standardmål-ID:t. |
Extension | Preview |
| az quantum target list |
Hämta listan över leverantörer och deras mål på en Azure Quantum arbetsyta. |
Extension | Preview |
| az quantum target set |
Välj det standardmål som ska användas när jobb skickas till Azure Quantum. |
Extension | Preview |
| az quantum target show |
Hämta mål-ID:t för det aktuella standardmålet som ska användas när jobb skickas till Azure Quantum. |
Extension | Preview |
| az quantum workspace |
Hantera Azure Quantum arbetsytor. |
Extension | Preview |
| az quantum workspace clear |
Rensa standardarbetsytan Azure Quantum. |
Extension | Preview |
| az quantum workspace create |
Skapa en ny Azure Quantum arbetsyta. |
Extension | Preview |
| az quantum workspace delete |
Ta bort angiven (eller aktuell) Azure Quantum arbetsyta. |
Extension | Preview |
| az quantum workspace keys |
Hantera api-nycklar för Azure Quantum arbetsyta. |
Extension | Preview |
| az quantum workspace keys list |
Lista API-nycklar för den angivna (eller aktuella) Azure Quantum arbetsytan. |
Extension | Preview |
| az quantum workspace keys regenerate |
Återskapa API-nyckeln för den angivna (eller aktuella) Azure Quantum arbetsytan. |
Extension | Preview |
| az quantum workspace list |
Hämta listan över Azure Quantum tillgängliga arbetsytor. |
Extension | Preview |
| az quantum workspace quotas |
Visa en lista över kvotallokeringar och förbrukade användningar för en Azure Quantum arbetsyta. |
Extension | Preview |
| az quantum workspace set |
Välj en standardarbetsyta Azure Quantum för framtida kommandon. |
Extension | Preview |
| az quantum workspace show |
Hämta information om den angivna (eller aktuella) Azure Quantum arbetsytan. |
Extension | Preview |
| az quantum workspace update |
Uppdatera den angivna (eller aktuella) Azure Quantum arbetsytan. |
Extension | Preview |
| az quantum workspace user |
Hantera användare av en Azure Quantum arbetsyta. |
Extension | Preview |
| az quantum workspace user add |
Ge en användare åtkomst till en Azure Quantum arbetsyta. |
Extension | Preview |
| az quantum workspace user list |
Visa en lista över användare med åtkomst till en Azure Quantum arbetsyta. |
Extension | Preview |
| az quantum workspace user remove |
Ta bort en användares åtkomst till en Azure Quantum arbetsyta. |
Extension | Preview |
az quantum execute
Kommandogruppen "quantum" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Skicka ett jobb för att köra på Azure Quantum och vänta på resultatet. Motsvarar az quantum run.
az quantum execute --job-input-file
--job-input-format
--resource-group
--target-id
--workspace-name
[--acquire-policy-token]
[--change-reference]
[--entry-point]
[--job-name]
[--job-output-format]
[--job-params]
[--shots]
[--storage]
[--target-capability]
Exempel
Kör QIR-bitkod från en fil i den aktuella mappen och vänta på resultatet.
az quantum execute -g MyResourceGroup -w MyWorkspace -t MyTarget \
--job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
--entry-point MyQirEntryPoint
Kör ett Quil-direktjobb på Rigetti-simulatorn och vänta på resultatet.
az quantum execute -g MyResourceGroup -w MyWorkspace \
-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
Skicka en Qiskit-krets till IonQ-simulatorn med jobbparamer och vänta på resultatet.
az quantum execute -g MyResourceGroup -w MyWorkspace \
-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
Obligatoriska parametrar
Platsen för den indatafil som ska skickas.
Formatet på filen som ska skickas.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.
Körningsmotor för kvantberäkningsjobb. När en arbetsyta konfigureras med en uppsättning leverantörer aktiverar de var och en ett eller flera mål. Du kan konfigurera standardmålet med .az quantum target set
Namnet på kvantarbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az quantum workspace set.
Valfria parametrar
Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.
Hämtar en Azure Policy token automatiskt för den här resursåtgärden.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Global Policy Arguments |
Det relaterade ändringsreferens-ID:t för den här resursåtgärden.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Global Policy Arguments |
Startpunkten för QIR-programmet eller kretsen. Krävs för vissa QIR-providerjobb.
Ett eget namn att ge till den här körningen av programmet.
Det förväntade utdataformatet för jobb.
Jobbparametrar som skickas till målet som en lista över nyckel=värdepar, json-sträng eller @{file} med json-innehåll.
Antalet gånger programmet ska köras på det angivna målet.
Om det anges används ConnectionString för en Azure Storage för att lagra jobbdata och resultat.
Parametern target-capability som skickas till kompilatorn.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
az quantum run
Kommandogruppen "quantum" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus
Skicka ett jobb för att köra på Azure Quantum och vänta på resultatet. Motsvarar az quantum execute.
az quantum run --job-input-file
--job-input-format
--resource-group
--target-id
--workspace-name
[--acquire-policy-token]
[--change-reference]
[--entry-point]
[--job-name]
[--job-output-format]
[--job-params]
[--shots]
[--storage]
[--target-capability]
Exempel
Kör QIR-bitkod från en fil i den aktuella mappen och vänta på resultatet.
az quantum run -g MyResourceGroup -w MyWorkspace -t MyTarget \
--job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
--entry-point MyQirEntryPoint
Kör ett Quil-direktjobb på Rigetti-simulatorn och vänta på resultatet.
az quantum run -g MyResourceGroup -w MyWorkspace \
-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
Skicka en Qiskit-krets till IonQ-simulatorn med jobbparamer och vänta på resultatet.
az quantum run -g MyResourceGroup -w MyWorkspace \
-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
Obligatoriska parametrar
Platsen för den indatafil som ska skickas.
Formatet på filen som ska skickas.
Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.
Körningsmotor för kvantberäkningsjobb. När en arbetsyta konfigureras med en uppsättning leverantörer aktiverar de var och en ett eller flera mål. Du kan konfigurera standardmålet med .az quantum target set
Namnet på kvantarbetsytan. Du kan konfigurera standardarbetsytan med hjälp av az quantum workspace set.
Valfria parametrar
Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.
Hämtar en Azure Policy token automatiskt för den här resursåtgärden.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Global Policy Arguments |
Det relaterade ändringsreferens-ID:t för den här resursåtgärden.
| Egenskap | Värde |
|---|---|
| Parametergrupp: | Global Policy Arguments |
Startpunkten för QIR-programmet eller kretsen. Krävs för vissa QIR-providerjobb.
Ett eget namn att ge till den här körningen av programmet.
Det förväntade utdataformatet för jobb.
Jobbparametrar som skickas till målet som en lista över nyckel=värdepar, json-sträng eller @{file} med json-innehåll.
Antalet gånger programmet ska köras på det angivna målet.
Om det anges används ConnectionString för en Azure Storage för att lagra jobbdata och resultat.
Parametern target-capability som skickas till kompilatorn.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |
Utdataformat.
| Egenskap | Värde |
|---|---|
| Standardvärde: | json |
| Godkända värden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
| Egenskap | Värde |
|---|---|
| Standardvärde: | False |