Partager via


az quantum job

Note

Cette référence fait partie de l’extension quantique pour Azure CLI (version 2.73.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az quantum job . Apprenez-en davantage sur les extensions.

Le groupe de commandes « quantum » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Gérer les travaux pour Azure Quantum.

Commandes

Nom Description Type État
az quantum job cancel

Demande d’annulation d’un travail sur Azure Quantum s’il n’est pas terminé.

Extension Preview
az quantum job list

Obtenez la liste des travaux dans un espace de travail Quantum.

Extension Preview
az quantum job output

Obtenez les résultats de l’exécution d’un travail.

Extension Preview
az quantum job show

Obtenez l’état et les détails du travail.

Extension Preview
az quantum job submit

Envoyez un programme ou un circuit à exécuter sur Azure Quantum.

Extension Preview
az quantum job wait

Placez l’interface CLI dans un état d’attente jusqu’à ce que le travail se termine en cours d’exécution.

Extension Preview

az quantum job cancel

Préversion

Le groupe de commandes « quantum » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Demande d’annulation d’un travail sur Azure Quantum s’il n’est pas terminé.

az quantum job cancel --job-id
                      --location
                      --resource-group
                      --workspace-name

Exemples

Annulez un travail Azure Quantum par ID.

az quantum job cancel -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy

Paramètres obligatoires

--job-id -j

Identificateur unique de travail au format GUID.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--workspace-name -w

Nom de l’espace de travail Quantum. Vous pouvez configurer l’espace de travail par défaut à l’aide az quantum workspace setde .

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az quantum job list

Préversion

Le groupe de commandes « quantum » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Obtenez la liste des travaux dans un espace de travail 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]

Exemples

Obtenez la liste des travaux à partir d’un espace de travail Azure Quantum.

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

Répertorier les travaux qui utilisaient le fournisseur quantinuum.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --provider-id quantinuum

Répertorier les travaux exécutés sur la cible ionq.simulator.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --target-id ionq.simulator

Répertorier les travaux qui se sont terminés avec succès.

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

Répertorier les travaux créés après le 15 janvier 2025.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --created-after 2025-01-15

Répertorier les travaux dont les noms commencent par « Générer... ».

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

Ignorez les 50 premiers travaux, commencez à répertorier au 51e travail et listez 10 travaux.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --skip 50 --top 10

Triez la liste des travaux par ID cible et affichez le format tabulaire.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Target -o table

Triez la liste des travaux par nom de travail dans l’ordre décroissant, affichée au format tabulaire.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Name --order desc -o table

Paramètres obligatoires

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--workspace-name -w

Nom de l’espace de travail Quantum. Vous pouvez configurer l’espace de travail par défaut à l’aide az quantum workspace setde .

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--created-after

Travaux créés après cette date à répertorier.

--created-before

Travaux créés avant cette date à répertorier.

--item-type

Type d’élément à répertorier, « job » ou « session ».

--job-name

Nom du travail à répertorier (recherche par préfixe), exemple « Mon travail ».

--job-type

Type de travail à répertorier, exemple « QuantumComputing ».

--order

Comment classer la liste : asc ou desc.

--orderby

Champ sur lequel classer la liste.

--provider-id -p

Identificateur d’un fournisseur Azure Quantum.

--skip

Nombre de travaux à ignorer lors du renvoi d’une liste de travaux.

--status

État des travaux à répertorier.

--target-id -t

Moteur d’exécution pour les travaux de calcul quantique. Lorsqu’un espace de travail est configuré avec un ensemble de fournisseurs, ils activent chacun une ou plusieurs cibles. Vous pouvez configurer la cible par défaut à l’aide az quantum target setde .

--top

Nombre de travaux répertoriés par page.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az quantum job output

Préversion

Le groupe de commandes « quantum » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Obtenez les résultats de l’exécution d’un travail.

az quantum job output --job-id
                      --location
                      --resource-group
                      --workspace-name

Exemples

Imprimez les résultats d’une tâche Azure Quantum réussie.

az quantum job output -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy -o table

Paramètres obligatoires

--job-id -j

Identificateur unique de travail au format GUID.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--workspace-name -w

Nom de l’espace de travail Quantum. Vous pouvez configurer l’espace de travail par défaut à l’aide az quantum workspace setde .

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az quantum job show

Préversion

Le groupe de commandes « quantum » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Obtenez l’état et les détails du travail.

az quantum job show --job-id
                    --location
                    --resource-group
                    --workspace-name

Exemples

Obtenez l’état d’un travail Azure Quantum.

az quantum job show -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --query status

Paramètres obligatoires

--job-id -j

Identificateur unique de travail au format GUID.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--workspace-name -w

Nom de l’espace de travail Quantum. Vous pouvez configurer l’espace de travail par défaut à l’aide az quantum workspace setde .

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az quantum job submit

Préversion

Le groupe de commandes « quantum » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Envoyez un programme ou un circuit à exécuter sur 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]

Exemples

Envoyez le bitcode QIR à partir d’un fichier dans le dossier actif.

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

Soumettez un travail pass-through Quil au simulateur 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

Envoyez un circuit JSON IonQ au simulateur IonQ avec des paramètres de travail.

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

Paramètres obligatoires

--job-input-file

Emplacement du fichier d’entrée à envoyer.

--job-input-format

Format du fichier à envoyer.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--target-id -t

Moteur d’exécution pour les travaux de calcul quantique. Lorsqu’un espace de travail est configuré avec un ensemble de fournisseurs, ils activent chacun une ou plusieurs cibles. Vous pouvez configurer la cible par défaut à l’aide az quantum target setde .

--workspace-name -w

Nom de l’espace de travail Quantum. Vous pouvez configurer l’espace de travail par défaut à l’aide az quantum workspace setde .

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--entry-point

Point d’entrée du programme ou du circuit QIR. Requis pour certains travaux QIR de fournisseur.

--job-name

Nom convivial à donner à cette exécution du programme.

--job-output-format

Format de sortie du travail attendu.

--job-params

Paramètres de travail passés à la cible sous la forme d’une liste de paires clé=valeur, de chaîne json ou @{file} avec du contenu json.

--shots

Nombre de fois où exécuter le programme sur la cible donnée.

--storage

Si elle est spécifiée, connectionString d’un Stockage Azure est utilisée pour stocker les données et les résultats du travail.

--target-capability

Paramètre de capacité cible transmis au compilateur.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az quantum job wait

Préversion

Le groupe de commandes « quantum » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Placez l’interface CLI dans un état d’attente jusqu’à ce que le travail se termine en cours d’exécution.

az quantum job wait --job-id
                    --location
                    --resource-group
                    --workspace-name
                    [--max-poll-wait-secs]

Exemples

Attendez la fin d’un travail, vérifiez à 60 secondes intervalles.

az quantum job wait -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --max-poll-wait-secs 60 -o table

Paramètres obligatoires

--job-id -j

Identificateur unique de travail au format GUID.

--location -l

Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

--workspace-name -w

Nom de l’espace de travail Quantum. Vous pouvez configurer l’espace de travail par défaut à l’aide az quantum workspace setde .

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--max-poll-wait-secs

Temps d’interrogation en secondes pour interroger Azure Quantum pour obtenir les résultats du travail correspondant.

Propriété Valeur
Valeur par défaut: 5
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False