az quantum job
Note
Esta referencia forma parte de la extensión cuántica para la CLI de Azure (versión 2.73.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az quantum job . Obtenga más información sobre las extensiones.
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
Administración de trabajos para Azure Quantum.
Comandos
| Nombre | Description | Tipo | Estado |
|---|---|---|---|
| az quantum job cancel |
Solicite cancelar un trabajo en Azure Quantum si no se ha completado. |
Extension | Preview |
| az quantum job list |
Obtenga la lista de trabajos en un área de trabajo de Quantum. |
Extension | Preview |
| az quantum job output |
Obtiene los resultados de ejecutar un trabajo. |
Extension | Preview |
| az quantum job show |
Obtenga el estado y los detalles del trabajo. |
Extension | Preview |
| az quantum job submit |
Envíe un programa o circuito para que se ejecute en Azure Quantum. |
Extension | Preview |
| az quantum job wait |
Coloque la CLI en un estado de espera hasta que el trabajo termine de ejecutarse. |
Extension | Preview |
az quantum job cancel
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
Solicite cancelar un trabajo en Azure Quantum si no se ha completado.
az quantum job cancel --job-id
--location
--resource-group
--workspace-name
Ejemplos
Cancelación de un trabajo de Azure Quantum por identificador.
az quantum job cancel -g MyResourceGroup -w MyWorkspace -l MyLocation \
-j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy
Parámetros requeridos
Identificador único del trabajo en formato GUID.
Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del área de trabajo de Quantum. Puede configurar el área de trabajo predeterminada mediante az quantum workspace set.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az quantum job list
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
Obtenga la lista de trabajos en un área de trabajo de Quantum.
az quantum job list --location
--resource-group
--workspace-name
[--created-after]
[--created-before]
[--item-type]
[--job-name]
[--job-type]
[--order]
[--orderby]
[--provider-id]
[--skip]
[--status]
[--target-id]
[--top]
Ejemplos
Obtenga la lista de trabajos de un área de trabajo de Azure Quantum.
az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation
Enumera los trabajos que usaron el proveedor de quantinuum.
az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --provider-id quantinuum
Enumera los trabajos que se ejecutaron en el destino de ionq.simulator.
az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --target-id ionq.simulator
Enumera los trabajos que se completaron correctamente.
az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --status Succeeded
Enumera los trabajos creados después del 15 de enero de 2025.
az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --created-after 2025-01-15
Enumera los trabajos cuyos nombres comienzan por "Generar...".
az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --job-name Generate
Omita los primeros 50 trabajos, empiece a enumerar en el 51º trabajo y en la lista 10 trabajos.
az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --skip 50 --top 10
Ordene la lista de trabajos por identificador de destino y se muestre en formato tabular.
az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Target -o table
Ordene la lista de trabajos por Nombre de trabajo en orden descendente, se muestra en formato tabular.
az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Name --order desc -o table
Parámetros requeridos
Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del área de trabajo de Quantum. Puede configurar el área de trabajo predeterminada mediante az quantum workspace set.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Trabajos creados después de esta fecha que se mostrarán.
Trabajos creados antes de esta fecha que se mostrarán.
Tipo de elemento que se va a mostrar, "trabajo" o "sesión".
Nombre del trabajo que se va a enumerar (buscar por prefijo), ejemplo "Mi trabajo".
Tipo de trabajo que se va a enumerar, ejemplo "QuantumComputing".
Cómo ordenar la lista: asc o desc.
Campo en el que se va a ordenar la lista.
Identificador de un proveedor de Azure Quantum.
Número de trabajos que se van a omitir al devolver una lista de trabajos.
Estado de los trabajos que se van a enumerar.
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.
Número de trabajos enumerados por página.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az quantum job output
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
Obtiene los resultados de ejecutar un trabajo.
az quantum job output --job-id
--location
--resource-group
--workspace-name
Ejemplos
Imprima los resultados de un trabajo de Azure Quantum correcto.
az quantum job output -g MyResourceGroup -w MyWorkspace -l MyLocation \
-j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy -o table
Parámetros requeridos
Identificador único del trabajo en formato GUID.
Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del área de trabajo de Quantum. Puede configurar el área de trabajo predeterminada mediante az quantum workspace set.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az quantum job show
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
Obtenga el estado y los detalles del trabajo.
az quantum job show --job-id
--location
--resource-group
--workspace-name
Ejemplos
Obtenga el estado de un trabajo de Azure Quantum.
az quantum job show -g MyResourceGroup -w MyWorkspace -l MyLocation \
-j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --query status
Parámetros requeridos
Identificador único del trabajo en formato GUID.
Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del área de trabajo de Quantum. Puede configurar el área de trabajo predeterminada mediante az quantum workspace set.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az quantum job submit
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 programa o circuito para que se ejecute en Azure Quantum.
az quantum job submit --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
Envíe el código de bits QIR desde un archivo de la carpeta actual.
az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
--job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
--entry-point MyQirEntryPoint
Envíe un trabajo de paso a través de Quil al simulador de Rigetti.
az quantum job submit -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 JSON de IonQ al simulador de IonQ con parámetros de trabajo.
az quantum job submit -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
Ubicación del archivo de entrada que se va a enviar.
Formato del archivo que se va a enviar.
Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
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.
Nombre del área de trabajo de Quantum. Puede configurar el área de trabajo predeterminada mediante az quantum workspace set.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Punto de entrada para el circuito o el programa QIR. Necesario para algunos trabajos de QIR del proveedor.
Nombre descriptivo que se va a asignar a esta ejecución del programa.
Formato de salida del trabajo esperado.
Parámetros de trabajo pasados al destino como una lista de pares clave=valor, cadena json o @{file} con contenido json.
Número de veces que se va a ejecutar el programa en el destino especificado.
Si se especifica, connectionString de Una instancia de Azure Storage se usa para almacenar los datos y los resultados del trabajo.
Parámetro de funcionalidad de destino pasado al compilador.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
az quantum job wait
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
Coloque la CLI en un estado de espera hasta que el trabajo termine de ejecutarse.
az quantum job wait --job-id
--location
--resource-group
--workspace-name
[--max-poll-wait-secs]
Ejemplos
Espere a que finalice un trabajo, compruebe en intervalos de 60 segundos.
az quantum job wait -g MyResourceGroup -w MyWorkspace -l MyLocation \
-j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --max-poll-wait-secs 60 -o table
Parámetros requeridos
Identificador único del trabajo en formato GUID.
Location. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Nombre del área de trabajo de Quantum. Puede configurar el área de trabajo predeterminada mediante az quantum workspace set.
Parámetros opcionales
Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.
Tiempo de sondeo en segundos para consultar Azure Quantum para obtener los resultados del trabajo correspondiente.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | 5 |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |