Compartir vía

az quantum

  • Vista previa
  • Referencia

Nota:

Esta referencia forma parte de la extensión cuántica para la CLI de Azure (versión 2.41.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az quantum . Obtenga más información sobre las extensiones.

Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Administre áreas de trabajo de Azure Quantum y envíe trabajos a proveedores de Azure Quantum.

Comandos

Nombre Description Tipo Estado
az quantum execute

Envíe un trabajo para que se ejecute en Azure Quantum y espere el resultado.

 Extensión Vista previa
az quantum job

Administración de trabajos para Azure Quantum.

 Extensión Vista previa
az quantum job cancel

Solicite cancelar un trabajo en Azure Quantum si no se ha completado.

 Extensión Vista previa
az quantum job list

Obtenga la lista de trabajos en un área de trabajo de Quantum.

 Extensión Vista previa
az quantum job output

Obtiene los resultados de ejecutar un trabajo.

 Extensión Vista previa
az quantum job show

Obtenga el estado y los detalles del trabajo.

 Extensión Vista previa
az quantum job submit

Envíe un programa o circuito para que se ejecute en Azure Quantum.

 Extensión Vista previa
az quantum job wait

Coloque la CLI en un estado de espera hasta que el trabajo termine de ejecutarse.

 Extensión Vista previa
az quantum offerings

Administración de ofertas de proveedor para Azure Quantum.

 Extensión Vista previa
az quantum offerings accept-terms

Acepte los términos de un proveedor y la combinación de SKU para habilitarlo para la creación del área de trabajo.

 Extensión Vista previa
az quantum offerings list

Obtenga la lista de todas las ofertas de proveedor disponibles en la ubicación especificada.

 Extensión Vista previa
az quantum offerings show-terms

Mostrar los términos de un proveedor y una combinación de SKU, incluida la dirección URL de licencia y el estado de aceptación.

 Extensión Vista previa
az quantum run

Equivalente a az quantum execute.

 Extensión Vista previa
az quantum target

Administración de destinos para áreas de trabajo de Azure Quantum.

 Extensión Vista previa
az quantum target clear

Borre el identificador de destino predeterminado.

 Extensión Vista previa
az quantum target list

Obtenga la lista de proveedores y sus destinos en un área de trabajo de Azure Quantum.

 Extensión Vista previa
az quantum target set

Seleccione el destino predeterminado que se usará al enviar trabajos a Azure Quantum.

 Extensión Vista previa
az quantum target show

Obtenga el identificador de destino del destino predeterminado actual que se usará al enviar trabajos a Azure Quantum.

 Extensión Vista previa
az quantum workspace

Administración de áreas de trabajo de Azure Quantum.

 Extensión Vista previa
az quantum workspace clear

Borre el área de trabajo predeterminada de Azure Quantum.

 Extensión Vista previa
az quantum workspace create

Cree una nueva área de trabajo de Azure Quantum.

 Extensión Vista previa
az quantum workspace delete

Elimine el área de trabajo de Azure Quantum especificada (o actual).

 Extensión Vista previa
az quantum workspace keys

Administración de claves de API del área de trabajo de Azure Quantum.

 Extensión Vista previa
az quantum workspace keys list

Enumere las claves de API para el área de trabajo de Azure Quantum especificada (o actual).

 Extensión Vista previa
az quantum workspace keys regenerate

Vuelva a generar la clave de API para el área de trabajo de Azure Quantum especificada (o actual).

 Extensión Vista previa
az quantum workspace list

Obtenga la lista de áreas de trabajo de Azure Quantum disponibles.

 Extensión Vista previa
az quantum workspace quotas

Enumere las cuotas del área de trabajo de Azure Quantum especificada (o actual).

 Extensión Vista previa
az quantum workspace set

Seleccione un área de trabajo predeterminada de Azure Quantum para los comandos futuros.

 Extensión Vista previa
az quantum workspace show

Obtenga los detalles del área de trabajo de Azure Quantum especificada (o actual).

 Extensión Vista previa
az quantum workspace update

Actualice el área de trabajo de Azure Quantum especificada (o actual).

 Extensión Vista previa

az quantum execute

Vista previa

El grupo de comandos "quantum" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Envíe un trabajo para que se ejecute en Azure Quantum y espere el 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>]

