az quantum job

Versão Prévia

Note

Essa referência faz parte da extensão quantum para o 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 versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerenciar trabalhos para 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.	Extension	Preview
az quantum job delete	Exclua um trabalho de um workspace Azure Quantum.	Extension	Preview
az quantum job file	Gerenciar os arquivos associados de um trabalho quântico.	Extension	Preview
az quantum job file download	Baixe um arquivo do contêiner de armazenamento de saída de um trabalho.	Extension	Preview
az quantum job file list	Liste os arquivos armazenados no contêiner de armazenamento de saída de um trabalho.	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 update	Atualize o nome, a prioridade e/ou as marcas de um trabalho enviado.	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

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

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

az quantum job cancel --job-id
                      --resource-group
                      --workspace-name
                      [--acquire-policy-token]
                      [--change-reference]

Exemplos

Cancele um trabalho Azure Quantum por ID.

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

Parâmetros Exigidos

--job-id -j

Identificador exclusivo do trabalho no formato GUID.

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

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

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

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

Exclua um trabalho de um workspace Azure Quantum.

az quantum job delete --job-id
                      --resource-group
                      --workspace-name
                      [--acquire-policy-token]
                      [--change-reference]
                      [--yes]

Exemplos

Exclua um trabalho Azure Quantum por ID.

az quantum job delete -g MyResourceGroup -w MyWorkspace \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy

Parâmetros Exigidos

--job-id -j

Identificador exclusivo do trabalho no formato GUID.

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

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--yes -y

Não solicite confirmação.

Propriedade	Valor
Valor padrão:	False

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

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

Obtenha a lista de trabalhos em um workspace do Quantum.

az quantum job list --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 workspace Azure Quantum.

az quantum job list -g MyResourceGroup -w MyWorkspace

Listar trabalhos que usaram o provedor quantinuum.

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

Listar trabalhos executados no destino ionq.simulator.

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

Listar trabalhos que foram concluídos com êxito.

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

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

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

Listar trabalhos cujos nomes começam com "Gerar...".

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

Ignore os primeiros 50 trabalhos, inicie a listagem no 51º trabalho e liste 10 trabalhos.

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

Classifique a lista de trabalhos por ID de destino e exiba no formato tabular.

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

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

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

Parâmetros Exigidos

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

--created-after

Trabalhos criados após essa data a serem listados.

--created-before

Trabalhos criados antes desta data a serem listados.

--item-type

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

--job-name

Nome do trabalho a ser listado (pesquisar 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 de Azure Quantum.

--skip

Quantos trabalhos ignorar ao retornar uma lista de trabalhos.

--status

Status dos trabalhos a serem listados.

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

--top

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

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

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

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

az quantum job output --job-id
                      --resource-group
                      --workspace-name
                      [--acquire-policy-token]
                      [--change-reference]

Exemplos

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

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

Parâmetros Exigidos

--job-id -j

Identificador exclusivo do trabalho no formato GUID.

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

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

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

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

Obtenha o status e os detalhes do trabalho.

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

Exemplos

Obtenha o status de um trabalho Azure Quantum.

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

Parâmetros Exigidos

--job-id -j

Identificador exclusivo do trabalho no formato GUID.

--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 workspace padrão usando az quantum workspace set.

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

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 programa ou circuito para ser executado no Azure Quantum.

az quantum job submit --job-input-file
                      --job-input-format
                      --resource-group
                      --target-id
                      --workspace-name
                      [--acquire-policy-token]
                      [--change-reference]
                      [--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 -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 \
   -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 do IonQ para o simulador IonQ com parâmetros de trabalho.

az quantum job submit -g MyResourceGroup -w MyWorkspace \
   -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.

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

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--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 será 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 job update

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

Atualize o nome, a prioridade e/ou as marcas de um trabalho enviado.

az quantum job update --job-id
                      --resource-group
                      --workspace-name
                      [--acquire-policy-token]
                      [--change-reference]
                      [--job-name]
                      [--job-priority {High, Standard}]
                      [--job-tags]

Exemplos

Renomeie um trabalho de Azure Quantum.

az quantum job update -g MyResourceGroup -w MyWorkspace \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --job-name "My new job name"

Altere a prioridade de um trabalho Azure Quantum.

az quantum job update -g MyResourceGroup -w MyWorkspace \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --job-priority High

Substitua as marcas de um trabalho Azure Quantum.

az quantum job update -g MyResourceGroup -w MyWorkspace \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --job-tags tag1 tag2

Parâmetros Exigidos

--job-id -j

Identificador exclusivo do trabalho no formato GUID.

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

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--job-name

O nome amigável atualizado do trabalho.

--job-priority

A prioridade atualizada do trabalho.

Propriedade	Valor
Valores aceitos:	High, Standard

--job-tags

Lista separada por espaço de marcas a serem associadas ao trabalho. Substitui todas as marcas existentes. Passe "" para limpar todas as marcas.

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

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

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

az quantum job wait --job-id
                    --resource-group
                    --workspace-name
                    [--acquire-policy-token]
                    [--change-reference]
                    [--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 \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --max-poll-wait-secs 60 -o table

Parâmetros Exigidos

--job-id -j

Identificador exclusivo do trabalho no formato GUID.

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

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

A ID de referência de alteração relacionada para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--max-poll-wait-secs

Tempo de votação em segundos para consultar Azure Quantum para obter resultados do trabalho correspondente.

Propriedade	Valor
Valor padrão:	5

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

Comentários

Esta página foi útil?