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
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
Identificateur unique de travail au format GUID.
Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
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. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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.
Travaux créés après cette date à répertorier.
Travaux créés avant cette date à répertorier.
Type d’élément à répertorier, « job » ou « session ».
Nom du travail à répertorier (recherche par préfixe), exemple « Mon travail ».
Type de travail à répertorier, exemple « QuantumComputing ».
Comment classer la liste : asc ou desc.
Champ sur lequel classer la liste.
Identificateur d’un fournisseur Azure Quantum.
Nombre de travaux à ignorer lors du renvoi d’une liste de travaux.
État des travaux à répertorier.
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 .
Nombre de travaux répertoriés par page.
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
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
Identificateur unique de travail au format GUID.
Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
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
Identificateur unique de travail au format GUID.
Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
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
Emplacement du fichier d’entrée à envoyer.
Format du fichier à envoyer.
Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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 .
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.
Point d’entrée du programme ou du circuit QIR. Requis pour certains travaux QIR de fournisseur.
Nom convivial à donner à cette exécution du programme.
Format de sortie du travail attendu.
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.
Nombre de fois où exécuter le programme sur la cible donnée.
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.
Paramètre de capacité cible transmis au compilateur.
Paramètres globaux
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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
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
Identificateur unique de travail au format GUID.
Location. Valeurs provenant de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.
Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.
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.
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
Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Affichez ce message d’aide et quittez.
Afficher uniquement les erreurs, en supprimant les avertissements.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | False |
Format de sortie.
| Propriété | Valeur |
|---|---|
| Valeur par défaut: | json |
| Valeurs acceptées: | json, jsonc, none, table, tsv, yaml, yamlc |
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
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 |