Quote in Amazon Cognito

Amazon Cognito dispone di quote predefinite, precedentemente definite limiti, per il numero massimo di operazioni che possono essere eseguite nell'account. Amazon Cognito dispone anche di quote relative al numero massimo e alle dimensioni massime delle risorse di Amazon Cognito.

Ogni quota Amazon Cognito rappresenta un volume massimo di richieste Regione AWS in una Account AWS. Ad esempio, le app possono effettuare richieste API fino alla frequenza di quota predefinita (RPS) per operazioni UserAuthentication rispetto a tutti i pool di utenti negli Stati Uniti orientali (Virginia settentrionale). Le tue app in Asia Pacifico (Tokyo) possono produrre lo stesso volume di richieste per tutti i tuoi pool di utenti nella propria regione. AWS puoi concedere una richiesta di aumento della quota solo in una regione alla volta. Un aumento della quota nella regione Stati Uniti orientali (Virginia settentrionale) non ha alcun effetto sulla frequenza massima di richiesta nella regione Asia Pacifico (Tokyo).

Informazioni sulle quote di frequenza di richiesta API

Categorizzazione delle quote

Amazon Cognito impone una frequenza massima di richieste per le operazioni API. Per ulteriori informazioni sulle operazioni API rese disponibili da Amazon Cognito, consulta le guide di riferimento alle API per i pool di utenti e i pool di identità. Per i pool di utenti, queste operazioni sono raggruppate in categorie di casi d'uso comuni come UserAuthentication o. UserCreation Per un elenco delle operazioni API dei pool di utenti suddivise per categoria, consultaLe operazioni API del bacino d'utenza di Amazon Cognito e le quote di frequenza delle richieste.

Nella console Service Quotas, puoi monitorare l'utilizzo delle quote per categorie, pool di utenti e pool di identità. Se il tasso di richiesta dei tuoi pool di utenti Amazon Cognito supera o supera una quota, puoi acquistare capacità aggiuntiva. Puoi monitorare l'utilizzo delle quote del pool di utenti per categoria e acquistare gli aumenti delle quote nella console Service Quotas. https://console.aws.amazon.com/servicequotas/home

Le quote di operazione sono definite come il numero massimo di richieste consentite al secondo (RPS) per tutte le operazioni all'interno di una categoria. Il servizio dei bacini d'utenza Amazon Cognito applica quote a tutte le operazioni in ciascuna categoria. Ad esempio, la categoria UserCreation include quattro operazioni: SignUp, ConfirmSignUp, AdminCreateUser e AdminConfirmSignUp. È assegnata con una quota combinata di 50 RPS. Se vengono eseguite più operazioni contemporaneamente, ogni operazione all'interno di questa categoria può richiamare fino a 50 RPS separate o combinate.

Operazioni API del bacino d'utenza di Amazon Cognito con una gestione speciale della frequenza delle richieste

Le quote di operazione sono misurate e applicate per le richieste totali combinate a livello di categoria, ad eccezione delle operazioni AdminRespondToAuthChallenge e RespondToAuthChallenge, in cui vengono applicate regole di gestione speciali.

La UserAuthentication categoria include quattro operazioni nell'API dei pool di utenti di Amazon Cognito:,, e. AdminInitiateAuth InitiateAuth AdminRespondToAuthChallenge RespondToAuthChallenge Inoltre, l'autenticazione degli utenti nell'interfaccia utente ospitata contribuisce a questa quota. Le operazioni InitiateAuth e AdminInitiateAuth sono misurate e applicate per quota di categoria. Le operazioni di corrispondenza RespondToAuthChallenge e AdminRespondToAuthChallenge sono soggette a una quota separata che è tre volte superiore al limite di categoria UserAuthentication. Questa quota elevata soddisfa diverse sfide di autenticazione configurate nelle tue app. La quota è sufficiente a coprire la grande maggioranza dei casi d'uso. Dopo che l'app ha fornito fino a tre risposte alle sfide di autenticazione, le richieste aggiuntive vengono conteggiate ai fini della quota di UserAuthentication categoria. Multi-factor l'autenticazione (MFA) , l'autenticazione del dispositivo e l'autenticazione personalizzata sono tutti esempi di prompt di sfida che potresti inserire nel tuo pool di utenti.

