az quantum job

Pré-visualizar

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

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

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

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 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
                    [--created-after]
                    [--created-before]
                    [--item-type]
                    [--job-name]
                    [--job-type]
                    [--order]
                    [--orderby]
                    [--provider-id]
                    [--skip]
                    [--status]
                    [--target-id]
                    [--top]

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

Listar trabalhos que usaram o provedor quantinuum.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --provider-id quantinuum

Liste os trabalhos executados no destino ionq.simulator.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --target-id ionq.simulator

Liste os trabalhos concluídos com êxito.

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

Listar empregos criados após 15 de janeiro de 2025.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --created-after 2025-01-15

Liste trabalhos cujos nomes comecem com "Gerar...".

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

Ignore as primeiras 50 vagas, comece a listar na 51ª vaga e liste 10 vagas.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --skip 50 --top 10

Classifique a lista de tarefas por ID de destino e exiba em formato tabular.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Target -o table

Classifique a lista de trabalhos por Nome do Trabalho em ordem decrescente, exibida em formato tabular.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Name --order desc -o table

Parâmetros Obrigatórios

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

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

--created-after

Os empregos criados após esta data devem ser listados.

--created-before

Os postos de trabalho criados antes desta data devem ser listados.

--item-type

Tipo de item a ser listado, "trabalho" ou "sessão".

--job-name

Nome do trabalho a ser listado (pesquisa por prefixo), exemplo "Meu trabalho".

--job-type

Tipo de trabalho a ser listado, exemplo "QuantumComputing".

--order

Como ordenar a lista: asc ou desc.

--orderby

O campo no qual ordenar a lista.

--provider-id -p

Identificador de um provedor do Azure Quantum.

--skip

Quantos trabalhos ignorar ao retornar uma lista de trabalhos.

--status

Status dos trabalhos a serem listados.

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

--top

O número de trabalhos listados por página.

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

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

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

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

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

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

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

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

Envie o código de bits QIR 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

Envie um trabalho de passagem Quil para o simulador Rigetti.

az quantum job submit -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 JSON IonQ para o simulador IonQ com parâmetros de trabalho.

az quantum job submit -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

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

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

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

--max-poll-wait-secs

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

Propriedade	Valor
Default value:	5

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

Feedback

Esta página foi útil?

Partilhar via

az quantum job

Comandos

az quantum job cancel

Exemplos

Parâmetros Obrigatórios

az quantum job list

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az quantum job output

Exemplos

Parâmetros Obrigatórios

az quantum job show

Exemplos

Parâmetros Obrigatórios

az quantum job submit

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az quantum job wait

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

Feedback