az quantum

Préversion

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 . Apprenez-en davantage sur les extensions.

Ce groupe de commandes est en préversion et en cours de développement. Niveaux de référence et 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	État
az quantum execute	Envoyez un travail à exécuter sur Azure Quantum et attendez le résultat. Équivalent à `az quantum run`.	Extension	Preview
az quantum job	Gérer les travaux pour Azure Quantum.	Extension	Preview
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 offerings	Gérer les offres de fournisseurs pour Azure Quantum.	Extension	Preview
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	Preview
az quantum offerings list	Obtenez la liste de toutes les offres de fournisseur disponibles sur l’emplacement donné.	Extension	Preview
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	Preview
az quantum run	Envoyez un travail à exécuter sur Azure Quantum et attendez le résultat. Équivalent à `az quantum execute`.	Extension	Preview
az quantum target	Gérer les cibles pour les espaces de travail Azure Quantum.	Extension	Preview
az quantum target clear	Effacez l’ID cible par défaut.	Extension	Preview
az quantum target list	Obtenez la liste des fournisseurs et de leurs cibles dans un espace de travail Azure Quantum.	Extension	Preview
az quantum target set	Sélectionnez la cible par défaut à utiliser lors de l’envoi de travaux à Azure Quantum.	Extension	Preview
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	Preview
az quantum workspace	Gérer les espaces de travail Azure Quantum.	Extension	Preview
az quantum workspace clear	Effacez l’espace de travail Azure Quantum par défaut.	Extension	Preview
az quantum workspace create	Créez un espace de travail Azure Quantum.	Extension	Preview
az quantum workspace delete	Supprimez l’espace de travail Azure Quantum donné (ou actuel).	Extension	Preview
az quantum workspace keys	Gérer les clés d’API Azure Quantum Workspace.	Extension	Preview
az quantum workspace keys list	Répertoriez les clés API pour l’espace de travail Azure Quantum donné (ou actuel).	Extension	Preview
az quantum workspace keys regenerate	Régénérer la clé API pour l’espace de travail Azure Quantum donné (ou actuel).	Extension	Preview
az quantum workspace list	Obtenez la liste des espaces de travail Azure Quantum disponibles.	Extension	Preview
az quantum workspace quotas	Répertoriez les quotas de l’espace de travail Azure Quantum donné (ou actuel).	Extension	Preview
az quantum workspace set	Sélectionnez un espace de travail Azure Quantum par défaut pour les commandes futures.	Extension	Preview
az quantum workspace show	Obtenez les détails de l’espace de travail Azure Quantum donné (ou actuel).	Extension	Preview
az quantum workspace update	Mettez à jour l’espace de travail Azure Quantum donné (ou actuel).	Extension	Preview

az quantum execute

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

az quantum execute --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

Exécutez le code binaire QIR à partir d’un fichier dans le dossier actif et attendez le résultat.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
    --entry-point MyQirEntryPoint

Exécutez un travail pass-through Quil sur le simulateur Rigetti et attendez le résultat.

az quantum execute -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 Qiskit au simulateur IonQ avec des paramètres de travail et attendez les résultats.

az quantum execute -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 run

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

az quantum run --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

Exécutez le code binaire QIR à partir d’un fichier dans le dossier actif et attendez le résultat.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
    --entry-point MyQirEntryPoint

Exécutez un travail pass-through Quil sur le simulateur Rigetti et attendez le résultat.

az quantum run -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 Qiskit au simulateur IonQ avec des paramètres de travail et attendez les résultats.

az quantum run -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

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

Commentaires

Cette page a-t-elle été utile ?

Partager via

az quantum

Commandes

az quantum execute

Exemples

Paramètres obligatoires

Paramètres facultatifs

az quantum run

Exemples

Paramètres obligatoires

Paramètres facultatifs

Commentaires