Compartir vía


az quantum

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 se instalará automáticamente la primera vez que ejecute un comando az quantum . 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. Equivalente a az quantum run.

Extensión Versión preliminar
az quantum job

Administración de trabajos para Azure Quantum.

Extensión Versión preliminar
az quantum job cancel

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

Extensión Versión preliminar
az quantum job list

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

Extensión Versión preliminar
az quantum job output

Obtiene los resultados de ejecutar un trabajo.

Extensión Versión preliminar
az quantum job show

Obtenga el estado y los detalles del trabajo.

Extensión Versión preliminar
az quantum job submit

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

Extensión Versión preliminar
az quantum job wait

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

Extensión Versión preliminar
az quantum offerings

Administración de ofertas de proveedor para Azure Quantum.

Extensión Versión preliminar
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 Versión preliminar
az quantum offerings list

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

Extensión Versión preliminar
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 Versión preliminar
az quantum run

Envíe un trabajo para que se ejecute en Azure Quantum y espere el resultado. Equivalente a az quantum execute.

Extensión Versión preliminar
az quantum target

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

Extensión Versión preliminar
az quantum target clear

Borre el identificador de destino predeterminado.

Extensión Versión preliminar
az quantum target list

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

Extensión Versión preliminar
az quantum target set

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

Extensión Versión preliminar
az quantum target show

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

Extensión Versión preliminar
az quantum workspace

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

Extensión Versión preliminar
az quantum workspace clear

Borre el área de trabajo predeterminada de Azure Quantum.

Extensión Versión preliminar
az quantum workspace create

Cree un área de trabajo de Azure Quantum.

Extensión Versión preliminar
az quantum workspace delete

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

Extensión Versión preliminar
az quantum workspace keys

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

Extensión Versión preliminar
az quantum workspace keys list

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

Extensión Versión preliminar
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 Versión preliminar
az quantum workspace list

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

Extensión Versión preliminar
az quantum workspace quotas

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

Extensión Versión preliminar
az quantum workspace set

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

Extensión Versión preliminar
az quantum workspace show

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

Extensión Versión preliminar
az quantum workspace update

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

Extensión Versión preliminar

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. Equivalente a az quantum run.

az quantum execute --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]

Ejemplos

Ejecute qiR bitcode desde un archivo de la carpeta actual y espere el resultado.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
    --entry-point MyQirEntryPoint

Ejecute un trabajo de paso a través de Quil en el simulador de Rigetti y espere el resultado.

az quantum execute -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

Envíe un circuito Qiskit al simulador de IonQ con parámetros de trabajo y espere los resultados.

az quantum execute -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 requeridos

--job-input-file

Ubicación del archivo de entrada que se va a enviar.

--job-input-format

Formato del archivo que se va a enviar.

--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 los trabajos de QIR.

--job-name

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

--job-output-format

Formato de salida del trabajo esperado.

--job-params

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

--shots

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

--storage

Si se especifica, connectionString de Una instancia 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.

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver 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

Envíe un trabajo para que se ejecute en Azure Quantum y espere el resultado. Equivalente a az quantum execute.

az quantum run --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]

Ejemplos

Ejecute qiR bitcode desde un archivo de la carpeta actual y espere el resultado.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
    --entry-point MyQirEntryPoint

Ejecute un trabajo de paso a través de Quil en el simulador de Rigetti y espere el resultado.

az quantum run -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

Envíe un circuito Qiskit al simulador de IonQ con parámetros de trabajo y espere los resultados.

az quantum run -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 requeridos

--job-input-file

Ubicación del archivo de entrada que se va a enviar.

--job-input-format

Formato del archivo que se va a enviar.

--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 los trabajos de QIR.

--job-name

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

--job-output-format

Formato de salida del trabajo esperado.

--job-params

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

--shots

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

--storage

Si se especifica, connectionString de Una instancia 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.

Parámetros globales
--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.