Crear y gestionar instancias

El acceso a los servicios de IBM Quantum Platform está controlado por las instancias a las que está asignado. Los usuarios pueden pertenecer a varias instancias.

Las instancias son servidores virtuales (despliegues de Qiskit Runtime ) que gestionan la ejecución de sus cargas de trabajo, incluida la ejecución de programas cuánticos y tareas informáticas clásicas (como la mitigación de errores de procesamiento). Las instancias se identifican por su Nombre de Recurso en la Nube (CRN). Este CRN se puede utilizar al enviar cargas de trabajo desde sus programas Qiskit.

Puede ver las instancias a las que tiene acceso en el panel de control o haciendo clic en la pestaña "Instancias" del panel de control. Cada instancia aparece con su identificador CRN.

Necesita una instancia diferente para cada plan de servicio (como Open o Pay-As-You-Go) que utilice en cada región que desee utilizar. El administrador de la cuenta y cualquier persona con permisos suficientes pueden crear una instancia y definir su configuración, como sus asignaciones, límites de uso, ordenadores cuánticos y permisos de usuario.

El panel de control de IBM Quantum Platform muestra las instancias a las que tiene acceso. Dependiendo de su acceso, puede ver todos los detalles, editar y eliminar instancias en la página Instancias.

Es importante que sepas qué instancia estás utilizando, ya que todas las instancias que no estén asociadas al plan Open Plan tienen un coste (o se descuentan del tiempo asignado a tu plan).

---

Instancia de plan abierto

Los usuarios de Open Plan pueden ejecutar circuitos cuánticos en las mejores QPU del mundo de forma gratuita (hasta 10 minutos por cada periodo de 28 días). El uso de la QPU se puede consultar en el panel de control de la plataforma y en las páginas de cargas de trabajo.

---

Instancia del plan de pago por uso

El plan de pago por uso es un plan de pago. Para utilizar este plan, debe crear una instancia y asignársela al plan. Todas las cargas de trabajo enviadas a las QPU mediante este plan conllevan un cargo. Las instancias de pago por uso pueden tener un límite de coste total (opcional).

---

Instancia de Flex Plan

El Plan Flex es un plan de pago. Para utilizar este plan, primero debe ponerse en contacto con IBM para darse de alta. A continuación, crea una instancia y asígnala al plan. Todas las cargas de trabajo enviadas a las QPU mediante este plan se contabilizan en tu suscripción asignada.

Un administrador puede establecer un límite de uso en una instancia del Plan Flex que se aplicará durante toda la vigencia del contrato. Si el administrador ha marcado una instancia como «limitada» (aparecerá una columna titulada «Restante» en el área de uso) y la instancia supera su asignación (definida por el administrador), cualquier carga de trabajo activa seguirá ejecutándose (incluidas las sesiones), pero las cargas de trabajo pendientes permanecerán en la cola hasta que haya más tiempo disponible. Si una instancia no tiene límites y supera su asignación, es probable que los trabajos que se ejecuten en ella se ejecuten con una prioridad menor y sufran tiempos de espera más largos.

Se muestra una alerta sobre el uso de una instancia cuando ha superado su asignación.

---

Instancia del plan Premium

El Plan Premium es un plan de pago. Para utilizar este plan, primero debe ponerse en contacto con IBM para darse de alta. A continuación, crea una instancia y asígnala al plan. Todas las cargas de trabajo enviadas a las QPU mediante este plan se contabilizan en tu suscripción asignada.

Un administrador puede establecer un límite de uso en una instancia del Plan Premium que se aplica al periodo de uso de 28 días consecutivos del plan. Si el administrador ha marcado una instancia como «limitada» (aparecerá una columna titulada «Restante» en el área de uso) y la instancia supera su asignación (definida por el administrador), cualquier carga de trabajo activa seguirá ejecutándose (incluidas las sesiones), pero las cargas de trabajo pendientes permanecerán en la cola hasta que haya más tiempo disponible. Si una instancia no tiene límites y supera su asignación, es probable que los trabajos que se ejecuten en ella se ejecuten con una prioridad menor y sufran tiempos de espera más largos.

Se muestra una alerta sobre el uso de una instancia cuando ha superado su asignación.

---

Especifique una instancia en su código

