Criar e gerenciar instâncias

O acesso aos serviços do IBM Quantum Platform é controlado pelas instâncias às quais você está atribuído. Os usuários podem pertencer a várias instâncias.

As instâncias são servidores virtuais (implementações de Qiskit Runtime ) que gerenciam a execução de suas cargas de trabalho, incluindo a execução de programas quânticos e tarefas clássicas de computação (como a atenuação de erros de processamento). As instâncias são identificadas por seu nome de recurso na nuvem (CRN). Esse CRN pode ser usado ao enviar cargas de trabalho de seus programas Qiskit.

Você pode ver as instâncias às quais tem acesso no painel ou clicando na guia "Instâncias" no painel. Cada instância é listada com seu identificador CRN.

Você precisa de uma instância diferente para cada plano de serviço (como Open ou Pay-As-You-Go) que você usa em cada região que deseja usar. O gerente da conta e qualquer pessoa com permissão suficiente podem criar uma instância e definir sua configuração, como alocações, limites de uso, computadores quânticos e permissões de usuário.

O painel do IBM Quantum Platform exibe as instâncias às quais você tem acesso. Dependendo do seu acesso, você pode visualizar todos os detalhes, editar e excluir instâncias na página Instâncias.

É importante que você saiba qual instância está usando, pois todas as instâncias que não estejam associadas ao Plano Aberto geram um custo (ou são contabilizadas no tempo alocado do seu plano).

---

Instanciação em plano aberto

Os usuários do Open Plan podem executar circuitos quânticos nas melhores QPUs do mundo gratuitamente (até 10 minutos por período de 28 dias). É possível acompanhar o uso da QPU no painel da Plataforma e nas páginas de Cargas de Trabalho.

---

Instanciação do plano Pay-As-You-Go

O Plano Pay-As-You-Go é um plano pago. Para utilizar este plano, é necessário criar uma instância e atribuí-la ao plano. Todas as cargas de trabalho enviadas às QPUs por meio deste plano estão sujeitas a cobrança. As instâncias com cobrança por uso podem ter um limite de custo total (opcional).

---

Instância do Flex Plan

O Plano Flex é um plano pago. Para utilizar este plano, você deve primeiro entrar em contato com IBM para se inscrever. Em seguida, crie uma instância e atribua-a ao plano. Todas as cargas de trabalho enviadas às QPUs por meio deste plano são contabilizadas na sua assinatura alocada.

Um administrador pode definir um limite de uso para uma instância do Plano Flex, válido durante toda a vigência do contrato. Se uma instância tiver sido marcada como “limitada” pelo seu administrador (você verá uma coluna “Restante” na área de uso) e a instância exceder sua alocação (definida pelo seu administrador), qualquer carga de trabalho ativa continuará em execução (incluindo sessões), mas as cargas de trabalho pendentes permanecerão na fila até que haja mais tempo disponível. Se uma instância não tiver limites e exceder sua alocação, os trabalhos executados nessa instância provavelmente serão executados com prioridade mais baixa e enfrentarão tempos de espera mais longos na fila.

Um alerta é exibido sobre o uso de uma instância quando ela excede sua alocação.

---

Instância do Plano Premium

O Plano Premium é um plano pago. Para utilizar este plano, você deve primeiro entrar em contato com IBM para se inscrever. Em seguida, crie uma instância e atribua-a ao plano. Todas as cargas de trabalho enviadas às QPUs por meio deste plano são contabilizadas na sua assinatura alocada.

Um administrador pode definir um limite de uso para uma instância do Plano Premium, válido para o período de 28 dias consecutivos de uso do plano. Se uma instância tiver sido marcada como “limitada” pelo seu administrador (você verá uma coluna “Restante” na área de uso) e a instância exceder sua alocação (definida pelo seu administrador), qualquer carga de trabalho ativa continuará em execução (incluindo sessões), mas as cargas de trabalho pendentes permanecerão na fila até que haja mais tempo disponível. Se uma instância não tiver limites e exceder sua alocação, os trabalhos executados nessa instância provavelmente serão executados com prioridade mais baixa e enfrentarão tempos de espera mais longos na fila.

Um alerta é exibido sobre o uso de uma instância quando ela excede sua alocação.

---

Especifique uma instância em seu código

