Saltar al contenido principal

Crear y gestionar instancias

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

Las instancias son servidores virtuales (despliegues de Qiskit Runtime) que gestionan la ejecución de tus cargas de trabajo, incluida la ejecución de programas cuánticos y tareas de cómputo clásico (como el procesamiento de mitigación de errores). Las instancias se identifican por su Cloud Resource Name (CRN). Este CRN se puede usar al enviar cargas de trabajo desde tus programas de Qiskit.

Puedes ver las instancias a las que tienes acceso en el panel de control, o haciendo clic en la pestaña "Instances" desde el panel de control. Cada instancia aparece listada con su identificador CRN.

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

El panel de control de IBM Quantum Platform muestra las instancias a las que tienes acceso. Según tu nivel de acceso, puedes ver los detalles completos, editar y eliminar instancias en la página de Instancias.

Es importante que entiendas qué instancia estás usando, ya que todas las instancias que no están asociadas con el Plan Open generan un costo.

Instancia del Plan Open​

Los usuarios del Plan Open pueden ejecutar circuitos cuánticos en las mejores QPUs del mundo de forma gratuita (hasta 10 minutos de tiempo cuántico por ventana móvil de 28 días). El uso de las QPUs puede consultarse en el panel de control de la Plataforma y en las páginas de Workloads.

Instancia del Plan Pay-As-You-Go​

El Plan Pay-As-You-Go es un plan de pago. Para usar este plan, debes crear una instancia y asignarla al plan. Todas las cargas de trabajo enviadas a las QPUs con este plan generan un cargo.

Los trabajos que ejecutas tú y los trabajos que ejecutan otros colaboradores en la misma instancia cuentan para el uso reportado de esa instancia. Puedes ver el uso de una instancia en la página de Instancias, o, para quienes tengan la autorización adecuada, en la página de Analytics. Ten en cuenta que las páginas pueden mostrar cifras de uso distintas, ya que la página de Instancias muestra el uso en una ventana móvil de 28 días anteriores a la marca de tiempo actual, mientras que la página de Analytics usa límites de día completo.

Si tu administrador ha marcado una instancia como "limitada" (verás una columna "Remaining" en el área de uso) y la instancia supera su asignación (definida por tu administrador) dentro de la ventana móvil de 28 días, cualquier carga de trabajo activa continuará 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 está limitada y supera su asignación, es probable que los trabajos ejecutados con esa instancia se ejecuten con menor prioridad y experimenten tiempos de espera más largos en la cola.

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

Especificar una instancia en tu código​

Puedes usar el CRN o el nombre de la instancia para especificar qué instancia usar, 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 tu código, consulta Inicializar tu cuenta.

Cuando se pasa una instancia, solo están disponibles los backends y trabajos de esa instancia (permitido en Qiskit Runtime v0.40.1 y versiones posteriores).

Si no se incluye una instancia al inicializar el servicio, todos los backends y trabajos de todas las instancias de tu cuenta están disponibles. En ese caso, cuando se especifica un backend, se encuentra y usa una instancia que puede acceder a ese backend, tal como se describe en Selección automática de instancia.

Versiones requeridas

Se requiere Qiskit Runtime v0.40.1 o posterior para lo siguiente:

  • Usar el nombre de la instancia para especificar una instancia
  • No pasar una instancia
  • Establecer un tipo de instancia y región preferidos

Para Qiskit Runtime v0.42 o posterior, los planes gratuitos se priorizan por defecto cuando se usa la selección automática de instancia.

Crear una instancia​

Sigue estos pasos para crear una instancia y añadirla a tu cuenta. Si eres un administrador que necesita configurar Qiskit Runtime en Cloud para tu organización, consulta Planificar Qiskit Runtime para una organización.

  1. Para añadir una instancia a tu cuenta, primero asegúrate de tener la cuenta y la región correctas seleccionadas en el selector de cuentas del encabezado.

    • Puedes tener (o formar parte de) múltiples cuentas de IBM Cloud. Si no ves las instancias o los trabajos que esperas, prueba con una cuenta diferente.
    • Puedes acceder a cualquier región usando la misma clave de API, pero solo puedes ver y acceder a las instancias que se crearon en la región en la que has iniciado sesión.
    • Si quieres crear una instancia Open, debes elegir la región us-east.

    Se muestra el encabezado de IBM Quantum Platform. El selector de cuentas está inmediatamente a la derecha de la barra de búsqueda. El selector de región está inmediatamente a la derecha del selector de cuentas.

    Acerca de las regiones

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

    • Qué QPUs están disponibles.
    • Dónde se realiza el cómputo clásico de los trabajos, como la compilación.
    • Dónde 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ómputo cuántico. No incluyen metadatos, como el número de shots, el tamaño de los circuitos u otras estadísticas de los trabajos.

    Para evitar la exposición de los datos del flujo de trabajo del usuario a una capa global de protección contra Denegación de Servicio Distribuido (DDoS), puedes usar Virtual Private Endpoints. qiskit-ibm-runtime admite esto a través del parámetro private_endpoint.

  2. Desde el panel de Instancias del panel de control, haz clic en Ver todo, o ve a la página de Instancias desde el menú principal.

  3. Desde la página de Instancias, haz clic en Crear instancia.

  4. Selecciona el plan de precios con el que se asocia esta instancia (por ejemplo, Pay-As-You-Go). Según el plan de precios seleccionado, puedes especificar otras opciones, como el límite de costo o el número de minutos a asignar a esta instancia. Ten en cuenta que si esta instancia no está asociada con un plan gratuito, se incurrirá en un costo cuando se use para ejecutar cargas de trabajo.

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

    • Si quieres 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), haz clic en Siguiente.
    • Si no estás configurando una instancia open, puedes personalizar a qué QPUs se puede acceder con esta instancia. Haz clic en el interruptor "Customize allocated compute resources". Selecciona las QPUs específicas a las que esta instancia puede acceder y, a continuación, haz clic en Siguiente.
      nota

      Si personalizas los recursos de cómputo asignados, las QPUs disponibles nunca se actualizarán automáticamente, independientemente de los cambios realizados en el plan padre. Sin embargo, puedes añadir o eliminar QPUs manualmente más adelante. Si no las personalizas, siempre tendrás acceso a cualquier QPU a la que la cuenta tenga acceso en el plan. Por tanto, 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 de grupos de acceso. Se crea automáticamente un grupo de acceso "collaborators" para esta instancia. Los usuarios añadidos a este grupo de acceso pueden usar el tiempo asignado a esta instancia. Puedes modificar o crear grupos de acceso adicionales usando la consola de IBM Cloud. Consulta Configurar grupos de acceso para obtener instrucciones.

  7. Haz clic en Crear instancia. Ahora puedes ver la instancia en la página de Instancias. Si has configurado múltiples planes en tu cuenta, cada tipo de plan tiene su propia pestaña en la tabla de Instancias.

Editar una instancia y su asignación​

Encuentra la instancia en la página de Instancias. Haz clic en el menú de desbordamiento al final de la fila de la instancia y selecciona Editar detalles.

nota

Solo los administradores y propietarios pueden editar la instancia. Consulta la guía Crear políticas de acceso y grupos de acceso para obtener información sobre cómo asignar acceso.

Próximos pasos​

Recomendaciones