Ad esempio, se la tua quota per la UserAuthentication categoria è di 80 RPS, puoi chiamare RespondToAuthChallenge o AdminRespondToAuthChallenge a una tariffa fino a 240 RPS (3 * 80 RPS). Se il tuo pool di utenti richiede quattro round di sfida per autenticazione e 70 utenti accedono al secondo, il totale RespondToAuthChallenge è 280 RPS (70 x 4), ovvero 40 RPS in più rispetto alla quota. Il valore di 40 RPS extra viene aggiunto a 70 chiamate InitiateAuth, rendendo l'utilizzo totale della categoria UserAuthentication 110 RPS (40 + 70). Poiché questo valore supera di 30 RPS la quota di categoria fissata a 80 RPS, Amazon Cognito limita le richieste provenienti dalla tua app.

Utenti mensili attivi

Quando Amazon Cognito calcola la fatturazione del pool di utenti, ti addebita una tariffa per ogni utente attivo mensile (MAU). Considera il numero di MAU attuali e previsti nella pianificazione delle richieste di aumento delle quote. Un utente viene conteggiato come MAU se, entro un mese di calendario, viene eseguita un'operazione di identità correlata a tale utente. Quando colleghi utenti federati a utenti locali, con la federazione SAML o OIDC, l'utente locale verrà conteggiato come MAU di una directory aziendale oEnterpriseMAU, indipendentemente dal fatto che l'utente acceda direttamente o tramite federazione. Per ulteriori informazioni, consulta Prezzi di Amazon Cognito.

Non ti vengono addebitati costi per le sessioni aggiuntive da parte di alcun utente attivo o per gli utenti che non erano attivi entro un mese di calendario. In un mese in cui hai modificato il piano di funzionalità del pool di utenti tra le opzioni disponibili di Lite, Essentials e Plus, la fattura per quel mese viene calcolata sulla base della somma degli utenti attivi mensili (MAU) di ciascun livello, con ogni MAU assegnato al livello assegnato con il prezzo più alto quando l'utente era attivo. Ad esempio:

In questo scenario, l'utente A e l'utente B sono MAU Plus e l'utente C è un MAU Essentials.

Per ulteriori informazioni, consulta Piani di funzionalità del pool di utenti.

Gestione delle quote di frequenza di richiesta API

Identificazione dei requisiti delle quote

Per calcolare i requisiti delle quota, determina quanti utenti attivi interagiranno con l'applicazione in un determinato periodo di tempo. Ad esempio, se prevedi l'accesso medio di un milione di utenti attivi in un periodo di otto ore, sarà necessario essere in grado di autenticare una media di 35 utenti al secondo.

Inoltre, se si suppone che la sessione utente media sia di due ore e che i token siano configurati per scadere dopo un'ora, durante questa sessione di due ore ogni utente dovrà aggiornare una volta i propri token. La quota media richiesta per la categoria UserAuthentication per supportare questo carico è 70 RPS.

Se si suppone un rapporto picco/medio di 3:1 tenendo conto della variazione della frequenza di accesso degli utenti durante il periodo di otto ore, è necessaria la quota UserAuthentication desiderata di 200 RPS.

Ottimizzare i tassi di richiesta per i limiti di quota

Poiché l'aumento dei limiti di tariffa delle API comporta costi aggiuntivi AWS , valuta la possibilità di apportare modifiche al modello di utilizzo prima di richiedere un aumento delle quote. Di seguito sono riportati alcuni esempi di architettura delle app che ottimizza i tassi di richiesta.

Per ulteriori informazioni sull'utilizzo dei tassi di richiesta API in AWS, consulta Gestione e monitoraggio della limitazione delle API nei carichi di lavoro. Per informazioni sull'ottimizzazione delle operazioni di Amazon Cognito che aggiungono costi alla fattura, consulta. AWS Gestione dei costi

Monitoraggio dell'uso delle quote

Amazon Cognito genera CallCount ThrottleCount metriche in Amazon CloudWatch per ogni categoria di operazioni API a livello di account. Puoi utilizzare CallCount per tenere traccia del numero totale di chiamate effettuate dai clienti in relazione a una categoria. Puoi utilizzare ThrottleCount per tenere traccia del numero totale di chiamate limitate relative a una categoria. Puoi utilizzare i parametri CallCount e ThrottleCount con la statistica Sum per contare il numero totale di chiamate in una categoria. Per ulteriori informazioni, consulta le metriche di CloudWatch utilizzo.

