Se connecter à votre espace de travail Azure Quantum avec le QDK ou Azure CLI

Si vous disposez d’un espace de travail Azure Quantum, vous pouvez vous connecter à votre espace de travail et envoyer votre code avec le qdk.azure module Python. Le qdk.azure module fournit une Workspace classe qui représente un espace de travail Azure Quantum.

Prérequis

Pour vous connecter à votre espace de travail avec le qdk.azure module, vous avez besoin des éléments suivants :

  • Compte Azure avec un abonnement actif. Si vous n’avez pas de compte Azure, inscrivez-vous gratuitement et inscrivez-vous à un abonnement pay-as-you-go.

  • Un espace de travail Azure Quantum. Si vous n'avez pas d'espace de travail, consultez Créer un espace de travail Azure Quantum.

  • La dernière version du qdk paquet Python avec l’option supplémentaire azure.

    pip install --upgrade "qdk[azure]"
    

Si vous utilisez Azure CLI, mettez à jour vers la dernière version. Pour obtenir des instructions d’installation, consultez :

Se connecter avec une chaîne de connexion

Utilisez un chaîne de connexion pour spécifier les paramètres de connexion à un espace de travail Azure Quantum. Les chaînes de connexion sont utiles dans les scénarios suivants :

  • Vous souhaitez partager l’accès à votre espace de travail avec d’autres personnes qui n’ont pas de compte Azure.
  • Vous souhaitez partager l’accès à votre espace de travail avec d’autres personnes pendant une durée limitée.
  • Vous ne pouvez pas utiliser l’ID Microsoft Entra en raison de stratégies d’entreprise.

Conseil

Chaque espace de travail Azure Quantum a une clé primaire et une clé secondaire, et chaque clé a sa propre chaîne de connexion. Pour permettre aux autres utilisateurs d’accéder à votre espace de travail, partagez la clé secondaire et utilisez la clé primaire uniquement pour vos propres services. Vous pouvez remplacer la clé secondaire sans provoquer de temps d’arrêt dans vos propres services. Pour plus d’informations sur le partage d’accès à votre espace de travail, consultez Partager l’accès à votre espace de travail.

Copier la chaîne de connexion

  1. Connectez-vous au portail Azure.
  2. Accédez à votre espace de travail Azure Quantum.
  3. Dans le panneau de l’espace de travail, développez la liste déroulante Opérations et sélectionnez Clés d’accès.
  4. Activez les clés d’accès pour votre espace de travail. Si le curseur Touches d’accès est défini sur Désactivé, définissez le curseur sur Activé.
  5. Sélectionnez l’icône Copier pour l’chaîne de connexion que vous souhaitez copier. Vous pouvez choisir la chaîne de connexion primaire ou secondaire.

Avertissement

Il s’agit d’un risque de sécurité pour stocker vos clés d’accès de compte ou les chaînes de connexion en texte clair. Stockez vos clés de compte dans un format chiffré ou migrez vos applications pour utiliser l’autorisation Microsoft Entra pour accéder à votre espace de travail Azure Quantum.

Utilisez le chaîne de connexion pour accéder à votre espace de travail Azure Quantum

Utilisez le chaîne de connexion que vous avez copié pour vous connecter à votre espace de travail Azure Quantum avec le qdk.azure module ou l’extension QDK dans Visual Studio Code.

Pour vous connecter à votre espace de travail Azure Quantum, choisissez l’une des méthodes suivantes.

  • Utilisez la from_connection_string fonction pour créer un Workspace objet.

    from qdk.azure import Workspace 
    
    connection_string = "" # Add your connection string
    workspace = Workspace.from_connection_string(connection_string) 
    
    print(workspace.get_targets())
    
  • Stockez votre chaîne de connexion dans une variable d’environnement.

    import os
    from qdk.azure import Workspace 
    
    connection_string = "" # Add your connection string  
    os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 
    
    workspace = Workspace() 
    print(workspace.get_targets()) 
    

Pour plus d’informations sur l’utilisation des clés, consultez Gérer vos clés d’accès.

Important

Si vous désactivez les clés d’accès pour votre espace de travail, vous ne pouvez pas utiliser de chaînes de connexion pour vous connecter à votre espace de travail. Utilisez plutôt des paramètres d’espace de travail pour vous connecter.

Se connecter à votre espace de travail avec des paramètres d’espace de travail

Chaque espace de travail Azure Quantum a un ensemble unique de paramètres que vous pouvez utiliser pour vous connecter à l’espace de travail.

Paramètre Description Utiliser quand vous vous connectez avec
subscription_id ID de l’abonnement Azure. Azure CLI
resource_group Le nom du groupe de ressources Azure. Azure CLI
name Nom de votre espace de travail Azure Quantum. Azure CLI
resource_id ID de ressource Azure de l’espace de travail Azure Quantum. Python

Pour rechercher les paramètres de votre espace de travail, procédez comme suit :

  1. Connectez-vous au portail Azure.
  2. Accédez à votre espace de travail Azure Quantum.
  3. Dans le panneau de votre espace de travail, choisissez Vue d’ensemble.
  4. Développez la liste déroulante Essentials .
  5. Copiez les paramètres dans leurs champs correspondants.

Note

Vérifiez que vous vous connectez au locataire approprié avant de vous connecter à votre espace de travail. Pour plus d’informations sur les locataires, consultez Comment gérer les abonnements Azure avec Azure CLI.

Utiliser des paramètres d’espace de travail pour vous connecter à votre espace de travail Azure Quantum

Pour rester connecté lorsque vous exécutez vos scripts Python, ouvrez un terminal et exécutez la commande Azure CLI suivante. Cette commande définit l’abonnement pour votre espace de travail. Remplacez <subscriptionId> par votre ID d’abonnement.

az account set --subscription <subscriptionId>

Vous pouvez utiliser les paramètres de votre espace de travail pour vous connecter à votre espace de travail Azure Quantum via le qdk.azure module ou via Azure CLI.

Pour vous connecter à votre espace de travail Azure Quantum, choisissez l’une des options suivantes.

  • Spécifiez l’ID de ressource (recommandé) :

    from qdk.azure import Workspace 
    
    workspace = Workspace(resource_id="") # Add the resource ID of your workspace
    
  • Spécifiez l’ID d’abonnement, le groupe de ressources et le nom de l’espace de travail :

    from qdk.azure import Workspace 
    
    workspace = Workspace(  
        subscription_id="", # Add the subscription ID of your workspace
        resource_group="", # Add the resource group of your workspace
        name="" # Add the name of your workspace
        )
    
  • Spécifiez uniquement le nom de l’espace de travail. Cette option peut échouer lorsque vous avez plusieurs espaces de travail portant le même nom dans le même locataire.

    from qdk.azure import Workspace 
    workspace = Workspace(name="") # Add the name of your workspace