Google Cloud utilizza le quote per limitare la quantità di una determinata risorsa Google Cloud condivisa che puoi utilizzare. Ogni quota rappresenta una specifica risorsa conteggiabile, come le chiamate API a un particolare servizio, il numero di byte inviati a un determinato servizio o il numero di connessioni in modalità flusso utilizzate contemporaneamente dal tuo progetto.
Molti servizi presentano inoltre limiti non correlati al sistema di quote. Si tratta di vincoli fissi, come le dimensioni massime dei messaggi o il numero di risorse Pub/Sub che puoi creare in un progetto, che non può essere aumentato o diminuito.
Visualizza e gestisci le quote
Per un determinato progetto, puoi utilizzare la dashboard delle quote di IAM e amministrazione per visualizzare i limiti di quota e l'utilizzo attuali. Puoi utilizzare questa dashboard anche per:
- Riduci i limiti di quota
- Avvia un processo per richiedere limiti di quota più elevati
Per ulteriori informazioni sul monitoraggio e sugli avvisi sull'utilizzo della quota, consulta Monitoraggio.
Attribuzione dell'utilizzo della quota
Per la velocità effettiva del sottoscrittore di tipo push, l'utilizzo delle quote viene addebitato a carico del progetto che contiene la sottoscrizione push. Si tratta del progetto visualizzato nel nome della sottoscrizione.
Per tutte le altre quote, l'utilizzo è addebitato in base al progetto associato alle credenziali specificate nella richiesta. L'utilizzo della quota non viene addebitato al progetto che contiene la risorsa richiesta.
Ad esempio, se un account di servizio del progetto A invia una richiesta di pubblicazione per pubblicare in un argomento del progetto B, la quota viene addebitata al progetto A.
In alcuni casi, potresti volere che l'utilizzo della quota venga addebitato a fronte di un altro progetto. Puoi utilizzare il parametro di sistema X-Goog-User-Project per modificare il progetto per l'attribuzione della quota. Per saperne di più su X-Goog-User-Project, consulta Parametri di sistema.
Puoi utilizzare gcloud CLI per impostare il progetto per l'attribuzione della quota per una richiesta specifica. L'interfaccia a riga di comando gcloud invia
l'intestazione della richiesta X-Goog-User-Project.
Devi avere il ruolo roles/serviceusage.serviceUsageConsumer o un ruolo personalizzato con l'autorizzazione serviceusage.services.use per il progetto che utilizzerai per l'attribuzione della quota.
L'esempio seguente mostra come ottenere un elenco di sottoscrizioni nel progetto RESOURCE_PROJECT addebitando la quota Operazioni dell'amministratore sul progetto QUOTA_PROJECT. Esegui questo comando nel terminale Google Cloud CLI:
gcloud pubsub subscriptions list --project=
RESOURCE_PROJECT --billing-project=
QUOTA_PROJECT
Sostituisci QUOTA_PROJECT con l'ID del progetto Google Cloud di cui vuoi addebitare la quota.
Tieni presente che in Pub/Sub, il progetto fatturato è sempre quello che contiene la risorsa. Puoi modificare il progetto solo per l'attribuzione della quota.
Quote di Pub/Sub
Le quote elencate nella tabella seguente possono essere visualizzate e modificate in base al progetto nella dashboard delle quote di API e servizi.
Le quote per regioni sono suddivise in tre tipi:
- Regioni di grandi dimensioni:
europe-west1,europe-west4,us-central1,us-east1,us-east4,us-west1,us-west2 - Regioni di medie dimensioni:
asia-east1,asia-northeast1,asia-southeast1,europe-west2,europe-west3 - Aree geografiche di piccole dimensioni: tutte le altre
Le quote di consegna "exactly-once" sono specifiche per regione. Verifica i dettagli relativi a ogni regione nella tabella seguente.
| Quota | Limite di quota predefinito | Descrizione |
|---|---|---|
| Velocità effettiva del publisher per regione |
|
L'utilizzo della quota si basa sulle dimensioni dei
Tieni presente che in una singola richiesta di pubblicazione possono essere inclusi più messaggi e che non è previsto alcun addebito di quota aggiuntiva per messaggio. |
| Velocità effettiva sottoscrittore di tipo pull per area geografica |
|
L'utilizzo della quota si basa sulle dimensioni dei
|
| Velocità effettiva Acknowledger per area geografica |
|
L'utilizzo della quota si basa sulle dimensioni delle richieste
|
| Velocità effettiva di push e di sottoscrittore di esportazione per regione |
|
Per le richieste di consegna push inviate all'endpoint push, l'utilizzo della quota si basa sulle dimensioni dei |
| Velocità effettiva sottoscrittore StreamingPull per regione |
|
L'utilizzo della quota si basa sulle dimensioni dei flussi di dati di
Tieni presente che le librerie client utilizzano operazioni StreamingPull quando possibile. |
| Numero di connessioni StreamingPull aperte per regione |
|
Il numero di connessioni StreamingPull aperte in un determinato momento. Vedi StreamingPull. |
| Operazioni dell'amministratore | 6000 al minuto (100 operazioni/s) |
Ogni operazione dell'amministratore, ad esempio GetTopicRequest, addebita un'unità a questa quota.
|
| Numero di messaggi utilizzati dalle iscrizioni con consegna "exactly-once abilitata per regione |
|
L'utilizzo della quota si basa sul numero di
|
| Numero di messaggi confermati o la cui scadenza è estesa quando si utilizzano sottoscrizioni con consegna "exactly-once abilitata per regione |
|
L'utilizzo della quota si basa sul numero di ID di conferma nelle richieste
|
Unità per le quote di velocità effettiva
L'utilizzo delle quote di velocità effettiva viene misurato in unità da 1 kB. 1 kB corrisponde a 1000 byte. Ad
esempio, in un PublishRequest con 105 messaggi di 50 byte ciascuno, la dimensione
dei dati utente è 105 * 50 bytes = 5250 bytes, quindi l'utilizzo della quota è
max(1kB, ceil(5250 bytes/1000)) = 6kB.
Limiti delle risorse
| Risorsa | Limiti |
|---|---|
| Progetto |
10.000 argomenti 10.000 sottoscrizioni collegate o scollegate 5000 snapshot 10.000 schemi |
| Argomento |
10.000 sottoscrizioni collegate 5000 snapshot allegati Se è configurata la conservazione dei messaggi degli argomenti, i messaggi pubblicati in un argomento possono essere conservati in uno spazio di archiviazione permanente per un massimo di 31 giorni dalla data di pubblicazione. |
| Partecipazione |
Per impostazione predefinita, conserva i messaggi non confermati in un archivio permanente per 7 giorni dalla data di pubblicazione. Non sono previsti limiti sul
numero di messaggi conservati. Se gli abbonati non utilizzano un abbonamento, quest'ultimo scade. Il periodo di scadenza predefinito è 31 giorni. |
| Schema | Dimensioni dello schema (campo definition): 50 kBRevisioni per schema: 20 |
| Richiesta di pubblicazione |
10 MB (dimensioni totali) 1000 messaggi |
| Message |
Dimensioni messaggio (campo data): 10 MBAttributi per messaggio: 100 Dimensioni chiave attributo: 256 byte Dimensioni valore attributo: 1024 byte |
| Flussi StreamingPull | 10 MB/s per flusso aperto |
| Risposta Pull unaria |
Numero massimo di messaggi nella risposta Pull: 1000 Dimensione massima della risposta Pull: 10 MB |
| Messaggi Pull/StreamingPull | Il servizio potrebbe imporre limiti al numero totale di messaggi StreamingPull in sospeso per connessione. Se incontri questi limiti, aumenta la frequenza con cui confermi i messaggi e il numero di connessioni utilizzate. |
| Richieste Conferma e ModificaAckDeadline |
512 kB (dimensioni totali) |
| Ordine chiavi | Se i messaggi hanno chiavi di ordinamento, la velocità effettiva massima dell'editore è di 1 Mbps per ogni chiave di ordinamento. |
Usa un account di servizio per quote più elevate
Se utilizzi lo strumento gcloud di Google Cloud CLI con un normale account utente (ovvero un account non di servizio), le operazioni Pub/Sub sono limitate a una frequenza adatta per le operazioni manuali. Le frequenze che superano questo limite generano l'errore RESOURCE_EXHAUSTED. La soluzione consiste nell'utilizzare le credenziali dell'account di servizio. Se vuoi utilizzare le credenziali di gcloud CLI per l'automazione, attiva un account di servizio per le operazioni Pub/Sub.
Usa gli endpoint basati sulla posizione per instradare le richieste
Se disponi di una quota aggiuntiva in determinate regioni, puoi instradare le richieste a queste regioni utilizzando gli endpoint Pub/Sub località. Quando pubblichi messaggi in un endpoint globale, il servizio Pub/Sub potrebbe instradare il traffico verso un'area geografica che non dispone di quota sufficiente.
Quote non corrispondenti
I casi di quote non corrispondenti possono verificarsi quando i messaggi pubblicati o ricevuti sono di dimensioni inferiori ai 1000 byte, Ad esempio:
Se pubblichi 10 messaggi da 500 byte in richieste distinte, l'utilizzo della quota del publisher sarà di 10.000 byte. Questo perché i messaggi di dimensioni inferiori ai 1000 byte vengono automaticamente arrotondati per eccesso all'incremento di 1000 byte successivo.
Se ricevi questi 10 messaggi in una singola risposta pull, l'utilizzo della quota di sottoscrittore potrebbe essere solo di 5 kB, poiché le dimensioni effettive di ogni messaggio vengono combinate per determinare la quota complessiva.
Questo è vero anche in caso contrario. L'utilizzo della quota di sottoscrittore potrebbe essere maggiore dell'utilizzo della quota di publisher se pubblichi più messaggi in una singola richiesta di pubblicazione o se ricevi i messaggi in richieste di pull separate.