Partilhar via

az quantum job

  • Pré-visualizar
  • Referência

Nota

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 comandos 'quantum' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie trabalhos para o Azure Quantum.

Comandos

Name Description Tipo Estado
az quantum job cancel

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

 Extensão Pré-visualizar
az quantum job list

Obtenha a lista de trabalhos em um Quantum Workspace.

 Extensão Pré-visualizar
az quantum job output

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

 Extensão Pré-visualizar
az quantum job show

Obtenha o status e os detalhes do trabalho.

 Extensão Pré-visualizar
az quantum job submit

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

 Extensão Pré-visualizar
az quantum job wait

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

 Extensão Pré-visualizar

az quantum job cancel

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

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

Cancelar 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 Obrigatórios

--job-id -j

Identificador exclusivo do trabalho no formato GUID.

--location -l

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

--resource-group -g

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

--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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az quantum job list

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

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 Obrigatórios

--location -l

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

--resource-group -g

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

--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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az quantum job output

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

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 Obrigatórios

--job-id -j

Identificador exclusivo do trabalho no formato GUID.

--location -l

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

--resource-group -g

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

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

--item

O índice de item em um trabalho de lote.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az quantum job show

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

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 Obrigatórios

--job-id -j

Identificador exclusivo do trabalho no formato GUID.

--location -l

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

--resource-group -g

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

--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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az quantum job submit

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 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 de capacidade de destino.

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 a partir 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 Obrigatórios

--location -l

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

--resource-group -g

o 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

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

--job-input-format

O formato do ficheiro a enviar. 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 predefinido: False
--project

[Preterido] A localização 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 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.

<PROGRAM_ARGS>

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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

az quantum job wait

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

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 Obrigatórios

--job-id -j

Identificador exclusivo do trabalho no formato GUID.

--location -l

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

--resource-group -g

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

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

--max-poll-wait-secs

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

valor predefinido: 5
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

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

--verbose

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