Pular para o conteúdo principal

Criar e gerenciar instâncias

O acesso aos serviços da IBM Quantum Platform é controlado pelas instâncias às quais você está atribuído. Usuários podem pertencer a múltiplas instâncias.

Instâncias são servidores virtuais (implantações do Qiskit Runtime) que gerenciam a execução de suas cargas de trabalho, incluindo a execução de programas quânticos e tarefas de computação clássica (como o processamento de mitigação de erros). As instâncias são identificadas pelo seu Cloud Resource Name (CRN). Esse CRN pode ser usado ao enviar cargas de trabalho a partir dos seus programas Qiskit.

Você pode ver as instâncias às quais tem acesso no painel, ou clicando na aba "Instances" 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 usar em cada região que deseja utilizar. O gerente da conta e qualquer pessoa com permissão suficiente pode 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 da IBM Quantum Platform exibe as instâncias às quais você tem acesso. Dependendo do seu acesso, você pode visualizar detalhes completos, editar e excluir instâncias na página de Instâncias.

É importante que você saiba qual instância está usando, pois todas as instâncias que não estão associadas ao Open Plan geram um custo.

Instância do Open Plan​

Usuários do Open Plan podem executar circuitos quânticos nos melhores QPUs do mundo gratuitamente (até 10 minutos de tempo quântico por janela deslizante de 28 dias). O uso do QPU pode ser acompanhado no painel da Plataforma e nas páginas de Workloads.

Instância do Pay-As-You-Go Plan​

O Pay-As-You-Go Plan é um plano pago. Para usar esse plano, você deve criar uma instância e associá-la ao plano. Todas as cargas de trabalho enviadas aos QPUs usando esse plano geram uma cobrança.

Os jobs que você executa e os jobs executados por outros colaboradores na mesma instância contam para o uso reportado dessa instância. Você pode visualizar o uso de uma instância na página Instances ou, para quem tem a devida autoridade, na página Analytics. Observe que as páginas podem mostrar números de uso diferentes, pois a página de Instância exibe o uso em uma janela deslizante de 28 dias anterior ao timestamp atual, enquanto a página de Analytics utiliza limites de dia completo.

Se uma instância foi marcada como "limitada" pelo seu administrador (você verá uma coluna "Remaining" na área de uso) e a instância ultrapassar sua alocação (definida pelo administrador) dentro da janela deslizante de 28 dias, qualquer carga de trabalho ativa continuará sendo executada (incluindo sessões), mas as cargas de trabalho pendentes permanecerão na fila até que mais tempo esteja disponível. Se uma instância não for limitada e ultrapassar sua alocação, os jobs executados com essa instância provavelmente terão menor prioridade e filas mais longas.

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

Especificar uma instância no seu código​

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

Quando uma instância é informada, somente os backends e jobs dessa instância ficam disponíveis (permitido no Qiskit Runtime v0.40.1 e versões posteriores).

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

Versões necessárias

O Qiskit Runtime v0.40.1 ou posterior é necessário para o seguinte:

  • Usar o nome da instância para especificar uma instância
  • Não informar uma instância
  • Definir um tipo de instância e região preferenciais

Para o Qiskit Runtime v0.42 ou posterior, os planos gratuitos são priorizados por padrão quando a seleção automática de instância é usada.

Criar uma instância​

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

  1. Para adicionar uma instância à sua conta, primeiro certifique-se de que tem a conta e a região corretas selecionadas no seletor de contas no cabeçalho.

    • Você pode ter (ou fazer parte de) várias contas IBM Cloud. Se não encontrar as instâncias ou jobs esperados, tente uma conta diferente.
    • Você pode acessar qualquer região usando a mesma chave de API, mas só pode ver e acessar as instâncias criadas na região em que está logado.
    • Se quiser criar uma instância Open, você deve escolher a região us-east.

    O cabeçalho da IBM Quantum Platform é mostrado. O seletor de conta fica imediatamente à direita da barra de pesquisa. O seletor de região fica imediatamente à direita do seletor de conta.

    Sobre regiões

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

    • Quais QPUs estão disponíveis.
    • Onde ocorre a computação clássica dos jobs, como a compilação.
    • 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 de circuito e os resultados da computação quântica. Não incluem metadados, como número de shots, tamanho dos circuitos ou outras estatísticas de jobs.

    Para evitar a exposição dos dados do fluxo de trabalho do usuário a uma camada global de proteção contra Distributed Denial of Service, você pode usar Virtual Private Endpoints. O qiskit-ibm-runtime oferece suporte a isso por meio do private_endpoint parameter.

  2. No painel, no painel de Instâncias, clique em View all, ou acesse a página Instances pelo menu principal.

  3. Na página de Instâncias, clique em Create instance.

  4. Selecione o plano de preços ao qual essa instância está associada (por exemplo, Pay-As-You-Go). Dependendo do plano de preços selecionado, você pode especificar outras opções, como o limite de custo ou o número de minutos a alocar para essa instância. Observe que, se esta instância não estiver associada a um plano gratuito, um custo será gerado quando ela for usada para executar cargas de trabalho.

  5. Clique em Next. Uma lista dos QPUs que a instância pode acessar é exibida.

    • Se quiser que a instância tenha acesso a todos os QPUs listados (e a todos os QPUs adicionados a este plano no futuro), clique em Next.
    • Se você não estiver configurando uma instância open, pode personalizar quais QPUs podem ser acessados com essa instância. Clique no botão "Customize allocated compute resources". Selecione os QPUs específicos que essa instância pode acessar e clique em Next.
      nota

      Se você personalizar os recursos de computação alocados, os QPUs disponíveis nunca serão atualizados automaticamente, independentemente de quaisquer alterações feitas no plano pai. No entanto, você pode adicionar ou remover QPUs manualmente posteriormente. Se você não os personalizar, sempre terá acesso a qualquer QPU ao qual a conta tenha acesso no plano. Portanto, se no futuro um novo QPU for adicionado ao plano, a instância automaticamente terá acesso a ele.

  6. O painel de grupo de acesso é aberto. Um grupo de acesso "collaborators" é criado automaticamente para essa instância. Os usuários adicionados a esse grupo de acesso podem usar o tempo alocado a essa instância. Você pode modificar ou criar grupos de acesso adicionais usando o console do IBM Cloud. Consulte Setting up access groups para obter instruções.

  7. Clique em Create instance. Agora você pode visualizar a instância na página Instances. Se você configurou vários planos na sua conta, cada tipo de plano tem sua própria aba na tabela de Instâncias.

Editar uma instância e sua alocação​

Encontre a instância na página Instances. Clique no menu de opções no final da linha da instância e selecione Edit details.

nota

Somente administradores e proprietários podem editar a instância. Consulte o guia Criar políticas de acesso e grupos de acesso para informações sobre como atribuir acessos.

Próximos passos​

Recomendações