Créer et gérer des instances

L'accès aux services IBM Quantum Platform est contrôlé par les instances auxquelles vous êtes affecté. Les utilisateurs peuvent appartenir à plusieurs instances.

Les instances sont des serveurs virtuels (déploiements du service de calcul d' IBM Quantum ) qui gèrent l'exécution de vos charges de travail, notamment l'exécution de programmes quantiques et de tâches de calcul classiques (telles que le traitement de l'atténuation des erreurs). Les instances sont identifiées par leur nom de ressource cloud ( CRN ). Cette interface CRN peut être utilisée pour envoyer des charges de travail depuis vos programmes Qiskit.

Vous pouvez voir les instances auxquelles vous avez accès sur le tableau de bord, ou en cliquant sur l'onglet "Instances" depuis le tableau de bord. Chaque instance est répertoriée avec son identifiant CRN.

Vous avez besoin d'une instance différente pour chaque plan de service (tel que Open ou Pay-As-You-Go) que vous utilisez dans chaque région que vous souhaitez utiliser. Le gestionnaire du compte et toute personne disposant d'autorisations suffisantes peuvent créer une instance et définir sa configuration, notamment ses allocations, ses limites d'utilisation, ses ordinateurs quantiques et ses autorisations d'utilisation.

Le tableau de bord d' IBM Quantum Platform s affiche les instances auxquelles vous avez accès. En fonction de vos droits d'accès, vous pouvez afficher tous les détails, modifier et supprimer des instances sur la page Instances.

Il est important que vous sachiez quelle instance vous utilisez, car toutes les instances qui ne sont pas associées à l'offre Open Plan entraînent des frais (ou sont décomptées du temps alloué dans votre forfait).

---

Instance Open Plan

Les utilisateurs d'Open Plan peuvent exécuter gratuitement des circuits quantiques sur les meilleurs processeurs quantiques (QPU) au monde (jusqu'à 10 minutes par période de 28 jours). L'utilisation de la QPU peut être suivie sur le tableau de bord de la plateforme et sur les pages « Workloads ».

---

Instance du plan Pay-As-You-Go

Le forfait Pay-As-You-Go est un forfait payant. Pour utiliser ce plan, vous devez créer une instance et l'affecter au plan. Toutes les charges de travail transmises aux QPU via ce forfait sont facturées. Les instances à paiement à l'utilisation peuvent être soumises à une limite de coût total (facultatif).

---

Instance Flex Plan

Le forfait Flex est un forfait payant. Pour bénéficier de cette offre, vous devez d'abord contacter IBM afin de vous inscrire. Ensuite, créez une instance et affectez-la au plan. Toutes les charges de travail transmises aux QPU via ce forfait sont comptabilisées dans le cadre de votre abonnement.

