Pular para o conteúdo principal

Salve suas credenciais de acesso

Se você está trabalhando em um ambiente Python confiável (como em um laptop pessoal ou estação de trabalho), pode usar o método save_account() para salvar suas credenciais localmente e depois utilizá-las para inicializar o serviço.

Notas

Antes de começar​

  1. Certifique-se de ter uma conta IBM Cloud.
  2. Certifique-se de estar trabalhando em um ambiente Python ativo com o Qiskit SDK e o Qiskit Runtime instalados.
  3. Ative o ambiente virtual Python e execute o Python nesse ambiente.
  4. Faça login na IBM Quantum Platform com uma conta IBMid ou Google.

Encontre suas credenciais de acesso​

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

Salve suas credenciais de acesso​

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

Salvar credenciais que acessam uma instância específica:​

Se você tem várias instâncias e quer informar facilmente ao Qiskit Runtime qual instância usar, salve credenciais que incluam um CRN de instância.

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
)

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

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

Opções disponíveis​

  • token: Chave de API do IBM Cloud. Seu token é confidencial. Não compartilhe seu token em código público.
  • instance: Opcionalmente, especifique a instância a usar pelo seu CRN do IBM Cloud ou nome de instância.
  • plans_preference: Opcionalmente, defina os tipos de planos a priorizar. Isso é ignorado se a instância for especificada. As opções disponíveis são open, pay-as-you-go, flex, premium e on-prem. 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, apenas instâncias do Plano Open estarão disponíveis. Isso é ignorado se instance for especificado.
  • region: Opcionalmente, defina a região a usar. Os valores aceitos são us-east e eu-de. Isso é ignorado se instance for especificado.
  • tags: Opcionalmente, especifique as tags da instância. Aceita uma lista de strings com nomes de tags. Isso é ignorado se instance for especificado.
  • name: Opcionalmente, dê um nome a este conjunto de credenciais de conta.
  • set_as_default: Defina o valor como True para salvar essas credenciais como padrão. Se você salvar apenas uma conta, ela é 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 open e premium. As credenciais open 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 credenciais para seleção automática de instância. O Qiskit Runtime buscará apenas instâncias premium na região da UE 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 credenciais padrão sem nomeá-las, elas recebem o nome default-ibm-quantum-platform. Se você nomeou suas credenciais padrão, verá "is_default_account": true na saída.

Considerações​

  • Se você está 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 este arquivo manualmente.
  • Se você não salvar suas credenciais, precisará especificá-las toda vez que iniciar uma nova sessão (instanciar o serviço Qiskit Runtime).
  • Se você especificar suas credenciais manualmente, uma conta salva não será usada.

Próximos passos

Recomendações