Compartilhar via


az quantum

Note

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

Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerencie workspaces do Azure Quantum e envie trabalhos para provedores do Azure Quantum.

Comandos

Nome 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 workspace do Quantum.

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

Gerenciar ofertas de provedor para o Azure Quantum.

Extension Preview
az quantum offerings accept-terms

Aceite os termos de um provedor e uma combinação de SKU para habilitá-lo para a criação do workspace.

Extension Preview
az quantum offerings list

Obtenha a lista de todas as ofertas de provedor disponíveis no local especificado.

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

Gerenciar destinos para workspaces do Azure Quantum.

Extension Preview
az quantum target clear

Desmarque a ID de destino padrão.

Extension Preview
az quantum target list

Obtenha a lista de provedores e seus destinos em um workspace 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 a ser usada ao enviar trabalhos para o Azure Quantum.

Extension Preview
az quantum workspace

Gerenciar workspaces do Azure Quantum.

Extension Preview
az quantum workspace clear

Desmarque o workspace padrão do Azure Quantum.

Extension Preview
az quantum workspace create

Crie um novo workspace do Azure Quantum.

Extension Preview
az quantum workspace delete

Exclua o workspace fornecido (ou atual) do Azure Quantum.

Extension Preview
az quantum workspace keys

Gerenciar chaves de API do Workspace do Azure Quantum.

Extension Preview
az quantum workspace keys list

Listar chaves de api para o workspace do Azure Quantum fornecido (ou atual).

Extension Preview
az quantum workspace keys regenerate

Regenerar a chave de api para o workspace fornecido (ou atual) do Azure Quantum.

Extension Preview
az quantum workspace list

Obtenha a lista de workspaces do Azure Quantum disponíveis.

Extension Preview
az quantum workspace quotas

Liste as cotas para o workspace fornecido (ou atual) do Azure Quantum.

Extension Preview
az quantum workspace set

Selecione um workspace do Azure Quantum padrão para comandos futuros.

Extension Preview
az quantum workspace show

Obtenha os detalhes do workspace fornecido (ou atual) do Azure Quantum.

Extension Preview
az quantum workspace update

Atualize o workspace fornecido (ou atual) do Azure Quantum.

Extension Preview

az quantum execute

Versão Prévia

O grupo de comandos 'quantum' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: 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 bitcode QIR 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 do 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 Exigidos

--job-input-file

O local do arquivo de entrada a ser enviado.

--job-input-format

O formato do arquivo a ser enviado.

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

Mecanismo de execução para trabalhos de computação quântica. Quando um workspace é 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 workspace padrão usando az quantum workspace set.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--entry-point

O ponto de entrada para o programa ou circuito QIR. Necessário para alguns trabalhos de QIR de 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 chave=valor, cadeia de caracteres json ou @{file} com conteúdo json.

--shots

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

--storage

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

--target-capability

Target-capability parâmetro passado para o compilador.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az quantum run

Versão Prévia

O grupo de comandos 'quantum' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: 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 bitcode QIR 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 do 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 Exigidos

--job-input-file

O local do arquivo de entrada a ser enviado.

--job-input-format

O formato do arquivo a ser enviado.

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

Mecanismo de execução para trabalhos de computação quântica. Quando um workspace é 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 workspace padrão usando az quantum workspace set.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--entry-point

O ponto de entrada para o programa ou circuito QIR. Necessário para alguns trabalhos de QIR de 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 chave=valor, cadeia de caracteres json ou @{file} com conteúdo json.

--shots

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

--storage

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

--target-capability

Target-capability parâmetro passado para o compilador.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False