Ejemplos

Envíe un programa de Q# desde la carpeta actual y espere el resultado.

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

Envíe y espere un programa de Q# desde la carpeta actual con parámetros de trabajo y programa.

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

Envíe y espere un programa de Q# desde la carpeta actual con un parámetro de funcionalidad de destino.

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

Parámetros requeridos

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--target-id -t

Motor de ejecución para trabajos de computación cuántica. Cuando un área de trabajo está configurada con un conjunto de proveedores, cada una habilita uno o varios destinos. Puede configurar el destino predeterminado mediante az quantum target set.

--workspace-name -w

Nombre del área de trabajo de Quantum. Puede configurar el área de trabajo predeterminada mediante az quantum workspace set.

Parámetros opcionales

--entry-point

Punto de entrada para el circuito o el programa QIR. Necesario para QIR. Se omite en los trabajos de Q#.

--job-input-file

Ubicación del archivo de entrada que se va a enviar. Necesario para los trabajos de QIR, QIO y paso a través. Se omite en los trabajos de Q#.

--job-input-format

Formato del archivo que se va a enviar. Omita este parámetro en los trabajos de Q#.

--job-name

Nombre descriptivo que se va a asignar a esta ejecución del programa.

--job-output-format

Formato de salida del trabajo esperado. Se omite en los trabajos de Q#.

--job-params

Parámetros de trabajo pasados al destino como una lista de pares clave=valor, cadena json o @{file} con contenido json.

--no-build

[En desuso] Si se especifica, el programa Q# no se compila antes de enviarlo.

valor predeterminado: False
--project

[En desuso] Ubicación del proyecto de Q# que se va a enviar. El valor predeterminado es la carpeta actual.

--shots

Número de veces que se va a ejecutar el programa Q# en el destino especificado.

--storage

Si se especifica, la Conectar ionString de Azure Storage se usa para almacenar los datos y los resultados del trabajo.

--target-capability

Parámetro de funcionalidad de destino pasado al compilador.

<PROGRAM_ARGS>

Lista de argumentos esperados por la operación de Q# especificada como --name=value después --de .

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az quantum run

Vista previa

El grupo de comandos "quantum" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: 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>]

Ejemplos

Envíe un programa de Q# desde la carpeta actual y espere el resultado.

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

Envíe y espere un programa de Q# desde la carpeta actual con parámetros de trabajo y programa.

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

Envíe y espere un programa de Q# desde la carpeta actual con un parámetro de funcionalidad de destino.

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

Parámetros requeridos

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--target-id -t

Motor de ejecución para trabajos de computación cuántica. Cuando un área de trabajo está configurada con un conjunto de proveedores, cada una habilita uno o varios destinos. Puede configurar el destino predeterminado mediante az quantum target set.

--workspace-name -w

Nombre del área de trabajo de Quantum. Puede configurar el área de trabajo predeterminada mediante az quantum workspace set.

Parámetros opcionales

--entry-point

Punto de entrada para el circuito o el programa QIR. Necesario para QIR. Se omite en los trabajos de Q#.

--job-input-file

Ubicación del archivo de entrada que se va a enviar. Necesario para los trabajos de QIR, QIO y paso a través. Se omite en los trabajos de Q#.

--job-input-format

Formato del archivo que se va a enviar. Omita este parámetro en los trabajos de Q#.

--job-name

Nombre descriptivo que se va a asignar a esta ejecución del programa.

--job-output-format

Formato de salida del trabajo esperado. Se omite en los trabajos de Q#.

--job-params

Parámetros de trabajo pasados al destino como una lista de pares clave=valor, cadena json o @{file} con contenido json.

--no-build

[En desuso] Si se especifica, el programa Q# no se compila antes de enviarlo.

valor predeterminado: False
--project

[En desuso] Ubicación del proyecto de Q# que se va a enviar. El valor predeterminado es la carpeta actual.

--shots

Número de veces que se va a ejecutar el programa Q# en el destino especificado.

--storage

Si se especifica, la Conectar ionString de Azure Storage se usa para almacenar los datos y los resultados del trabajo.

--target-capability

Parámetro de funcionalidad de destino pasado al compilador.

<PROGRAM_ARGS>

Lista de argumentos esperados por la operación de Q# especificada como --name=value después --de .

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.