Guarda tus credenciales de acceso

Si está trabajando en un entorno de confianza Python (como en un portátil o estación de trabajo personal), puede utilizar el método save_account() para guardar sus credenciales localmente y, a continuación, utilizarlas para inicializar el servicio.

Antes de empezar

1. Asegúrese de que está trabajando en un entorno Python activo con Qiskit SDK y Qiskit Runtime instalados.
2. Active el entorno virtual Python y ejecute Python en su entorno virtual.
3. Inicie sesión en IBM Quantum Platform.

Encuentre sus credenciales de acceso

1. Asegúrese de que la cuenta y la región correctas están seleccionadas en el conmutador de cuentas de la cabecera.
2. Encuentre su clave API. En el panel de control, cree su clave API y cópiela en un lugar seguro para poder utilizarla en la autenticación. Tenga en cuenta que puede utilizar la misma clave API para conectarse a cualquier región.
3. Opcional: Busque la instancia que desea utilizar en la página Instancias. Pase el ratón por encima de su CRN, haga clic en el icono para copiarlo y guárdelo en una ubicación segura para poder utilizarlo para identificar la instancia.

Guarde sus credenciales de acceso

Guarde sus credenciales ejecutando el código adecuado una vez por cada cuenta que desee guardar. Después de guardar sus credenciales, cárguelas siguiendo los pasos descritos en Inicializar el servicio Qiskit Runtime.

Guarde las credenciales que acceden a una instancia específica:

Si tiene varias instancias y desea indicar fácilmente a Qiskit Runtime qué instancia debe utilizar, guarde credenciales que incluyan un CRN de instancia.

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
)

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

Si no proporciona un CRN de instancia y pasa estas credenciales a Qiskit Runtime, se elegirá una instancia adecuada para usted, basándose en las opciones especificadas.

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
)

Opciones disponibles

• token: IBM Cloud Clave API. Su ficha es confidencial. No compartas tu token en código público.
• instance: Opcionalmente especifique la instancia a utilizar a través de su IBM Cloud CRN o nombre de instancia.
• plans_preference: Establece opcionalmente los tipos de planes a 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 introduce [open] sólo estarán disponibles las instancias de Plan abierto. Se ignora si se especifica instance .
• region: Establece opcionalmente la región a utilizar. Los valores aceptados son us-east y eu-de. Se ignora si se especifica instance .
• tags: Especifique opcionalmente las etiquetas de la instancia. Acepta una lista de cadenas de nombres de etiquetas. Se ignora si se especifica instance .
• name: Opcionalmente, asigne un nombre a este conjunto de credenciales de cuenta.
• set_as_default: Establezca el valor en True para guardar estas credenciales como predeterminadas. Si sólo guarda una cuenta, ésta se establecerá automáticamente como predeterminada.
• overwrite: Establezca este valor en True para actualizar sus credenciales predeterminadas.

Ejemplos

Ejemplo 1

Este ejemplo guarda credenciales para instancias específicas, que permiten acceso abierto y premium. Las credenciales abiertas se establecen por defecto.

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 las credenciales para la selección automática de instancias. Qiskit Runtime sólo buscará instancias premium en la región de la UE que estén disponibles para la cuenta. Estas credenciales se convierten en las nuevas por defecto.

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 credenciales guardadas

Para ver todas las credenciales que ha guardado, ejecute service.saved_accounts(). Tenga en cuenta que si guardó las credenciales por defecto y no les puso nombre, se llamarán default-ibm-quantum-platform. Si nombró sus credenciales por defecto, verá "is_default_account": true en la salida.

Consideraciones

• Si guarda varias cuentas, utilice el parámetro name para diferenciarlas.
• Las credenciales se guardan en $HOME/.qiskit/qiskit-ibm.json. No edite manualmente este archivo.
• Si no guarda sus credenciales, deberá especificarlas cada vez que inicie una nueva sesión (instancie el servicio Qiskit Runtime ).
• Si especifica manualmente sus credenciales, no se utilizará una cuenta guardada.

Próximos pasos