Share via


az quantum job

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

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

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

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

Ejemplos

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

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation

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

--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 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 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
                      [--item]

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

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

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

--item

Índice de elemento en un trabajo de procesamiento por lotes.

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

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

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

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob

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

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob --job-params param1=value1 param2=value2

Envíe un programa de Q# con parámetros de programa (por ejemplo, n-cúbits = 2).

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob -- --n-qubits=2

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

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

Envíe el código de bits QIR o el código LLVM legible 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

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

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

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

--max-poll-wait-secs

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

valor predeterminado: 5
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.