Quando si monitorano le quote di servizio, l'utilizzo è la percentuale di una quota di servizio in uso. Ad esempio, se il valore della quota è 200 risorse e 150 risorse sono in uso, l'utilizzo è 75%. L'uso è invece il numero di risorse o operazioni in uso per una quota di servizio.

Monitoraggio dell'utilizzo tramite metriche CloudWatch

Puoi tracciare e raccogliere le metriche di utilizzo dei pool di utenti di Amazon Cognito con. CloudWatch La CloudWatch dashboard mostra le metriche relative a tutto ciò che utilizzi. Servizio AWS Con CloudWatch, puoi creare allarmi metrici per notificarti o modificare una risorsa specifica che stai monitorando. Per ulteriori informazioni sulle CloudWatch metriche, consulta Monitora le metriche di utilizzo CloudWatch .

Monitoraggio dell'utilizzo tramite i parametri Service Quotas

I pool di utenti di Amazon Cognito sono integrati con Service Quotas, un'interfaccia di console per visualizzare e gestire l'utilizzo delle quote di servizio. Nella console Service Quotas, puoi cercare il valore di una quota specifica, visualizzare le informazioni di monitoraggio, richiedere un aumento della quota o impostare allarmi. CloudWatch Dopo che il tuo account è attivo da qualche tempo, puoi visualizzare un grafico dell'utilizzo delle risorse.

La colonna Valore della quota a livello di account applicato nella console Service Quotas per i pool di utenti di Amazon Cognito e i pool di identità di Amazon Cognito mostra la quota corrente. La colonna Utilizzo mostra il tasso attuale di utilizzo della quota. Le quote regolabili di richieste al secondo (RPS) dei pool di utenti di Amazon Cognito ne indicano l'utilizzo attuale. La console Service Quotas può anche indirizzarti verso le CloudWatch metriche per esaminare più da vicino una metrica di quota selezionata. Per ulteriori informazioni sulla visualizzazione delle quote nella console Service Quotas, consulta Visualizzazione di Service Quotas.

Tieni traccia degli utenti attivi mensili (MAU)

Il numero di utenti attivi mensili (MAU) nel tuo pool di utenti fornisce dati importanti alla pianificazione degli aumenti delle quote relative al tasso di richiesta. Puoi confrontare i tassi di richiesta API con il numero di utenti attivi in un determinato periodo di tempo. Con queste conoscenze, puoi calcolare in che modo un aumento degli utenti attivi delle tue applicazioni influirà sulle quote nel tuo modello di utilizzo. Ad esempio, immaginate che la combinazione delle vostre applicazioni negli Stati Uniti occidentali (Oregon) abbia prodotto 2 milioni di utenti attivi in un mese e che la vostra UserAuthentication categoria abbia ricevuto occasionali errori di limitazione alla quota predefinita di 120 richieste al secondo (RPS). Nel mese precedente, prima del successo della campagna pubblicitaria, avevate 1 milione di MAU e le vostre applicazioni non superavano mai gli 80 RPS. Se prevedi un picco simile a seguito di un nuovo spot televisivo, potresti acquistare altri 40 RPS per soddisfare il prossimo milione di utenti con una quota rettificata di 160 RPS.

Per rivedere i tuoi MAU

Accedi alla AWS Billing console e consulta una fattura recente. Nella sezione Addebiti per servizio, puoi filtrare su Cognito per visualizzare una ripartizione dei tuoi MAU per quel periodo di fatturazione.

Richiedere un aumento della quota

Amazon Cognito ha una quota per il numero massimo di operazioni al secondo che puoi eseguire nei tuoi pool di utenti e nei pool di identità di ciascuno. Regione AWS Puoi acquistare un aumento delle quote di frequenza di richiesta API dei pool di utenti Amazon Cognito regolabili. Per le categorie di pool di utenti regolabili, puoi richiedere un limite massimo a livello di account più elevato nelle quote di servizio e quindi utilizzare l'API di provisioning di Amazon Cognito per impostare la tariffa desiderata. Per ulteriori informazioni, consulta Gestione dei limiti assegnati.

