Perguntas frequentes: limites e cotas no Azure Quantum

Neste artigo, você encontrará as diretrizes para entender os limites e as cotas no uso de provedores do Azure Quantum.

O que são cotas no Azure Quantum?

As cotas são limites de uso de QPUs definidos targets pelos provedores. As cotas ajudam a evitar excedentes acidentais de custos para o usuário, ao mesmo tempo em que preservam a integridade dos sistemas do provedor.

As cotas são baseadas na seleção do plano do provedor e geralmente podem ser aumentadas com um tíquete de suporte. O uso controlado por cotas não está necessariamente vinculado a um custo ou crédito, mas pode estar correlacionado.

Como as cotas são definidas no Azure Quantum?

No Azure Quantum, os provedores de hardware e software definem e controlam as cotas de suas ofertas. Para obter informações detalhadas sobre cotas, consulte a página de referência de cada provedor.

• Cota de IonQ
• Cota PASQAL
• Cota de Quantinuum

Como posso exibir minha cota restante?

O uso e as cotas do Azure Quantum são medidos em termos da unidade de uso de cada provedor. Alguns provedores não definem cotas e não têm informações de uso a serem exibidas.

Acompanhar cota usando o portal do Azure

1. Entre no portal do Azure usando as credenciais de assinatura do Azure.
2. Selecione seu espaço de trabalho do Azure Quantum.
3. No painel esquerdo, em Operações, vá para a aba Cotas.
4. Veja as cotas consumidas e restantes para cada provedor selecionado. Observe que as informações de cota são exibidas em três colunas.

• Uso do espaço de trabalho: o limite de uso para o espaço de trabalho atual. Cada workspace do Azure Quantum tem um limite de uso.
• Uso da assinatura do Azure: o uso de todos os espaços de trabalho dentro da região e assinatura atuais. Nem todas as cotas são controladas nesse nível.
• Cadência: o período em que sua cota é renovada. Caso seja mensal, o uso é redefinido no dia 1º de cada mês. Se for uma vez, o uso nunca será redefinido.

Acompanhar cota usando a CLI do Azure

Confira suas cotas usando a Interface de Command-Line do Azure (CLI do Azure). Para obter mais informações, consulte Como gerenciar os espaços de trabalho do Quantum com a CLI do Azure.

1. Instale a extensão da CLI do Azurequantum. Abra um prompt de comando e execute o comando a seguir, que também atualizará a extensão se uma versão anterior já estiver instalada.

   az extension add --upgrade -n quantum
   

2. Faça logon no Azure usando suas credenciais. Você verá a lista de assinaturas associadas à sua conta.

   az login
   

3. Especifique a Assinatura que você deseja usar.

   az account set -s <Your subscription ID>
   

4. Selecione o Espaço de Trabalho que você deseja usar. Observe que você também precisa especificar o grupo de recursos e a localização.

   az quantum workspace set \
       -g MyResourceGroup \
       -w MyWorkspace \
       -l MyLocation \
       -o table
   

5. Use o az quantum workspace quotas comando para exibir informações de cotas para o espaço de trabalho selecionado.

   az quantum workspace quotas -o table
   

   | Dimension | Holds | Limit      | Period   | ProviderId | Scope        | Utilization |
   | --------- | ----- | ---------  | -------- | ---------- | ------------ | ----------- |
   | qgs       |  0.0  |  8333334.0 | Infinite | ionq       | Subscription | 33334.0     |
   | hqc       |  0.0  |  800.0     | Infinite | quantinuum | Subscription | 0.0         |
   

   Nesse exemplo, a linha qgs mostra que a conta tem um limite de 8333334 qgs com IonQ, dos quais 33334 qgs foram usados. A conta também tem um limite de 800 HQCs com Quantinuum, dos quais 0 são usados.

A coluna Escopo indica se a cota se refere ao workspace atual ou à assinatura.

• Espaço de Trabalho: a cota é rastreada para um espaço de trabalho individual.
• Assinatura: a cota é rastreada em conjunto para todos os espaço de trabalho na mesma assinatura/região.

