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úrate de que estás trabajando en un entorno Python activo con el qiskit y los paquetes qiskit-ibm-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

Guarda tus credenciales ejecutando el código correspondiente una vez por cada cuenta que quieras guardar. Una vez guardadas tus credenciales, cárgalas siguiendo los pasos que se indican en «Inicializar el servicio de computación de IBM Quantum ».

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

Si tienes varias instancias y quieres indicar fácilmente a Quantum Compute qué instancia debe utilizar, guarda las 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 indicas una instancia CRN ni facilitas estas credenciales a Quantum Compute, se seleccionará una instancia adecuada para ti, en función de 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

En este ejemplo se guardan las credenciales para la selección automática de instancias. Quantum Compute solo tendrá en cuenta las instancias premium de la región de la UE que estén disponibles para la cuenta. Estas credenciales pasan a ser las 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 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 guardas tus credenciales, deberás introducirlas cada vez que inicies una nueva sesión (al crear una instancia del servicio de computació IBM Quantum ).
• Si especifica manualmente sus credenciales, no se utilizará una cuenta guardada.

Próximos pasos