az quantum
Note
Cette référence fait partie de l’extension quantum pour la 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 Azure Quantum espaces de travail et envoyez des travaux à des 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 à |
Extension | Preview |
| az quantum job |
Gérez 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 delete |
Supprimez un travail d’un espace de travail Azure Quantum. |
Extension | Preview |
| az quantum job file |
Gérez les fichiers associés à un travail quantique. |
Extension | Preview |
| az quantum job file download |
Téléchargez un fichier à partir du conteneur de stockage de sortie d’un travail. |
Extension | Preview |
| az quantum job file list |
Répertoriez les fichiers stockés dans le conteneur de stockage de sortie d’un travail. |
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 update |
Mettez à jour le nom, la priorité et/ou les balises d’un travail soumis. |
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 à |
Extension | Preview |
| az quantum suite-offer |
Affichez Azure Quantum offres de suite pour les fournisseurs V2 disponibles pour l’abonnement. |
Extension | Preview |
| az quantum suite-offer list |
Répertoriez les offres de suite de fournisseurs V2 disponibles pour l’abonnement actuel, notamment l’ID du fournisseur, le nom, l’entreprise et l’emplacement. |
Extension | Preview |
| az quantum suite-offer quotas |
Affichez les allocations de quota et leurs utilisations consommées pour une offre de suite de fournisseurs V2 dans l’abonnement actuel. |
Extension | Preview |
| az quantum suite-offer target |
Répertoriez les cibles disponibles via une offre de suite Azure Quantum pour un fournisseur V2. |
Extension | Preview |
| az quantum suite-offer target list |
Répertoriez les cibles et leur état disponibles via une offre de suite de fournisseurs V2, sans nécessiter d’espace de travail. |
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 Azure Quantum espaces de travail. |
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 donné (ou actuel) Azure Quantum. |
Extension | Preview |
| az quantum workspace keys |
Gérez Azure Quantum clés api d’espace de travail. |
Extension | Preview |
| az quantum workspace keys list |
Répertoriez les clés API pour l’espace de travail donné (ou actuel) Azure Quantum. |
Extension | Preview |
| az quantum workspace keys regenerate |
Régénérez 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épertorier les allocations de quota et les utilisations consommées pour un espace de travail Azure Quantum. |
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 donné (ou actuel) Azure Quantum. |
Extension | Preview |
| az quantum workspace update |
Mettez à jour l’espace de travail Azure Quantum donné (ou actuel). |
Extension | Preview |
| az quantum workspace user |
Gérer les utilisateurs d’un espace de travail Azure Quantum. |
Extension | Preview |
| az quantum workspace user add |
Accordez à un utilisateur l’accès à un espace de travail Azure Quantum. |
Extension | Preview |
| az quantum workspace user list |
Répertoriez les utilisateurs ayant accès à un espace de travail Azure Quantum. |
Extension | Preview |
| az quantum workspace user remove |
Supprimez l'accès d'un utilisateur à un espace de travail Azure Quantum. |
Extension | Preview |
az quantum execute
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
--resource-group
--target-id
--workspace-name
[--acquire-policy-token]
[--change-reference]
[--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 -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 \
-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 \
-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.
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.
Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Global Policy Arguments |
ID de référence de modification associé pour cette opération de ressource.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Global Policy Arguments |
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 des travaux.
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 run
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
--resource-group
--target-id
--workspace-name
[--acquire-policy-token]
[--change-reference]
[--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 -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 \
-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 \
-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.
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.
Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Global Policy Arguments |
ID de référence de modification associé pour cette opération de ressource.
| Propriété | Valeur |
|---|---|
| Groupe de paramètres: | Global Policy Arguments |
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 des travaux.
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 |