Enregistrez vos identifiants de connexion

Si vous travaillez dans un environnement de confiance Python (par exemple sur un ordinateur portable ou un poste de travail personnel), vous pouvez utiliser la méthode save_account() pour enregistrer vos informations d'identification localement, puis les utiliser pour initialiser le service.

Avant de commencer

1. Assurez-vous de travailler dans un environnement Python actif avec le qiskit et les paquets qiskit-ibm-runtime installés.
2. Activez l'environnement virtuel Python et exécutez Python dans votre environnement virtuel.
3. Connectez-vous à IBM Quantum Platform.

Trouvez vos identifiants d'accès

1. Assurez-vous que le bon compte et la bonne région sont sélectionnés dans le sélecteur de compte dans l'en-tête.
2. Trouvez votre clé API. Dans le tableau de bord, créez votre clé API, puis copiez-la dans un endroit sûr afin de pouvoir l'utiliser pour l'authentification. Notez que vous pouvez utiliser la même clé API pour vous connecter à n'importe quelle région.
3. Facultatif : Recherchez l'instance que vous souhaitez utiliser dans la page Instances. Survolez son CRN, cliquez sur l'icône pour le copier, puis sauvegardez-le dans un endroit sûr afin de pouvoir l'utiliser pour identifier l'instance.

Enregistrez vos identifiants d'accès

Enregistrez vos identifiants en exécutant le code correspondant une fois pour chaque compte que vous souhaitez enregistrer. Une fois vos identifiants enregistrés, chargez-les en suivant les étapes décrites dans la section « Initialisation du service de calcul d' IBM Quantum ».

Enregistrer les informations d'identification qui permettent d'accéder à une instance spécifique :

Si vous disposez de plusieurs instances et que vous souhaitez indiquer facilement à Quantum Compute quelle instance utiliser, enregistrez des identifiants comprenant l' CRN de l'instance.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(
  # For `token`, use the 44-character API_KEY you created 
  # and saved from the IBM Quantum Platform Home dashboard:
  token="<your-api-key>", 
  name="<account-name>", # Optional
  instance="<IBM Cloud CRN or instance name>", # Optional
  set_as_default=True, # Optional
  overwrite=True, # Optional
)

Enregistrer les informations d'identification pour la sélection automatique des instances :

Si vous ne fournissez pas d' CRN s d'instance et ne transmettez pas ces identifiants à Quantum Compute, une instance appropriée sera choisie pour vous, en fonction des options spécifiées.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(
  # For `token`, use the 44-character API_KEY you created 
  # and saved from the IBM Quantum Platform Home dashboard:
  token="<your=api-key>", 
  name="<account-name>", # Optional
  instance="<instance-to-use>", # Optional
  plans_preference="<plan_types>", # Optional
  region="<region>", # Optional
  tags="<instance-tags>", # Optional
  set_as_default=True, # Optional
  overwrite=True, # Optional
)

Options disponibles

• token: IBM Cloud Clé API. Votre jeton est confidentiel. Ne partagez pas votre jeton dans un code public.
• instance: Spécifiez éventuellement l'instance à utiliser par le biais de son CRN IBM Cloud ou de son nom d'instance.
• plans_preference: Vous pouvez définir les types de plans à classer par ordre de priorité. Ce point est ignoré si l'instance est spécifiée. Les options disponibles sont open, pay-as-you-go, flex, premium et on-prem. Les instances d'un certain type de régime sont exclues si le nom du régime n'est pas spécifié. Par exemple, si [open] est introduit, seules les instances de plan ouvert sont disponibles. Ce point est ignoré si instance est spécifié.
• region: Permet de définir la région à utiliser. Les valeurs acceptées sont us-east et eu-de. Ce point est ignoré si instance est spécifié.
• tags: Spécifiez éventuellement les balises de l'instance. Accepte une liste de chaînes de noms de balises. Ce point est ignoré si instance est spécifié.
• name: Nom facultatif de cet ensemble d'informations d'identification du compte.
• set_as_default: Réglez la valeur sur True pour enregistrer ces informations d'identification par défaut. Si vous n'enregistrez qu'un seul compte, il est automatiquement défini comme compte par défaut.
• overwrite: Définissez cette valeur sur True pour mettre à jour vos informations d'identification par défaut.

Exemples

Exemple 1

Cet exemple enregistre les informations d'identification pour des instances spécifiques, qui autorisent l'accès libre et l'accès privilégié. Les informations d'identification ouvertes sont définies par défaut.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(token="<API_TOKEN>", 
                                  instance="<CRN_for_premium_instance>",
                                  name="premium")
QiskitRuntimeService.save_account(token="<API_TOKEN>", 
                                  instance="<CRN_for_open_instance>",
                                  name="open", set_as_default=True)

Exemple 2

Cet exemple permet d'enregistrer les identifiants en vue de la sélection automatique d'une instance. Quantum Compute ne prendra en compte que les instances Premium de la région UE disponibles pour le compte. Ces identifiants deviennent la nouvelle valeur par défaut.

QiskitRuntimeService.save_account(
    token="your-api-key",
    set_as_default=True,
    overwrite = True,

    # Set instance "filters" instead of specifying the instance:
    region="eu-de",
    plans_preference=["premium"]
  )

Afficher les identifiants enregistrés

Pour afficher toutes les informations d'identification que vous avez enregistrées, exécutez service.saved_accounts(). Notez que si vous avez enregistré des informations d'identification par défaut sans les nommer, elles sont nommées default-ibm-quantum-platform. Si vous avez nommé vos identifiants par défaut, vous verrez "is_default_account": true dans le résultat.

Considérations

• Si vous enregistrez plusieurs comptes, utilisez le paramètre name pour les différencier.
• Les informations d'identification sont enregistrées sur $HOME/.qiskit/qiskit-ibm.json. Ne modifiez pas manuellement ce fichier.
• Si vous n'enregistrez pas vos identifiants, vous devrez les saisir à chaque fois que vous lancerez une nouvelle session (lors de l'instanciation du service de calcul d' IBM Quantum ).
• Si vous spécifiez manuellement vos informations d'identification, un compte enregistré ne sera pas utilisé.

Etapes suivantes