Saltar al contenido principal

Guardar tus credenciales de acceso

Si trabajas en un entorno Python de confianza (como tu laptop personal o una estación de trabajo), puedes usar el método save_account() para guardar tus credenciales localmente y luego usarlas para inicializar el servicio.

Notas

Antes de empezar​

  1. Asegúrate de tener una cuenta de IBM Cloud.
  2. Asegúrate de estar trabajando en un entorno Python activo con el SDK de Qiskit y Qiskit Runtime instalados.
  3. Activa el entorno virtual de Python y ejecuta Python dentro de ese entorno.
  4. Inicia sesión en IBM Quantum Platform con una cuenta IBMid o Google.

Encontrar tus credenciales de acceso​

  1. Asegúrate de que la cuenta y la región correctas estén seleccionadas en el selector de cuentas del encabezado.
  2. Encuentra tu clave de API. Desde el panel de control, crea tu clave de API, luego cópiala en un lugar seguro para poder usarla en la autenticación. Ten en cuenta que puedes usar la misma clave de API para conectarte a cualquier región.
  3. Opcional: Encuentra la instancia que quieres usar desde la página Instances. Pasa el cursor sobre su CRN, haz clic en el ícono para copiarlo y guárdalo en un lugar seguro para poder identificar la instancia.

Guardar tus credenciales de acceso​

Guarda tus credenciales ejecutando el código apropiado una vez por cada cuenta que quieras guardar. Después de guardarlas, cárgalas siguiendo los pasos en Inicializar el servicio Qiskit Runtime.

Guardar credenciales que acceden a una instancia específica:​

Si tienes varias instancias y quieres indicarle fácilmente a Qiskit Runtime cuál usar, guarda credenciales que incluyan el CRN de una instancia.

from qiskit_ibm_runtime import QiskitRuntimeService

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

Guardar credenciales para la selección automática de instancia:​

Si no proporcionas un CRN de instancia y pasas estas credenciales a Qiskit Runtime, se elegirá automáticamente una instancia adecuada según las opciones especificadas.

from qiskit_ibm_runtime import QiskitRuntimeService

QiskitRuntimeService.save_account(
  token="<your-api-key>", # Use the 44-character API_KEY you created and saved from the IBM Quantum Platform Home dashboard
  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
)

Opciones disponibles​

  • token: Clave de API de IBM Cloud. Tu token es confidencial. No compartas tu token en código público.
  • instance: Opcionalmente, especifica la instancia a usar mediante su CRN de IBM Cloud o nombre de instancia.
  • plans_preference: Opcionalmente, establece los tipos de planes que se deben priorizar. Se ignora si se especifica la instancia. Las opciones disponibles son open, pay-as-you-go, flex, premium y on-prem. Las instancias de un determinado tipo de plan se excluyen si no se especifica el nombre del plan. Por ejemplo, si se pasa [open], solo estarán disponibles las instancias del Plan Open. Se ignora si se especifica instance.
  • region: Opcionalmente, establece la región a usar. Los valores aceptados son us-east y eu-de. Se ignora si se especifica instance.
  • tags: Opcionalmente, especifica las etiquetas de la instancia. Acepta una lista de cadenas de nombres de etiquetas. Se ignora si se especifica instance.
  • name: Opcionalmente, asigna un nombre a este conjunto de credenciales de cuenta.
  • set_as_default: Establece el valor en True para guardar estas como tus credenciales predeterminadas. Si guardas solo una cuenta, se establece automáticamente como predeterminada.
  • overwrite: Establece este valor en True para actualizar tus credenciales predeterminadas.

Ejemplos​

Ejemplo 1​

Este ejemplo guarda credenciales para instancias específicas que permiten acceso open y premium. Las credenciales open se establecen como predeterminadas.

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)

Ejemplo 2​

Este ejemplo guarda credenciales para la selección automática de instancia. Qiskit Runtime solo considerará las instancias premium en la región de la UE disponibles para la cuenta. Estas credenciales se convierten en las nuevas predeterminadas.

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"]
  )

Ver las credenciales guardadas​

Para ver todas las credenciales que has guardado, ejecuta service.saved_accounts(). Ten en cuenta que si guardaste credenciales predeterminadas sin asignarles un nombre, se llamarán default-ibm-quantum-platform. Si les asignaste un nombre, verás "is_default_account": true en la salida.

Consideraciones​

  • Si vas a guardar varias cuentas, usa el parámetro name para diferenciarlas.
  • Las credenciales se guardan en $HOME/.qiskit/qiskit-ibm.json. No edites este archivo manualmente.
  • Si no guardas tus credenciales, deberás especificarlas cada vez que inicies una nueva sesión (al instanciar el servicio Qiskit Runtime).
  • Si especificas tus credenciales manualmente, no se usará ninguna cuenta guardada.

Próximos pasos

Recomendaciones