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 |
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 |
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
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
O local do arquivo de entrada a ser enviado.
O formato do arquivo a ser enviado.
Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
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.
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.
O ponto de entrada para o programa ou circuito QIR. Necessário para alguns trabalhos de QIR de provedor.
Um nome amigável para dar a esta execução do programa.
O formato de saída de trabalho esperado.
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.
O número de vezes para executar o programa no destino especificado.
Se especificado, o ConnectionString de um Armazenamento do Azure é usado para armazenar dados e resultados do trabalho.
Target-capability parâmetro passado para o compilador.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az quantum run
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
O local do arquivo de entrada a ser enviado.
O formato do arquivo a ser enviado.
Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
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.
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.
O ponto de entrada para o programa ou circuito QIR. Necessário para alguns trabalhos de QIR de provedor.
Um nome amigável para dar a esta execução do programa.
O formato de saída de trabalho esperado.
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.
O número de vezes para executar o programa no destino especificado.
Se especificado, o ConnectionString de um Armazenamento do Azure é usado para armazenar dados e resultados do trabalho.
Target-capability parâmetro passado para o compilador.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |