Panoramica del progetto di quota

Questa pagina definisce l'utilizzo del progetto di quota e le relative modalità determinato. Assicurarsi che il progetto di quota sia impostato correttamente può essere utile evitare richieste non riuscite alle API Google Cloud e inutili errori di quota.

Ogni richiesta a un'API Google Cloud viene conteggiata a fronte di una quota. Poiché le quote sono applicate a ogni progetto, il che significa che ogni richiesta necessita per fornire la quota. Questo progetto viene chiamato progetto quota. È inoltre possibile a volte definito progetto di fatturazione. Il progetto di fatturazione di quota di spazio di archiviazione sono lo stesso progetto. Per saperne di più, vedi Come impostare il progetto di quota.

Come viene determinato il progetto di quota

Il modo in cui viene determinato il progetto di quota dipende dal tipo di API utilizzato: API basata sulle risorse o API basata su client.

API basate sulle risorse

Per le API Google Cloud basate sulle risorse, il progetto che fornisce la quota una chiamata API è anche il progetto che contiene la risorsa o rifiutano le richieste in base all'organizzazione a cui si accede. Ad esempio, quando crei un'istanza Compute Engine, devi e specificare il progetto per quella nuova istanza. Il progetto contiene quindi è stata creata. In seguito, se esegui operazioni su Compute Engine, Ad esempio, il progetto che contiene l'istanza fornisce la quota richiesta. Ciò vale indipendentemente dal fatto che utilizzi Google Cloud CLI, l'API REST o le librerie client.

Non puoi cambiare il progetto di quota utilizzato da una richiesta in un'API basata sulle risorse. La richiesta utilizza sempre il progetto che contiene la risorsa corrispondente operativo.

API basate su client

Se un'API non è basata sulle risorse, è un'API basata su client. Ad esempio, L'API Cloud Translation è un'API basata su client di uso comune.

Quando effettui una richiesta a un'API basata su client, se non è possibile eseguire un progetto di quota identificati, la richiesta non va a buon fine.

Il progetto di quota può essere impostato in più modi e il progetto verrà verificato selezionando le opzioni che seguono. L'ordine elencato è l'ordine dei loro la precedenza.

  • Il progetto di quota impostato nel ambiente o nel richiesta.
  • Se utilizzi una chiave API per fornire le credenziali per una richiesta, il progetto associate alla chiave API viene utilizzato come progetto quota.
  • Se utilizzi Google Cloud CLI per ottenere il token di accesso di aver eseguito l'autenticazione a gcloud CLI con le tue credenziali utente, il progetto condiviso della gcloud CLI viene talvolta utilizzato come progetto di quota. Non tutte le API basate su client fanno affidamento sul progetto condiviso.
  • Se l'entità per la chiamata API è un account di servizio, inclusi di impersonificazione, il progetto associato all'account di servizio viene utilizzato come progetto di quota.
  • Se l'entità per l'API è un utente della federazione delle identità per la forza lavoro, progetto utente pool di forza lavoro viene utilizzato come progetto di quota.

Se nessuno dei controlli precedenti restituisce un progetto di quota, la richiesta non va a buon fine.

Informazioni sul progetto condiviso della gcloud CLI per le API basate su client

Se utilizzi gcloud CLI per effettuare una richiesta a un'API basata su client senza impostare il progetto di quota, la richiesta potrebbe Progetto condiviso dell'interfaccia a riga di comando gcloud, altrimenti la richiesta potrebbe non riuscire. Il progetto condiviso della gcloud CLI è utilizzato da tutte la gcloud CLI richieste in tutti i progetti, quindi se vengono eseguite molte altre richieste della gcloud CLI anche utilizzando questo progetto come progetto di quota, la quota per potrebbe essere temporaneamente esaurito. In questo caso, la richiesta non va a buon fine. con un messaggio di errore di superamento quota.

Identifica il progetto di quota attuale per le API basate su client

Per identificare il progetto utilizzato per un comando gcloud CLI, includi il comando --log-http con gcloud CLI per stampare le intestazioni del comando. La log include il progetto utilizzato per questo comando come progetto di quota nel campo X-Goog-User-Project.

Determinare se un'API è basata sulle risorse o sul client

Può essere difficile determinare il tipo di API in uso. Tuttavia, l'attivazione e la quota vengono applicate nello stesso modo. Se un account di servizio Il progetto A chiama un metodo di lettura nel progetto B e nessuno dei due ha l'API è abilitato, il messaggio di errore API not enabled indica quale progetto è stata controllata per verificare l'attivazione. Il progetto per il quale è stato controllato l'attivazione è lo stesso il progetto ha controllato la quota di frequenza.

Passaggi successivi