A coluna Período indica o período em que a sua cota é renovada.

• Mensalmente: o uso será redefinido no dia 1º de cada mês.
• Infinito: o uso nunca é redefinido (também conhecido como uso único na exibição do Portal do Azure).

Acompanhar cota usando o SDK do Python

1. Instale a versão mais recente da biblioteca doqdk Python.

2. Abra um novo arquivo Python. Crie uma instância de um Workspace objeto, que permite que você se conecte ao workspace que implantou anteriormente no Azure.

   from qdk.azure import Workspace
   
   # Copy the following settings for your workspace
   workspace = Workspace ( 
     resource_id = "", # Add your resource_id 
     location = ""  # Add your workspace location (for example, "westus") 
   )
   

3. Use o método get_quotas para exibir as informações de cotas para o espaço de trabalho selecionado.

   quotas = workspace.get_quotas() 
   

   [{'dimension': 'qgs', 'scope': 'Subscription', 'provider_id': 'ionq', 'utilization': 33334.0, 'holds': 0.0, 'limit': 16666667.0, 'period': 'Infinite'}, 
   
    {'dimension': 'hqc', 'scope': 'Subscription', 'provider_id': 'quantinuum', 'utilization': 0.0, 'holds': 0.0, 'limit': 40.0, 'period': 'Infinite'}, 
   
    {'dimension': 'ehqc', 'scope': 'Subscription', 'provider_id': 'quantinuum', 'utilization': 0.0, 'holds': 0.0, 'limit': 160.0, 'period': 'Infinite'}, 
   
    {'dimension': 'combined_job_hours', 'scope': 'Workspace', 'provider_id': 'Microsoft', 'utilization': 0.0, 'holds': 0.0, 'limit': 20.0, 'period': 'Monthly'}, 
   
    {'dimension': 'combined_job_hours', 'scope': 'Subscription', 'provider_id': 'Microsoft', 'utilization': 0.011701412083333333, 'holds': 0.0, 'limit': 1000.0, 'period': 'Monthly'}]
   

   Nesse exemplo, a linha qgs mostra que a conta tem um limite de 8333334 qgs com IonQ, dos quais 33334 qgs foram usados. O número de trabalhos simultâneos é o número de trabalhos que podem ser enfileirados por workspace a qualquer momento.

O scope item indica se a cota se refere ao workspace atual ou à assinatura.

• Espaço de Trabalho: a cota é rastreada para um espaço de trabalho individual.
• Assinatura: a cota é rastreada em conjunto para todos os espaço de trabalho na mesma assinatura/região.

O period item indica o período em que sua cota é renovada.

• Mensalmente: o uso será redefinido no dia 1º de cada mês.
• Infinito: o uso nunca é redefinido (também conhecido como uso único na exibição do Portal do Azure).

# This gathers usage against quota for the various providers (quota is set at the subscription level).
# Note that a provider may have multiple quotas, such as Quantinuum that limits usage of their Emulator.

rigetti_quota = 0
ionq_quota = 0
quantinuum_hqc_quota = 0
quantinuum_ehqc_quota = 0

rigetti_quota_utilization = 0
ionq_quota_utilization = 0
quantinuum_hqc_quota_utilization = 0
quantinuum_ehqc_quota_utilization = 0

for quota in workspace.get_quotas():
    if (quota['provider_id'] == 'rigetti'):
        rigetti_quota = quota['limit']
        rigetti_quota_utilization = quota['utilization']
    if (quota['provider_id'] == 'ionq'):
        ionq_quota = quota['limit']
        ionq_quota_utilization = quota['utilization']
    if (quota['dimension'] == 'hqc'):
        quantinuum_hqc_quota = quota['limit']
        quantinuum_hqc_quota_utilization = quota['utilization']
    if (quota['dimension'] == 'ehqc'):
        quantinuum_ehqc_quota = quota['limit']
        quantinuum_ehqc_quota_utilization = quota['utilization']