Per richiedere un limite massimo a livello di account più elevato, utilizza la console Service Quotas o le operazioni dell'API Service Quotas e. ListAWSDefaultServiceQuotas RequestServiceQuotaIncrease

Gestione dei limiti assegnati

I pool di utenti di Amazon Cognito supportano un modello di quota a due livelli per quote API regolabili. Con questo modello, puoi aumentare o diminuire in modo programmatico la percentuale di richieste assegnate senza contattare l'assistenza. AWS I due livelli funzionano come segue:

Ad esempio, se il limite massimo a UserAuthentication livello di account è di 500 RPS, puoi utilizzare l'operazione UpdateProvisionedLimit API per impostare il limite assegnato a 300 RPS. In un secondo momento, puoi riportare il limite previsto al valore predefinito e ti verrà addebitato solo il tempo in base alla tariffa più elevata.

Gestione dei limiti assegnati nella console

Puoi visualizzare e gestire i limiti assegnati nella console Amazon Cognito. Apri la pagina Pool di utenti e scegli la scheda Limiti assegnati. In questa scheda, puoi visualizzare i limiti attualmente assegnati e i limiti massimi a livello di account per ciascuna categoria di API regolabile. Puoi aumentare o diminuire la tariffa assegnata entro il limite massimo approvato a livello di account.

Operazioni API di provisioning

Amazon Cognito fornisce le seguenti operazioni API per la gestione dei limiti assegnati. Queste operazioni richiedono l'autenticazione e le corrispondenti autorizzazioni IAM.

Entrambe le operazioni utilizzano un LimitDefinition parametro che identifica il limite da gestire. Per i limiti di velocità delle API dei pool di utenti, la definizione del limite ha una classe API_CATEGORY e una mappa degli attributi con la Category chiave. Ad esempio, per gestire il UserAuthentication limite, specifica una definizione di limite con{"Category": "UserAuthentication"}.

{
    "LimitDefinition": {
        "LimitClass": "API_CATEGORY",
        "Attributes": {"Category": "UserAuthentication"}
    }
}

{
    "Limit": {
        "LimitDefinition": {
            "LimitClass": "API_CATEGORY",
            "Attributes": {"Category": "UserAuthentication"}
        },
        "ProvisionedLimitValue": 120,
        "FreeLimitValue": 120
    }
}

{
    "LimitDefinition": {
        "LimitClass": "API_CATEGORY",
        "Attributes": {"Category": "UserAuthentication"}
    },
    "RequestedLimitValue": 300
}

{
    "Limit": {
        "LimitDefinition": {
            "LimitClass": "API_CATEGORY",
            "Attributes": {"Category": "UserAuthentication"}
        },
        "ProvisionedLimitValue": 300,
        "FreeLimitValue": 120
    }
}

Le seguenti azioni IAM controllano l'accesso a queste operazioni:

Flusso di lavoro di provisioning

Il seguente flusso di lavoro descrive come aumentare il limite assegnato.

Considerazioni

Le operazioni API del bacino d'utenza di Amazon Cognito e le quote di frequenza delle richieste

Poiché Amazon Cognito presenta classi di operazioni API sovrapposte con modelli di autorizzazione diversi, ogni operazione appartiene a una categoria. Ogni categoria ha la propria quota in pool per tutte le operazioni API del membro, in tutti i pool di utenti in una Regione AWS nell'account. È possibile richiedere solo l'incremento a quote di categoria regolabili. Per ulteriori informazioni, consulta Richiedere un aumento della quota. Gli adeguamenti della quota si applicano ai pool di utenti nell'account di una singola regione. Amazon Cognito limita le operazioni in alcune categorie³ a 5 richieste al secondo (RPS), per pool di utenti. La quota predefinita (RPS) si applica inoltre a tutti i pool di utenti in un. Account AWS

Le quote delle operazioni di categoria vengono applicate a tutti gli utenti in tutti i pool di utenti all'interno di una Regione AWS. Amazon Cognito mantiene anche una quota per il numero di richieste che l'app può generare rispetto a un singolo utente. È necessario limitare le richieste API per utente come mostrato nella tabella seguente.

Quote frequenza di richiesta per utente di pool di utenti di Amazon Cognito

È necessario limitare le richieste API per categoria come mostrato nella tabella seguente.

Quote frequenza di richiesta per categoria di pool di utenti di Amazon Cognito

