az quantum

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.