Compartilhar via

az quantum job

  • Versão Prévia
  • Referência

Observação

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

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

Gerenciar trabalhos para o Azure Quantum.

Comandos

Nome Description Tipo Status
az quantum job cancel

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

 Extensão Visualizar
az quantum job list

Obtenha a lista de trabalhos em um Quantum Workspace.

 Extensão Visualizar
az quantum job output

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

 Extensão Visualizar
az quantum job show

Obtenha o status e os detalhes do trabalho.

 Extensão Visualizar
az quantum job submit

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

 Extensão Visualizar
az quantum job wait

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

 Extensão Visualizar

az quantum job cancel

Versão Prévia

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

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

az quantum job cancel --job-id
                      --location
                      --resource-group
                      --workspace-name

Exemplos

Cancele um trabalho do Azure Quantum por id.

az quantum job cancel -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy

Parâmetros Exigidos

--job-id -j

Identificador exclusivo de trabalho no formato GUID.

--location -l

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

--workspace-name -w

Nome do Quantum Workspace. Você pode configurar o espaço de trabalho padrão usando az quantum workspace seto .

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az quantum job list

Versão Prévia

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

Obtenha a lista de trabalhos em um Quantum Workspace.

az quantum job list --location
                    --resource-group
                    --workspace-name

Exemplos

Obtenha a lista de trabalhos de um espaço de trabalho do Azure Quantum.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation

Parâmetros Exigidos

--location -l

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

--workspace-name -w

Nome do Quantum Workspace. Você pode configurar o espaço de trabalho padrão usando az quantum workspace seto .

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az quantum job output

Versão Prévia

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

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

az quantum job output --job-id
                      --location
                      --resource-group
                      --workspace-name
                      [--item]

Exemplos

Imprima os resultados de um trabalho bem-sucedido do Azure Quantum.

az quantum job output -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy -o table

Parâmetros Exigidos

--job-id -j

Identificador exclusivo de trabalho no formato GUID.

--location -l

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

--workspace-name -w

Nome do Quantum Workspace. Você pode configurar o espaço de trabalho padrão usando az quantum workspace seto .

Parâmetros Opcionais

--item

O índice de itens em um trabalho em lote.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az quantum job show

Versão Prévia

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

Obtenha o status e os detalhes do trabalho.

az quantum job show --job-id
                    --location
                    --resource-group
                    --workspace-name

Exemplos

Obtenha o status de um trabalho do Azure Quantum.

az quantum job show -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --query status

Parâmetros Exigidos

--job-id -j

Identificador exclusivo de trabalho no formato GUID.

--location -l

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

--workspace-name -w

Nome do Quantum Workspace. Você pode configurar o espaço de trabalho padrão usando az quantum workspace seto .

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az quantum job submit

Versão Prévia

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

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

az quantum job submit --location
                      --resource-group
                      --target-id
                      --workspace-name
                      [--entry-point]
                      [--job-input-file]
                      [--job-input-format]
                      [--job-name]
                      [--job-output-format]
                      [--job-params]
                      [--no-build]
                      [--project]
                      [--shots]
                      [--storage]
                      [--target-capability]
                      [<PROGRAM_ARGS>]

Exemplos

Envie um programa Q# da pasta atual.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob

Envie um programa Q# da pasta atual com parâmetros de trabalho para um destino.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob --job-params param1=value1 param2=value2

Envie um programa Q# com parâmetros de programa (por exemplo, n-qubits = 2).

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob -- --n-qubits=2

Envie um programa Q# da pasta atual com um parâmetro target-capability.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --target-capability MyTargetCapability

Envie o código de bits QIR ou o código LLVM legível por humanos de um arquivo na pasta atual.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
    --entry-point MyQirEntryPoint

Parâmetros Exigidos

--location -l

Local. 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 seto .

--workspace-name -w

Nome do Quantum Workspace. Você pode configurar o espaço de trabalho padrão usando az quantum workspace seto .

Parâmetros Opcionais

--entry-point

O ponto de entrada para o programa ou circuito QIR. Necessário para QIR. Ignorado em trabalhos Q#.

--job-input-file

O local do arquivo de entrada a ser enviado. Necessário para trabalhos de QIR, QIO e de passagem. Ignorado em trabalhos Q#.

--job-input-format

O formato do arquivo a ser enviado. Omita esse parâmetro em trabalhos Q#.

--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. Ignorado em trabalhos Q#.

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

--no-build

[Preterido] Se especificado, o programa Q# não é criado antes do envio.

valor padrão: False
--project

[Preterido] O local do projeto Q# a ser enviado. O padrão é a pasta atual.

--shots

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

--storage

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

--target-capability

Parâmetro target-capability passado para o compilador.

<PROGRAM_ARGS>

Lista de argumentos esperados pela operação Q# especificada como --name=value after --.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az quantum job wait

Versão Prévia

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

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

az quantum job wait --job-id
                    --location
                    --resource-group
                    --workspace-name
                    [--max-poll-wait-secs]

Exemplos

Aguarde a conclusão de um trabalho, verifique em intervalos de 60 segundos.

az quantum job wait -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --max-poll-wait-secs 60 -o table

Parâmetros Exigidos

--job-id -j

Identificador exclusivo de trabalho no formato GUID.

--location -l

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

--workspace-name -w

Nome do Quantum Workspace. Você pode configurar o espaço de trabalho padrão usando az quantum workspace seto .

Parâmetros Opcionais

--max-poll-wait-secs

Tempo de sondagem em segundos para consultar o Azure Quantum para obter resultados do trabalho correspondente.

valor padrão: 5
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.