print('Rigetti quota use: ', "{:,}".format(rigetti_quota_utilization), '/', "{:,}".format(rigetti_quota))
print('IonQ quota use:', "{:,}".format(ionq_quota_utilization), '/', "{:,}".format(ionq_quota))
print('Quantinuum HQC quota use:', "{:,}".format(quantinuum_hqc_quota_utilization), '/', "{:,}".format(quantinuum_hqc_quota))
print('Quantinuum eHQC quota use:', "{:,}".format(quantinuum_ehqc_quota_utilization), '/', "{:,}".format(quantinuum_ehqc_quota))

# This gathers usage against quota for the various providers for the current workspace
# As there can be multiple workspaces in a subscription, the quota usage for the workspace is less or equal to usage against quota at the subscription level

amount_utilized_rigetti = 0
amount_utilized_ionq = 0
amount_utilized_quantinuum_hqc = 0
amount_utilized_quantinuum_ehqc = 0

for job in workspace.list_jobs():
    if (job.details.cost_estimate != None):
        for event in job.details.cost_estimate.events:
            if (event.amount_consumed > 0):
                #print(event.amount_consumed, event.dimension_name, 'on', job.details.provider_id)
                if (job.details.provider_id == 'rigetti'):
                    amount_utilized_rigetti += event.amount_consumed
                if (job.details.provider_id == 'ionq'):
                    amount_utilized_ionq += event.amount_consumed

                if (job.details.provider_id == 'quantinuum'):
                    #print(event.amount_consumed, event.dimension_name, 'on', job.details.provider_id)
                    #print(event)
                    if (event.dimension_id == 'hqc'):
                        amount_utilized_quantinuum_hqc += event.amount_consumed
                    else:
                        amount_utilized_quantinuum_ehqc += event.amount_consumed
                        print(job.id, event)


print('Rigetti quota use in current workspace: ', "{:,}".format(amount_utilized_rigetti), '/', "{:,}".format(rigetti_quota))
print('IonQ quota use in current workspace:', "{:,}".format(amount_utilized_ionq), '/', "{:,}".format(ionq_quota))
print('Quantinuum HQC quota use in current workspace:', "{:,}".format(amount_utilized_quantinuum_hqc), '/', "{:,}".format(quantinuum_hqc_quota))
print('Quantinuum eHQC quota use in current workspace:', "{:,}".format(amount_utilized_quantinuum_ehqc), '/', "{:,}".format(quantinuum_ehqc_quota))

Como posso solicitar mais cota?

Você pode solicitar aumentos de cota levantando um tíquete de suporte.

1. Entre no portal do Azure usando as credenciais de assinatura do Azure.

2. Selecione seu espaço de trabalho do Azure Quantum.

3. No painel esquerdo, em Operações, vá para a aba Cotas.

4. Pressione o botão Aumentar na página de cota ou selecione o botão Nova solicitação de suporte no painel lateral do portal.

5. Um tíquete de suporte é aberto. Siga estas etapas para preencher a solicitação.

   1. Descrever o problema como Solicitação de Substituição de Cota do Azure Quantum
   2. Selecione Técnico para o “Tipo de problema”
   3. Selecione a assinatura na qual o espaço de trabalho está
   4. Selecione Todos os serviços
   5. Escolher o Azure Quantum – Versão prévia como o “Tipo de Serviço”
   6. Escolha o espaço de trabalho para o qual você deseja alterar a cota em Recurso
   7. Escolher Outro para o tipo de problema
   8. Avançar para Soluções e, em seguida, novamente para Detalhes
   9. Preencha todos os campos. Para Descrição, inclua o seguinte:
   • Nome do provedor para o qual você deseja alterar as cotas
   • Se você quiser alterar as cotas para o escopo da assinatura ou o escopo do espaço de trabalho
   • Quais cotas você deseja alterar e por quanto
   • Qualquer justificativa para o motivo pelo qual você está aumentando sua cota pode nos ajudar a decidir em alguns casos.

Conteúdo relacionado

• Perguntas frequentes: Noções básicas sobre custos de trabalho e cobrança no Azure Quantum