Quanto esta chave gastou e quanto resta
usage responde a «posso continuar?». Devolve o custo acumulado desta chave, o do seu workspace num período, quanto custou cada armazenamento nesse período e o saldo pré-pago que condiciona a chamada seguinte.
Contagens
Uma chamada. days define o período dos números de workspace e de armazenamento; o número da própria chave é acumulado e não muda com ele.
u = mem.usage(days=7)
# {"window_days": 7, "key": {"requests": 26, "cost_cents": 1.19, …}, …}
if u["balance_cents"] <= 0:
# top up before the next write| Campo | O que significa |
|---|---|
| key | Apenas esta chave — nunca uma lista das outras chaves da conta. since é sempre "lifetime". |
| workspace | O workspace a que esta chave pertence, no período pedido. |
| stores | Gasto por armazenamento no período, do maior para o menor, no máximo 50 linhas. other é o balde de excedente quando uma conta mede mais de 200 armazenamentos distintos num dia, não um armazenamento real. |
| balance_cents | Saldo pré-pago que resta na conta. Negativo significa a descoberto. |
| expiring_soon_cents | Do que resta, quanto expira dentro de 90 dias. |
| days | Período dos números de workspace e armazenamento. 1–365, predefinição 7. Fora do intervalo é limitado em vez de recusado. |
Gratuito, como qualquer chamada Won: sem custo de tokens, sem taxa por pedido, e ignora a verificação de saldo — uma conta a zero tem de poder saber porquê. Dez por minuto neste endpoint e 300 por hora partilhadas por todas as chamadas Won da conta.