Compartir a través de


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

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

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

--job-id -j

Identificador único del trabajo en formato GUID.

--location -l

Location. 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>.

--workspace-name -w

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

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propiedad Valor
Valor predeterminado: False

az quantum job list

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

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 -l

Location. 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>.

--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

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.

--created-after

Trabajos creados después de esta fecha que se mostrarán.

--created-before

Trabajos creados antes de esta fecha que se mostrarán.

--item-type

Tipo de elemento que se va a mostrar, "trabajo" o "sesión".

--job-name

Nombre del trabajo que se va a enumerar (buscar por prefijo), ejemplo "Mi trabajo".

--job-type

Tipo de trabajo que se va a enumerar, ejemplo "QuantumComputing".

--order

Cómo ordenar la lista: asc o desc.

--orderby

Campo en el que se va a ordenar la lista.

--provider-id -p

Identificador de un proveedor de Azure Quantum.

--skip

Número de trabajos que se van a omitir al devolver una lista de trabajos.

--status

Estado de los trabajos que se van a enumerar.

--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.

--top

Número de trabajos enumerados por página.

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propiedad Valor
Valor predeterminado: False

az quantum job output

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

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

--job-id -j

Identificador único del trabajo en formato GUID.

--location -l

Location. 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>.

--workspace-name -w

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

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propiedad Valor
Valor predeterminado: False

az quantum job show

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

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

--job-id -j

Identificador único del trabajo en formato GUID.

--location -l

Location. 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>.

--workspace-name -w

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

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propiedad Valor
Valor predeterminado: False

az quantum job submit

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 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

--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

Location. 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

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.

--entry-point

Punto de entrada para el circuito o el programa QIR. Necesario para algunos trabajos de QIR del proveedor.

--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.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propiedad Valor
Valor predeterminado: False

az quantum job wait

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

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

--job-id -j

Identificador único del trabajo en formato GUID.

--location -l

Location. 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>.

--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

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.

--max-poll-wait-secs

Tiempo de sondeo en segundos para consultar Azure Quantum para obtener los resultados del trabajo correspondiente.

Propiedad Valor
Valor predeterminado: 5
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Propiedad Valor
Valor predeterminado: False