Partilhar via


az quantum

Note

Essa referência faz parte da extensão quântica para a CLI do Azure (versão 2.73.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az quantum . Saiba mais sobre extensões.

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie o Azure Quantum Workspaces e envie trabalhos para o Azure Quantum Providers.

Comandos

Name Description Tipo Status
az quantum execute

Envie um trabalho para ser executado no Azure Quantum e aguarde o resultado. Equivalente a az quantum run.

Extension Preview
az quantum job

Gerencie trabalhos para o Azure Quantum.

Extension Preview
az quantum job cancel

Solicite o cancelamento de um trabalho no Azure Quantum se ele não tiver sido concluído.

Extension Preview
az quantum job list

Obtenha a lista de trabalhos em um Quantum Workspace.

Extension Preview
az quantum job output

Obtenha os resultados da execução de um trabalho.

Extension Preview
az quantum job show

Obtenha o status e os detalhes do trabalho.

Extension Preview
az quantum job submit

Envie um programa ou circuito para ser executado no Azure Quantum.

Extension Preview
az quantum job wait

Coloque a CLI em um estado de espera até que o trabalho termine de ser executado.

Extension Preview
az quantum offerings

Gerencie ofertas de provedor para o Azure Quantum.

Extension Preview
az quantum offerings accept-terms

Aceite os termos de uma combinação de provedor e SKU para habilitá-la para a criação de espaço de trabalho.

Extension Preview
az quantum offerings list

Obtenha a lista de todas as ofertas de provedores disponíveis no local determinado.

Extension Preview
az quantum offerings show-terms

Mostrar os termos de uma combinação de provedor e SKU, incluindo URL de licença e status de aceitação.

Extension Preview
az quantum run

Envie um trabalho para ser executado no Azure Quantum e aguarde o resultado. Equivalente a az quantum execute.

Extension Preview
az quantum target

Gerencie destinos para espaços de trabalho do Azure Quantum.

Extension Preview
az quantum target clear

Limpe o target id padrão.

Extension Preview
az quantum target list

Obtenha a lista de provedores e seus destinos em um espaço de trabalho do Azure Quantum.

Extension Preview
az quantum target set

Selecione o destino padrão a ser usado ao enviar trabalhos para o Azure Quantum.

Extension Preview
az quantum target show

Obtenha a ID de destino do destino padrão atual para usar ao enviar trabalhos para o Azure Quantum.

Extension Preview
az quantum workspace

Gerencie espaços de trabalho do Azure Quantum.

Extension Preview
az quantum workspace clear

Limpe o espaço de trabalho padrão do Azure Quantum.

Extension Preview
az quantum workspace create

Crie um novo espaço de trabalho do Azure Quantum.

Extension Preview
az quantum workspace delete

Exclua o espaço de trabalho do Azure Quantum fornecido (ou atual).

Extension Preview
az quantum workspace keys

Gerencie chaves de api do Azure Quantum Workspace.

Extension Preview
az quantum workspace keys list

Liste chaves de api para o espaço de trabalho do Azure Quantum determinado (ou atual).

Extension Preview
az quantum workspace keys regenerate

Regenere a chave de api para o espaço de trabalho do Azure Quantum determinado (ou atual).

Extension Preview
az quantum workspace list

Obtenha a lista de espaços de trabalho do Azure Quantum disponíveis.

Extension Preview
az quantum workspace quotas

Liste as cotas para o espaço de trabalho do Azure Quantum determinado (ou atual).

Extension Preview
az quantum workspace set

Selecione um espaço de trabalho padrão do Azure Quantum para comandos futuros.

Extension Preview
az quantum workspace show

Obtenha os detalhes do espaço de trabalho do Azure Quantum fornecido (ou atual).

Extension Preview
az quantum workspace update

Atualize o espaço de trabalho do Azure Quantum fornecido (ou atual).

Extension Preview

az quantum execute

Pré-visualizar

O grupo de comandos 'quantum' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Envie um trabalho para ser executado no Azure Quantum e aguarde o resultado. Equivalente a 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]

Exemplos

Execute o código de bits QIR a partir de um arquivo na pasta atual e aguarde o resultado.

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

Execute um trabalho de passagem Quil no simulador Rigetti e aguarde o resultado.

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

Envie um circuito Qiskit para o simulador IonQ com parâmetros de trabalho e aguarde os resultados.

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

Parâmetros Obrigatórios

--job-input-file

O local do arquivo de entrada a ser enviado.

--job-input-format

O formato do ficheiro a enviar.

--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--target-id -t

Motor de execução para trabalhos de computação quântica. Quando um espaço de trabalho é configurado com um conjunto de provedores, cada um deles habilita um ou mais destinos. Você pode configurar o destino padrão usando az quantum target set.

--workspace-name -w

Nome do espaço de trabalho quântico. Você pode configurar o espaço de trabalho padrão usando az quantum workspace seto .

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--entry-point

O ponto de entrada para o programa ou circuito QIR. Necessário para alguns trabalhos QIR provedor.

--job-name

Um nome amigável para dar a esta execução do programa.

--job-output-format

O formato de saída de trabalho esperado.

--job-params

Parâmetros de trabalho passados para o destino como uma lista de pares key=value, cadeia de caracteres json ou @{file} com conteúdo json.

--shots

O número de vezes para executar o programa no destino determinado.

--storage

Se especificado, o ConnectionString de um Armazenamento do Azure é usado para armazenar dados e resultados do trabalho.

--target-capability

Parâmetro target-capability passado para o compilador.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az quantum run

Pré-visualizar

O grupo de comandos 'quantum' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Envie um trabalho para ser executado no Azure Quantum e aguarde o resultado. Equivalente a 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]

Exemplos

Execute o código de bits QIR a partir de um arquivo na pasta atual e aguarde o resultado.

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

Execute um trabalho de passagem Quil no simulador Rigetti e aguarde o resultado.

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

Envie um circuito Qiskit para o simulador IonQ com parâmetros de trabalho e aguarde os resultados.

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

Parâmetros Obrigatórios

--job-input-file

O local do arquivo de entrada a ser enviado.

--job-input-format

O formato do ficheiro a enviar.

--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--target-id -t

Motor de execução para trabalhos de computação quântica. Quando um espaço de trabalho é configurado com um conjunto de provedores, cada um deles habilita um ou mais destinos. Você pode configurar o destino padrão usando az quantum target set.

--workspace-name -w

Nome do espaço de trabalho quântico. Você pode configurar o espaço de trabalho padrão usando az quantum workspace seto .

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--entry-point

O ponto de entrada para o programa ou circuito QIR. Necessário para alguns trabalhos QIR provedor.

--job-name

Um nome amigável para dar a esta execução do programa.

--job-output-format

O formato de saída de trabalho esperado.

--job-params

Parâmetros de trabalho passados para o destino como uma lista de pares key=value, cadeia de caracteres json ou @{file} com conteúdo json.

--shots

O número de vezes para executar o programa no destino determinado.

--storage

Se especificado, o ConnectionString de um Armazenamento do Azure é usado para armazenar dados e resultados do trabalho.

--target-capability

Parâmetro target-capability passado para o compilador.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False