Un administrateur peut définir une limite d'utilisation pour une instance Flex Plan, qui s'applique pendant toute la durée du contrat. Si une instance a été marquée comme « limitée » par votre administrateur (vous verrez alors apparaître une colonne « Reste » dans la zone d'utilisation) et que cette instance dépasse son allocation (définie par votre administrateur), toutes les charges de travail actives continueront de s'exécuter (y compris les sessions), mais les charges de travail en attente resteront dans la file d'attente jusqu'à ce que davantage de temps soit disponible. Si une instance n'est pas soumise à des limites et qu'elle dépasse son allocation, les tâches exécutées sur cette instance risquent d'être traitées avec une priorité moindre et de subir des temps d'attente plus longs.

Une alerte s'affiche sur l'utilisation d'une instance lorsqu'elle a dépassé son allocation.

---

Instance du forfait Premium

La formule Premium est une formule payante. Pour bénéficier de cette offre, vous devez d'abord contacter IBM afin de vous inscrire. Ensuite, créez une instance et affectez-la au plan. Toutes les charges de travail transmises aux QPU via ce forfait sont comptabilisées dans le cadre de votre abonnement.

Un administrateur peut définir une limite d'utilisation pour une instance du forfait Premium, qui s'applique sur une période de 28 jours glissants. Si une instance a été marquée comme « limitée » par votre administrateur (vous verrez alors apparaître une colonne « Reste » dans la zone d'utilisation) et que cette instance dépasse son allocation (définie par votre administrateur), toutes les charges de travail actives continueront de s'exécuter (y compris les sessions), mais les charges de travail en attente resteront dans la file d'attente jusqu'à ce que davantage de temps soit disponible. Si une instance n'est pas soumise à des limites et qu'elle dépasse son allocation, les tâches exécutées sur cette instance risquent d'être traitées avec une priorité moindre et de subir des temps d'attente plus longs.

Une alerte s'affiche sur l'utilisation d'une instance lorsqu'elle a dépassé son allocation.

---

Spécifiez une instance dans votre code

Vous pouvez utiliser le CRN ou le nom de l'instance pour spécifier l'instance à utiliser, que ce soit lors de l'initialisation du service ou lors de l'envoi de la charge de travail vers un QPU (par exemple, avec \QiskitRuntimeService.backend() `). Pour savoir comment spécifier une instance dans votre code, consultez la section « Initialiser votre compte ».

Lorsqu'une instance est transmise, seuls les backends et les tâches de cette instance sont disponibles (autorisé dans v0.40.1qiskit-ibm-runtime et versions ultérieures).

Si une instance n'est pas incluse lors de l'initialisation du service, tous les backends et tous les travaux de toutes les instances de votre compte sont disponibles. Dans ce cas, lorsqu'un backend est spécifié, une instance pouvant accéder au backend est recherchée et utilisée comme décrit dans Sélectionner automatiquement l'instance.

---

Créer une instance

Suivez ces étapes pour créer une instance et l'ajouter à votre compte. Si vous êtes un administrateur chargé de configurer Quantum Compute on Cloud pour votre organisation, consultez la section « Planifier Quantum Compute pour une organisation ».

1. Pour ajouter une instance à votre compte, assurez-vous d'abord que vous avez sélectionné le bon compte et la bonne région dans le sélecteur de compte situé dans l'en-tête.

   • Vous pouvez avoir (ou faire partie de) plusieurs comptes IBM Cloud. Si vous ne voyez pas les instances ou les travaux que vous attendez, essayez un autre compte.
   • Vous pouvez accéder à l'une ou l'autre région en utilisant la même clé API, mais vous ne pouvez voir et accéder qu'aux instances qui ont été créées dans la région à laquelle vous êtes connecté.
   • Si vous voulez créer une instance Open, vous devez choisir la région us-east.

   

   A propos des régions

   L'instance sera créée dans la région sélectionnée. Cette région détermine ces caractéristiques importantes :

   • Quels sont les QPU disponibles.
   • Lieu où s'effectue le calcul classique des tâches, comme la compilation.
   • Lieu où sont conservées les données relatives au flux de travail de l'utilisateur.

   Les données du flux de travail comprennent les circuits d'entrée, les paramètres des circuits et les résultats du calcul quantique. Il n'inclut pas les métadonnées, telles que le nombre de prises de vue, la taille des circuits ou d'autres statistiques sur le travail.

   Pour éviter que les données relatives au flux de travail de l'utilisateur ne soient exposées à une couche de protection globale contre le déni de service distribué, vous pouvez utiliser des points d'extrémité privés virtuels (Virtual Private Endpoints ). qiskit-ibm-runtime prend en charge cette fonction par le biais du paramètre private_endpoint .

2. Dans le volet Instances du tableau de bord, cliquez sur Afficher tout ou accédez à la page Instances à partir du menu principal.

3. Dans la page Instances, cliquez sur Créer une instance.

   • Saisissez un nom et ajoutez éventuellement des balises.
   • Si vous avez accès à plus d'un groupe de ressources dans IBM Cloud®, vous pouvez choisir de changer le groupe de ressources auquel cette instance appartient. Pour plus d'informations, voir Gérer les groupes de ressources et Donner accès aux ressources dans les groupes de ressources.

4. Sélectionnez le forfait auquel cette instance est associée (par exemple, « Pay-As-You-Go »). En fonction de la formule tarifaire choisie, vous pouvez définir d'autres options, telles que la limite de coût ou le nombre de minutes à attribuer à cette instance. Veuillez noter que si cette instance n'est pas associée à une formule gratuite, son utilisation pour exécuter des charges de travail entraînera des frais.

5. Cliquez sur Suivant. La liste des QPU auxquelles l'instance peut accéder est affichée.

   • Si vous voulez que l'instance ait accès à toutes les QPU listées (et à toutes les QPU ajoutées à ce plan dans le futur), cliquez sur Suivant.
   • Si vous ne mettez pas en place une instance ouverte, vous pouvez personnaliser les QPU accessibles avec cette instance. Cliquez sur le bouton "Personnaliser les ressources informatiques allouées". Sélectionnez les QPU spécifiques auxquels cette instance peut accéder, puis cliquez sur Suivant.
     Note

     Si vous personnalisez les ressources de calcul allouées, les QPU disponibles ne seront jamais mises à jour automatiquement, quelles que soient les modifications apportées au plan parent. Toutefois, vous pouvez ajouter ou supprimer manuellement des QPU ultérieurement. Si vous ne les personnalisez pas, vous aurez toujours accès à toutes les QPU auxquelles le compte a accès sur le plan. Ainsi, si à l'avenir une nouvelle QPU est ajoutée au plan, l'instance y aura automatiquement accès.

6. Le volet du groupe Accès s'ouvre. Un groupe d'accès « collaborateurs » est automatiquement créé pour cette instance. Les utilisateurs ajoutés à ce groupe d'accès peuvent utiliser le temps alloué à cette instance. Vous pouvez modifier ou créer des groupes d'accès supplémentaires à l'aide de la console IBM Cloud. Consultez la section Configuration des groupes d'accès pour obtenir des instructions.

7. Cliquez sur Créer une instance. Vous pouvez maintenant visualiser l'instance sur la page Instances. Si vous avez configuré plusieurs plans sur votre compte, chaque type de plan possède son propre onglet dans le tableau Instances.

---

Modifier une instance et son allocation

Trouvez l'instance sur la page Instances. Cliquez sur le menu déroulant au bout de la ligne de l'instance et sélectionnez Modifier les détails.

---

Instances archivées

Une instance archivée résulte de l'un des scénarios suivants.

Un utilisateur privilégié a archivé le compte

Un utilisateur disposant des privilèges suffisants pour le compte a archivé l'instance.

• Toutes les tâches en attente dans l'instance sont annulées.
• Les instances archivées apparaissent dans une section distincte intitulée « Archive » sur la page Instances.
• Les emplois peuvent toujours être récupérés.
• Les utilisateurs ne peuvent pas soumettre de nouvelles tâches à l'instance archivée.
• L'instance archivée n'est pas prise en compte dans l'allocation de votre forfait.
• Un utilisateur disposant des privilèges suffisants peut réactiver à tout moment une instance qu'il a archivée (ou qu'un autre utilisateur privilégié a archivée).

Pour archiver une instance que vous gérez, rendez-vous sur la page Instances. À la fin de la ligne correspondant à cette instance, cliquez sur le menu déroulant à trois points situé à droite, puis sélectionnez Archiver l'instance.

Le compte n'a plus accès au plan de l'instance

Le compte n'a plus accès au plan dans le cadre duquel l'instance a été créée.

• Les instances archivées apparaissent dans une section distincte intitulée « Archive » sur la page Instances.
• Les emplois peuvent toujours être récupérés.
• Les utilisateurs ne peuvent pas soumettre de nouvelles tâches à l'instance archivée.
• L'instance archivée n'est pas prise en compte dans l'allocation de votre forfait.
• Les instances qui ont été archivées parce qu'elles ne sont plus visibles dans le plan de l'instance ne peuvent pas être réactivées.

---

Etapes suivantes