Você pode usar o CRN ou o nome da instância para especificar uma instância a ser utilizada — seja ao inicializar o serviço, seja ao enviar a carga de trabalho para uma QPU (por exemplo, com \QiskitRuntimeService.backend() `). Para obter instruções sobre como especificar uma instância em seu código, consulte Inicializar sua conta.

Quando uma instância é passada, somente backends e trabalhos dessa instância ficam disponíveis (permitido em Qiskit Runtime v0.40.1 e posterior).

Se uma instância não for incluída ao inicializar o serviço, todos os back-ends e trabalhos em todas as instâncias da sua conta estarão disponíveis. Nesse caso, quando um backend é especificado, uma instância que pode acessar o backend é encontrada e usada conforme descrito em Selecionar automaticamente a instância.

---

Criar uma instância

Siga estas etapas para criar uma instância e adicioná-la à sua conta. Se você for um administrador que precisa configurar o Qiskit Runtime on Cloud para sua organização, consulte Plan Qiskit Runtime para uma organização.

1. Para adicionar uma instância à sua conta, primeiro verifique se você tem a conta e a região corretas selecionadas no alternador de contas no cabeçalho.

   • Você pode ter (ou fazer parte de) várias contas IBM Cloud. Se você não vir as instâncias ou os trabalhos esperados, tente usar uma conta diferente.
   • Você pode acessar qualquer região usando a mesma chave de API, mas só pode ver e acessar as instâncias que foram criadas na região em que você está conectado.
   • Se quiser criar uma instância Open, você deve escolher a região leste dos EUA.

   É exibido

   Sobre as regiões

   A instância será criada na região selecionada. Essa região determina essas características importantes:

   • Quais QPUs estão disponíveis.
   • Onde a computação clássica dos trabalhos, como a compilação, ocorre.
   • Onde os dados do fluxo de trabalho do usuário permanecem.

   Os dados do fluxo de trabalho incluem os circuitos de entrada, os parâmetros do circuito e os resultados da computação quântica. Ele não inclui metadados, como número de fotos, tamanho dos circuitos ou outras estatísticas de trabalho.

   Para evitar a exposição dos dados do fluxo de trabalho do usuário a uma camada global de proteção contra negação de serviço distribuído, você pode usar os Virtual Private Endpoints. qiskit-ibm-runtime oferece suporte a isso por meio do parâmetro private_endpoint .

2. No painel Instâncias do painel, clique em Exibir tudo ou acesse a página Instâncias no menu principal.

3. Na página Instâncias, clique em Criar instância.

   • Digite um nome e, opcionalmente, adicione tags.
   • Se você tiver acesso a mais de um grupo de recursos em IBM Cloud®, poderá optar por alterar o grupo de recursos ao qual essa instância pertence. Consulte Gerenciamento de grupos de recursos e Concessão de acesso a recursos em grupos de recursos para obter mais informações.

4. Selecione o plano de preços ao qual esta instância está associada (por exemplo, Pagamento conforme o uso). Dependendo do plano de preços selecionado, você pode definir outras opções, como o limite de custo ou o número de minutos a serem alocados a esta instância. Observe que, se esta instância não estiver associada a um plano gratuito, haverá um custo quando ela for utilizada para executar cargas de trabalho.

5. Clique em Avançar. É exibida uma lista das QPUs que a instância pode acessar.

   • Se você quiser que a instância tenha acesso a todas as QPUs listadas (e a todas as QPUs adicionadas a esse plano no futuro), clique em Next (Avançar ).
   • Se você não estiver configurando uma instância aberta, poderá personalizar quais QPUs podem ser acessadas com essa instância. Clique no botão de alternância "Customize allocated compute resources" (Personalizar recursos de computação alocados). Selecione as QPUs específicas que essa instância pode acessar e clique em Next (Avançar ).
     Note

     Se você personalizar os recursos de computação alocados, as QPUs disponíveis nunca serão atualizadas automaticamente, independentemente de quaisquer alterações feitas no plano pai. No entanto, você pode adicionar ou remover QPUs manualmente mais tarde. Se você não as personalizar, sempre terá acesso a qualquer QPU a que a conta tenha acesso no plano. Portanto, se no futuro houver uma nova QPU adicionada ao plano, a instância terá acesso a ela automaticamente.

6. O painel do grupo Acesso é aberto. Um grupo de acesso “colaboradores” é criado automaticamente para esta instância. Os usuários adicionados a este grupo de acesso podem usar o tempo alocado para esta instância. Você pode modificar ou criar grupos de acesso adicionais usando o console IBM Cloud. Consulte Configurando grupos de acesso para obter instruções.

7. Clique em Criar instância. Agora você pode visualizar a instância na página Instâncias. Se você tiver configurado vários planos em sua conta, cada tipo de plano terá sua própria guia na tabela Instances (Instâncias).

---

Editar uma instância e sua alocação

Localize a instância na página Instâncias. Clique no menu de estouro no final da linha da instância e selecione Editar detalhes.

---

Instâncias arquivadas

Uma instância arquivada é o resultado de um dos seguintes cenários.

Um usuário privilegiado arquivou a conta

Um usuário com privilégios suficientes para a conta arquivou a instância.

• Todas as tarefas pendentes na instância são canceladas.
• As instâncias arquivadas aparecem em uma seção separada chamada “Arquivo” na página Instâncias.
• Os trabalhos ainda podem ser recuperados.
• Os usuários não podem enviar novos trabalhos para a instância arquivada.
• A instância arquivada não conta para a alocação do seu plano.
• Um usuário com privilégios suficientes pode reativar uma instância que ele (ou outro usuário privilegiado) arquivou a qualquer momento.

Para arquivar uma instância que você gerencia, acesse a página Instâncias. No final da linha dessa instância, clique no menu de overflow com três pontos à direita e selecione Arquivar instância.

A conta não tem mais acesso ao plano da instância

A conta não tem mais acesso ao plano sob o qual a instância foi criada.

• As instâncias arquivadas aparecem em uma seção separada chamada “Arquivo” na página Instâncias.
• Os trabalhos ainda podem ser recuperados.
• Os usuários não podem enviar novos trabalhos para a instância arquivada.
• A instância arquivada não conta para a alocação do seu plano.
• As instâncias que foram arquivadas porque não têm mais visibilidade no plano da instância não podem ser reativadas.

---

Próximas etapas