Salve suas credenciais de login

Se estiver trabalhando em um ambiente Python confiável (como em um laptop ou estação de trabalho pessoal), poderá usar o método save_account() para salvar suas credenciais localmente e, em seguida, usá-las para inicializar o serviço.

Antes de iniciar

1. Certifique-se de que você está trabalhando em um ambiente Python ativo com o Qiskit SDK e Qiskit Runtime instalados.
2. Ative o ambiente virtual Python e execute Python em seu ambiente virtual.
3. Faça login em IBM Quantum Platform.

Encontre suas credenciais de acesso

1. Certifique-se de que a conta e a região corretas estejam selecionadas no alternador de contas no cabeçalho.
2. Encontre sua chave de API. No painel, crie sua chave de API e copie-a em um local seguro para poder usá-la para autenticação. Observe que você pode usar a mesma chave de API para se conectar a qualquer região.
3. Opcional: Localize a instância que você deseja usar na página Instâncias. Passe o mouse sobre o CRN, clique no ícone para copiá-lo e salve-o em um local seguro para que possa usá-lo para identificar a instância.

Salve suas credenciais de acesso

Salve suas credenciais executando o código apropriado uma vez por conta que deseja salvar. Depois de salvar suas credenciais, carregue-as seguindo as etapas em Inicializar o serviço Qiskit Runtime.

Salve as credenciais que acessam uma instância específica:

Se você tiver várias instâncias e quiser informar facilmente ao Qiskit Runtime qual instância usar, salve as credenciais que incluem um CRN de instância.

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
)

Salvar credenciais para seleção automática de instância:

Se você não fornecer um CRN de instância e passar essas credenciais para Qiskit Runtime, uma instância apropriada será escolhida para você, com base nas opções 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
)

Opções disponíveis

• token: IBM Cloud Chave da API. Seu token é confidencial. Não compartilhe seu token em código público.
• instance: Opcionalmente, especifique a instância a ser usada por meio de seu IBM Cloud CRN ou nome da instância.
• plans_preference: Opcionalmente, defina os tipos de planos a serem priorizados. Isso será ignorado se a instância for especificada. As opções disponíveis são open, pay-as-you-go, flex, premium, e on-prem. As instâncias de um determinado tipo de plano são excluídas se o nome do plano não for especificado. Por exemplo, se [open] for passado, somente as instâncias do Open Plan estarão disponíveis. Isso será ignorado se instance for especificado.
• region: Opcionalmente, defina a região a ser usada. Os valores aceitos são us-east e eu-de. Isso será ignorado se instance for especificado.
• tags: Opcionalmente, especifique as tags da instância. Aceita uma lista de cadeias de nomes de tags. Isso será ignorado se instance for especificado.
• name: Opcionalmente, nomeie esse conjunto de credenciais de conta.
• set_as_default: Defina o valor como True para salvá-las como suas credenciais padrão. Se você salvar apenas uma conta, ela será automaticamente definida como padrão.
• overwrite: Defina esse valor como True para atualizar suas credenciais padrão.

Exemplos

Exemplo 1

Este exemplo salva credenciais para instâncias específicas, que permitem acesso aberto e premium. As credenciais abertas são definidas como padrão.

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)

Exemplo 2

Este exemplo salva as credenciais para a seleção automática de instâncias. Qiskit Runtime analisará apenas as instâncias premium na região da UE que estão disponíveis para a conta. Essas credenciais se tornam o novo padrão.

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

visualizar

credenciais salvas

Para visualizar todas as credenciais que você salvou, execute service.saved_accounts(). Observe que, se você salvou as credenciais padrão e não as nomeou, elas terão o nome default-ibm-quantum-platform. Se você nomeou suas credenciais padrão, verá "is_default_account": true na saída.

Considerações

• Se estiver salvando várias contas, use o parâmetro name para diferenciá-las.
• As credenciais são salvas em $HOME/.qiskit/qiskit-ibm.json. Não edite esse arquivo manualmente.
• Se você não salvar suas credenciais, deverá especificá-las sempre que iniciar uma nova sessão (instanciar o serviço Qiskit Runtime ).
• Se você especificar manualmente suas credenciais, uma conta salva não será usada.

Próximas etapas