az quantum job

  • Préversion
  • Référence

Remarque

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

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

Gérer les travaux pour Azure Quantum.

Commandes

Nom Description Type Statut
az quantum job cancel

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

 Extension Aperçu
az quantum job list

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

 Extension Aperçu
az quantum job output

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

 Extension Aperçu
az quantum job show

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

 Extension Aperçu
az quantum job submit

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

 Extension Aperçu
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 Aperçu

az quantum job cancel

Préversion

Le groupe de commandes « quantum » est en préversion et en cours de développement. Référence et niveaux 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

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az quantum job list

Préversion

Le groupe de commandes « quantum » est en préversion et en cours de développement. Référence et niveaux 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

Exemples

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

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

Paramètres obligatoires

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az quantum job output

Préversion

Le groupe de commandes « quantum » est en préversion et en cours de développement. Référence et niveaux 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
                      [--item]

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

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant 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

--item

Index d’élément dans un travail de traitement par lots.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az quantum job show

Préversion

Le groupe de commandes « quantum » est en préversion et en cours de développement. Référence et niveaux 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

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant 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 le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az quantum job submit

Préversion

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

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

Exemples

Envoyez un programme Q# à partir du dossier actif.

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

Envoyez un programme Q# à partir du dossier actif avec des paramètres de travail pour une cible.

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

Envoyez un programme Q# avec des paramètres de programme (par exemple, n-qubits = 2).

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

Envoyez un programme Q# à partir du dossier actif avec un paramètre de capacité cible.

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

Envoyez le code LLVM QIR ou le code LLVM lisible par l’homme à 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

Paramètres obligatoires

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant 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

--entry-point

Point d’entrée du programme ou du circuit QIR. Obligatoire pour QIR. Ignoré sur les travaux Q#.

--job-input-file

Emplacement du fichier d’entrée à envoyer. Requis pour les travaux QIR, QIO et pass-through. Ignoré sur les travaux Q#.

--job-input-format

Format du fichier à envoyer. Omettez ce paramètre sur les travaux Q#.

--job-name

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

--job-output-format

Format de sortie du travail attendu. Ignoré sur les travaux Q#.

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

--no-build

[Déconseillé] S’il est spécifié, le programme Q# n’est pas généré avant l’envoi.

valeur par défaut: False
--project

[Déconseillé] Emplacement du projet Q# à soumettre. La valeur par défaut est le dossier actif.

--shots

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

--storage

Si elle est spécifiée, la Connecter ionString 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.

<PROGRAM_ARGS>

Liste des arguments attendus par l’opération Q# spécifiée en tant que --name=value après --.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az quantum job wait

Préversion

Le groupe de commandes « quantum » est en préversion et en cours de développement. Référence et niveaux 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, case activée à 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

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant 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

--max-poll-wait-secs

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

valeur par défaut: 5
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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