Partilhar via

az quantum

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

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

Gerencie o Azure Quantum Workspaces e envie trabalhos para o Azure Quantum Providers.

Comandos

Name Description Tipo Estado
az quantum execute

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

 Extensão Pré-visualizar
az quantum job

Gerencie trabalhos para o Azure Quantum.

 Extensão Pré-visualizar
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 offerings

Gerencie ofertas de provedor para o Azure Quantum.

 Extensão Pré-visualizar
az quantum offerings accept-terms

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

 Extensão Pré-visualizar
az quantum offerings list

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

 Extensão Pré-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 Pré-visualizar
az quantum run

Equivalente a az quantum execute.

 Extensão Pré-visualizar
az quantum target

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

 Extensão Pré-visualizar
az quantum target clear

Limpe o target id padrão.

 Extensão Pré-visualizar
az quantum target list

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

 Extensão Pré-visualizar
az quantum target set

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

 Extensão Pré-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 Pré-visualizar
az quantum workspace

Gerencie espaços de trabalho do Azure Quantum.

 Extensão Pré-visualizar
az quantum workspace clear

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

 Extensão Pré-visualizar
az quantum workspace create

Crie um novo espaço de trabalho do Azure Quantum.

 Extensão Pré-visualizar
az quantum workspace delete

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

 Extensão Pré-visualizar
az quantum workspace keys

Gerencie chaves de api do Azure Quantum Workspace.

 Extensão Pré-visualizar
az quantum workspace keys list

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

 Extensão Pré-visualizar
az quantum workspace keys regenerate

Regenere a chave de api para o espaço de trabalho do Azure Quantum determinado (ou atual).

 Extensão Pré-visualizar
az quantum workspace list

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

 Extensão Pré-visualizar
az quantum workspace quotas

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

 Extensão Pré-visualizar
az quantum workspace set

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

 Extensão Pré-visualizar
az quantum workspace show

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

 Extensão Pré-visualizar
az quantum workspace update

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

 Extensão Pré-visualizar

az quantum execute

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

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

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 run

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

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

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

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.