¹ A RespondToAuthChallenge o una AdminRespondToAuthChallenge risposta con un NEW_PASSWORD_REQUIRED valore ChallengeName di 0 viene conteggiata nella UserAccountRecovery categoria. Tutte le altre risposte alle sfide vengono conteggiate ai fini della UserAuthentication categoria.

² Ogni accesso gestito o operazione classica dell'interfaccia utente ospitata durante l'accesso contribuisce con una richiesta alla quota. Ad esempio, un utente che accede e fornisce un codice MFA contribuisce con 2 richieste. Il riscatto dei token in concessioni di codici di autorizzazione è soggetto a un'allocazione di quote aggiuntiva alla stessa tariffa della tua quota nella categoria. UserAuthentication

³ Ogni singola operazione in questa categoria è soggetta a un vincolo che impedisce all'operazione di essere chiamata a una velocità superiore a 5 RPS per un singolo pool di utenti.

Limiti di frequenza delle richieste in blocco per i domini dei pool di utenti

Le quote seguenti si applicano al volume complessivo di richieste a un dominio del pool di utenti.

Frequenza delle richieste di operazione API dei pool di identità di Amazon Cognito (identità federate)

¹ La quota predefinita è la quota minima di richiesta per i pool di identità Regione AWS in qualsiasi area del tuo. Account AWS La quota RPS potrebbe essere più alta in alcune regioni.

Quote relative al numero e alla dimensione delle risorse

Le quote delle risorse sono il numero o la dimensione massima di risorse, campi di input, durata temporale e altre funzionalità varie in Amazon Cognito.

È possibile richiedere un adeguamento di alcune quote delle risorse nella console Service Quotas o da un modulo di incremento dei limiti di servizio. Per richiedere un aumento delle quote utilizzando la console Service Quotas, consulta Richiesta di aumento di una quot nella Guida per l'utente di Service Quotas. Se la quota non è disponibile in Service Quotas, utilizza il modulo di incremento dei limiti di servizio.

Le tabelle seguenti indicano le quote delle risorse predefinite e se sono regolabili.

Gli utenti di Amazon Cognito raggruppano le quote di risorse

Le seguenti quote descrivono il numero o la lunghezza massima di elementi che puoi creare nei pool di utenti.

¹ Questa quota potrebbe essere riscontrata nei token di un Trigger Lambda di pre-generazione del token. Il numero di richieste esistenti e aggiunte più gli ambiti dei token di accesso e di identità in una transazione deve sommarsi a un numero inferiore o uguale a questa quota. Le attestazioni e gli ambiti soppressi non contribuiscono a questa quota.

² Questa quota vale solo se utilizzi la funzionalità e-mail predefinita per un pool di utenti di Amazon Cognito. Per un volume di consegna e-mail più elevato, configura il pool di utenti in modo da utilizzare la configurazione e-mail di Amazon SES. Questa restrizione viene ripristinata giornalmente alle 0900 UTC. Per ulteriori informazioni, consulta Impostazioni e-mail per i bacini d'utenza di Amazon Cognito.

Parametri di validità della sessione dei bacini d'utenza di Amazon Cognito

Le quote seguenti descrivono le impostazioni disponibili per la durata degli artefatti di autenticazione e delle sessioni utente nei pool di utenti.

Quote di risorse di sicurezza del codice dei pool di utenti di Amazon Cognito (non modificabili)

Le quote seguenti descrivono i periodi di tempo disponibili relativi ai codici per l'accesso, la registrazione e la reimpostazione della password.

¹ Amazon Cognito valuta i fattori di rischio nella richiesta di aggiornamento delle password e assegna una quota collegata al livello di rischio valutato. Per ulteriori informazioni, consulta Come comportarsi in caso di password dimenticata.

Quote delle risorse dei processi di importazione utenti del pool di utenti di Amazon Cognito

Le quote seguenti descrivono le risorse e i limiti disponibili per i processi di importazione da parte degli utenti.

Quote di risorse dei pool di identità di Amazon Cognito (identità federate)

Le seguenti quote descrivono il numero o la lunghezza massima di elementi che è possibile creare nei pool di identità.

Quote di risorse Amazon Cognito Sync

Le seguenti quote descrivono il numero o la lunghezza massima di elementi che puoi creare in Amazon Cognito Sync.