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 az quantum run.

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 az quantum execute.

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

Förhandsversion

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

--job-input-file

Platsen för den indatafil som ska skickas.

--job-input-format

Formatet på filen som ska skickas.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--target-id -t

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

--workspace-name -w

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.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--entry-point

Startpunkten för QIR-programmet eller kretsen. Krävs för vissa QIR-providerjobb.

--job-name

Ett eget namn att ge till den här körningen av programmet.

--job-output-format

Det förväntade utdataformatet för jobb.

--job-params

Jobbparametrar som skickas till målet som en lista över nyckel=värdepar, json-sträng eller @{file} med json-innehåll.

--shots

Antalet gånger programmet ska köras på det angivna målet.

--storage

Om det anges används ConnectionString för en Azure Storage för att lagra jobbdata och resultat.

--target-capability

Parametern target-capability som skickas till kompilatorn.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az quantum run

Förhandsversion

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

--job-input-file

Platsen för den indatafil som ska skickas.

--job-input-format

Formatet på filen som ska skickas.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--target-id -t

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

--workspace-name -w

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.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--entry-point

Startpunkten för QIR-programmet eller kretsen. Krävs för vissa QIR-providerjobb.

--job-name

Ett eget namn att ge till den här körningen av programmet.

--job-output-format

Det förväntade utdataformatet för jobb.

--job-params

Jobbparametrar som skickas till målet som en lista över nyckel=värdepar, json-sträng eller @{file} med json-innehåll.

--shots

Antalet gånger programmet ska köras på det angivna målet.

--storage

Om det anges används ConnectionString för en Azure Storage för att lagra jobbdata och resultat.

--target-capability

Parametern target-capability som skickas till kompilatorn.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False