Puede utilizar el CRN o el nombre de la instancia para especificar la instancia que desea utilizar, ya sea al inicializar el servicio o al enviar la carga de trabajo a una QPU (por ejemplo, con \QiskitRuntimeService.backend() `). Para obtener instrucciones sobre cómo especificar una instancia en su código, consulte «Inicializar su cuenta ».

Cuando se pasa una instancia, sólo están disponibles los backends y trabajos de esa instancia (permitidos en Qiskit Runtime v0.40.1 y posteriores).

Si no se incluye una instancia al inicializar el servicio, estarán disponibles todos los backends y trabajos de todas las instancias de su cuenta. En este caso, cuando se especifica un backend, se busca una instancia que pueda acceder al backend y se utiliza tal y como se describe en Seleccionar automáticamente la instancia.

---

Crear una instancia

Siga estos pasos para crear una instancia y añadirla a su cuenta. Si usted es un administrador que necesita configurar Qiskit Runtime on Cloud para su organización, consulte Planificar Qiskit Runtime para una organización.

1. Para añadir una instancia a su cuenta, asegúrese primero de que tiene seleccionada la cuenta y la región correctas en el conmutador de cuentas de la cabecera.

   • Puedes tener (o formar parte de) varias cuentas de IBM Cloud. Si no ve las instancias o los trabajos que espera, pruebe con otra cuenta.
   • Puede acceder a cualquiera de las dos regiones utilizando la misma clave API, pero sólo podrá ver y acceder a las instancias creadas en la región en la que haya iniciado sesión.
   • Si desea crear una instancia Open, debe elegir la región Us-East.

   

   Sobre las regiones

   La instancia se creará en la región seleccionada. Esta región determina estas importantes características:

   • Qué QPU están disponibles.
   • Donde tiene lugar la computación clásica de los trabajos, como la compilación.
   • Donde permanecen los datos del flujo de trabajo del usuario.

   Los datos del flujo de trabajo incluyen los circuitos de entrada, los parámetros del circuito y los resultados del cálculo cuántico. No incluye metadatos, como el número de tomas, el tamaño de los circuitos u otras estadísticas de trabajo.

   Para evitar la exposición de los datos del flujo de trabajo del usuario a una capa de protección global de Denegación de Servicio Distribuida, puede utilizar Puntos Finales Privados Virtuales. qiskit-ibm-runtime lo admite a través del parámetro private_endpoint .

2. En el panel Instancias del panel de control, haga clic en Ver todas o vaya a la página Instancias desde el menú principal.

3. En la página Instancias, haga clic en Crear instancia.

   • Introduzca un nombre y, opcionalmente, añada etiquetas.
   • Si tiene acceso a más de un grupo de recursos en IBM Cloud®, puede elegir cambiar el grupo de recursos al que pertenece esta instancia. Para más información, consulte Gestión de grupos de recursos y Dar acceso a recursos en grupos de recursos.

4. Selecciona el plan de precios al que está asociada esta instancia (por ejemplo, «Pago por uso»). Dependiendo del plan de precios seleccionado, puedes especificar otras opciones, como el límite de coste o el número de minutos que se asignarán a esta instancia. Ten en cuenta que, si esta instancia no está asociada a un plan gratuito, se incurrirá en un coste cuando se utilice para ejecutar cargas de trabajo.

5. Pulse Siguiente. Se muestra una lista de las QPUs a las que puede acceder la instancia.

   • Si desea que la instancia tenga acceso a todas las QPUs listadas (y a todas las QPUs que se añadan a este plan en el futuro), haga clic en Siguiente.
   • Si no está configurando una instancia abierta, puede personalizar a qué QPUs se puede acceder con esta instancia. Haga clic en el conmutador "Personalizar los recursos informáticos asignados". Seleccione las QPU específicas a las que puede acceder esta instancia y, a continuación, haga clic en Siguiente.
     Note

     Si personaliza los recursos de computación asignados, las QPUs disponibles nunca se actualizarán automáticamente, independientemente de los cambios realizados en el plan principal. Sin embargo, puedes añadir o eliminar QPUs manualmente más adelante. Si no las personaliza, siempre tendrá acceso a cualquier QPU a la que la cuenta tenga acceso en el plan. Así, si en el futuro se añade una nueva QPU al plan, la instancia tendrá acceso a ella automáticamente.

6. Se abre el panel del grupo Acceso. Se crea automáticamente un grupo de acceso «colaboradores» para esta instancia. Los usuarios añadidos a este grupo de acceso pueden utilizar el tiempo asignado a esta instancia. Puede modificar o crear grupos de acceso adicionales utilizando la consola IBM Cloud. Consulte Configuración de grupos de acceso para obtener instrucciones.

7. Haga clic en Crear instancia. Ahora puede ver la instancia en la página Instancias. Si ha configurado varios planes en su cuenta, cada tipo de plan tiene su propia pestaña en la tabla Instancias.

---

Editar una instancia y su asignación

Busque la instancia en la página Instancias. Haga clic en el menú desplegable situado al final de la fila de la instancia y seleccione Editar detalles.

---

Instancias archivadas

Una instancia archivada es el resultado de uno de los siguientes escenarios.

Un usuario con privilegios ha archivado la cuenta

Un usuario con privilegios suficientes para la cuenta ha archivado la instancia.

• Se cancelan todos los trabajos pendientes en la instancia.
• Las instancias archivadas aparecen en una sección separada denominada «Archivo» en la página Instancias.
• Los trabajos aún se pueden recuperar.
• Los usuarios no pueden enviar nuevos trabajos a la instancia archivada.
• La instancia archivada no cuenta para la asignación de su plan.
• Un usuario con privilegios suficientes puede reactivar en cualquier momento una instancia que él mismo (u otro usuario con privilegios) haya archivado.

Para archivar una instancia que administras, ve a la página Instancias. Al final de la fila correspondiente a esa instancia, haga clic en el menú desplegable de tres puntos situado a la derecha y seleccione Archivar instancia.

La cuenta ya no tiene acceso al plan de la instancia

La cuenta ya no tiene acceso al plan bajo el cual se creó la instancia.

• Las instancias archivadas aparecen en una sección separada denominada «Archivo» en la página Instancias.
• Los trabajos aún se pueden recuperar.
• Los usuarios no pueden enviar nuevos trabajos a la instancia archivada.
• La instancia archivada no cuenta para la asignación de su plan.
• Las instancias que se han archivado porque ya no tienen visibilidad en el plan de la instancia no se pueden reactivar.

---

Próximos pasos