az quantum

  • 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 quântico . Saiba mais sobre extensões.

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

Gerencie os Espaços de Trabalho Quânticos do Azure e envie trabalhos para os Provedores Quânticos do Azure.

Comandos

Nome Description Tipo Status
az quantum execute

Envie um trabalho para ser executado no Azure Quantum e aguarde o resultado.

 Extensão Visualizar
az quantum job

Gerenciar trabalhos para o Azure Quantum.

 Extensão Visualizar
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 offerings

Gerenciar ofertas de provedor para o Azure Quantum.

 Extensão Visualizar
az quantum offerings accept-terms

Aceite os termos de uma combinação de provedor e SKU para habilitá-lo para a criação do espaço de trabalho.

 Extensão Visualizar
az quantum offerings list

Obtenha a lista de todas as ofertas de provedores disponíveis no local especificado.

 Extensão Visualizar
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.

 Extensão Visualizar
az quantum run

Equivalente a az quantum execute.

 Extensão Visualizar
az quantum target

Gerenciar destinos para espaços de trabalho do Azure Quantum.

 Extensão Visualizar
az quantum target clear

Limpe o ID de destino padrão.

 Extensão Visualizar
az quantum target list

Obtenha a lista de provedores e seus destinos em um espaço de trabalho do Azure Quantum.

 Extensão Visualizar
az quantum target set

Selecione o destino padrão a ser usado ao enviar trabalhos para o Azure Quantum.

 Extensão Visualizar
az quantum target show

Obtenha a ID de Destino do destino padrão atual para usar ao enviar trabalhos para o Azure Quantum.

 Extensão Visualizar
az quantum workspace

Gerenciar espaços de trabalho do Azure Quantum.

 Extensão Visualizar
az quantum workspace clear

Limpe o espaço de trabalho padrão do Azure Quantum.

 Extensão Visualizar
az quantum workspace create

Crie um espaço de trabalho do Azure Quantum.

 Extensão Visualizar
az quantum workspace delete

Exclua o espaço de trabalho do Azure Quantum fornecido (ou atual).

 Extensão Visualizar
az quantum workspace keys

Gerencie chaves de api do Azure Quantum Workspace.

 Extensão Visualizar
az quantum workspace keys list

Listar chaves de api para o espaço de trabalho do Azure Quantum fornecido (ou atual).

 Extensão Visualizar
az quantum workspace keys regenerate

Gere novamente a chave de api para o espaço de trabalho do Azure Quantum fornecido (ou atual).

 Extensão Visualizar
az quantum workspace list

Obtenha a lista de espaços de trabalho do Azure Quantum disponíveis.

 Extensão Visualizar
az quantum workspace quotas

Liste as cotas para o espaço de trabalho do Azure Quantum fornecido (ou atual).

 Extensão Visualizar
az quantum workspace set

Selecione um espaço de trabalho padrão do Azure Quantum para comandos futuros.

 Extensão Visualizar
az quantum workspace show

Obtenha os detalhes do espaço de trabalho do Azure Quantum fornecido (ou atual).

 Extensão Visualizar
az quantum workspace update

Atualize o espaço de trabalho do Azure Quantum fornecido (ou atual).

 Extensão Visualizar

az quantum execute

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 trabalho para ser executado no Azure Quantum e aguarde o resultado.

az quantum execute --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 e aguarde o resultado.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

Envie e aguarde um programa Q# da pasta atual com parâmetros de trabalho e programa.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

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

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

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 run

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

Equivalente a az quantum execute.

az quantum run --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 e aguarde o resultado.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

Envie e aguarde um programa Q# da pasta atual com parâmetros de trabalho e programa.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

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

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

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.