Partager via

az quantum

  • 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 . En savoir plus sur les extensions.

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

Gérez les espaces de travail Azure Quantum et envoyez des travaux aux fournisseurs Azure Quantum.

Commandes

Nom Description Type Statut
az quantum execute

Envoyez un travail à exécuter sur Azure Quantum et attendez le résultat.

 Extension Aperçu
az quantum job

Gérer les travaux pour Azure Quantum.

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

Gérer les offres de fournisseurs pour Azure Quantum.

 Extension Aperçu
az quantum offerings accept-terms

Acceptez les termes d’une combinaison de fournisseurs et de référence SKU pour l’activer pour la création de l’espace de travail.

 Extension Aperçu
az quantum offerings list

Obtenez la liste de toutes les offres de fournisseur disponibles sur l’emplacement donné.

 Extension Aperçu
az quantum offerings show-terms

Affichez les conditions d’une combinaison fournisseur et référence SKU, y compris l’URL de licence et l’état d’acceptation.

 Extension Aperçu
az quantum run

Équivaut à az quantum execute.

 Extension Aperçu
az quantum target

Gérer les cibles pour les espaces de travail Azure Quantum.

 Extension Aperçu
az quantum target clear

Effacez l’ID cible par défaut.

 Extension Aperçu
az quantum target list

Obtenez la liste des fournisseurs et de leurs cibles dans un espace de travail Azure Quantum.

 Extension Aperçu
az quantum target set

Sélectionnez la cible par défaut à utiliser lors de l’envoi de travaux à Azure Quantum.

 Extension Aperçu
az quantum target show

Obtenez l’ID cible de la cible par défaut actuelle à utiliser lors de l’envoi de travaux à Azure Quantum.

 Extension Aperçu
az quantum workspace

Gérer les espaces de travail Azure Quantum.

 Extension Aperçu
az quantum workspace clear

Effacez l’espace de travail Azure Quantum par défaut.

 Extension Aperçu
az quantum workspace create

Créez un espace de travail Azure Quantum.

 Extension Aperçu
az quantum workspace delete

Supprimez l’espace de travail Azure Quantum donné (ou actuel).

 Extension Aperçu
az quantum workspace keys

Gérer les clés d’API Azure Quantum Workspace.

 Extension Aperçu
az quantum workspace keys list

Répertoriez les clés API pour l’espace de travail Azure Quantum donné (ou actuel).

 Extension Aperçu
az quantum workspace keys regenerate

Régénérer la clé API pour l’espace de travail Azure Quantum donné (ou actuel).

 Extension Aperçu
az quantum workspace list

Obtenez la liste des espaces de travail Azure Quantum disponibles.

 Extension Aperçu
az quantum workspace quotas

Répertoriez les quotas de l’espace de travail Azure Quantum donné (ou actuel).

 Extension Aperçu
az quantum workspace set

Sélectionnez un espace de travail Azure Quantum par défaut pour les commandes futures.

 Extension Aperçu
az quantum workspace show

Obtenez les détails de l’espace de travail Azure Quantum donné (ou actuel).

 Extension Aperçu
az quantum workspace update

Mettez à jour l’espace de travail Azure Quantum donné (ou actuel).

 Extension Aperçu

az quantum execute

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 travail à exécuter sur Azure Quantum et attendez le résultat.

az quantum execute --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 et attendez le résultat.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

Envoyez et attendez un programme Q# à partir du dossier actif avec des paramètres de travail et de programme.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

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

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

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 run

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

Équivaut à az quantum execute.

az quantum run --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 et attendez le résultat.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

Envoyez et attendez un programme Q# à partir du dossier actif avec des paramètres de travail et de programme.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

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

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

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.