Quote per le operazioni simultanee di Compute Engine

Questo documento descrive le quote per le operazioni simultanee di Compute Engine.

Quote per operazioni simultanee

Le quote per le operazioni in parallelo definiscono il numero di operazioni in corso o simultanee che possono verificarsi in qualsiasi momento. Qualsiasi richiesta API che crea, modifica o elimina una risorsa Compute Engine è soggetta a un controllo del limite di operazioni simultanee per garantire che il numero totale di operazioni in corso non superi il limite specificato per l'operazione.

Errore di superamento limite di operazioni simultanee

Se il progetto supera il limite di operazioni simultanee per qualsiasi operazione in corso, viene visualizzato un errore 403 con il motivo rateLimitExceeded.

La risposta dell'errore all'API è simile alla seguente:

    "error": {
      "code": 403,
      "message": "Rate Limit Exceeded",
      "errors": [
        {
          "message": "Rate Limit Exceeded",
          "domain": "usageLimits",
          "reason": "rateLimitExceeded",
        ...
        ...
        }
      ],
      "details": [
        {
          "@type": "type.googleapis.com/google.rpc.ErrorInfo",
          "reason": "CONCURRENT_OPERATIONS_QUOTA_EXCEEDED",
          "domain": "compute.googleapis.com",
          "metadatas": {
            "containerType": "PROJECT",
            "containerId": "PROJECT_ID",
            "quotaMetric": "QUOTA_METRIC",
            "quotaLimit": "QUOTA_LIMIT",
            "operationType": "OPERATION_TYPE",
            "location": "global | REGION"
          }
        },
        {
          "@type": "type.googleapis.com/google.rpc.Help",
          "links": [
            {
              "description": "Concurrent operations quota documentation.",
              "url": "https://cloud.google.com/compute/operations-quota#concurrent_operation_limits"
            }
          ]
        },
      ...
      ... 

I dettagli dell'errore contengono i seguenti valori:

• PROJECT_ID: l'ID del progetto in cui la quota supera il limite.

• QUOTA_METRIC: la metrica per la quota in parallelo che supera il limite. Può essere uno dei seguenti:

  • compute.googleapis.com/global_concurrent_operations
  • compute.googleapis.com/regional_concurrent_operations

• QUOTA_LIMIT: il nome del limite della quota simultanea. Può essere uno dei seguenti:

  • GlobalConcurrentOperationsPerProject
  • GlobalConcurrentOperationsPerProjectOperationType
  • RegionalConcurrentOperationsPerProject
  • RegionalConcurrentOperationsPerProjectOperationType

• OPERATION_TYPE: l'operazione globale o regionale per cui la quota supera il limite. Per un elenco delle operazioni, consulta Gruppi di quote per le operazioni simultanee.

• location può essere uno dei seguenti:

  • global: specifica che è stato superato il limite per la quota operativa globale
  • REGION: specifica la regione in cui è stato superato il limite per la quota dell'operazione

Visualizza l'utilizzo e i limiti delle quote per le operazioni simultanee e leggi le best practice per ridurre questi errori di quota.

Gruppi di quote per operazioni in parallelo

Questa sezione descrive i limiti per varie operazioni in corso o simultanee di Compute Engine.

Quote per le operazioni globali

Le operazioni globali simultanee consumano un limite globale specificato per i tipi di operazioni per progetto. La seguente tabella elenca le quote globali per le operazioni in corso e le metriche corrispondenti.

Puoi visualizzare la quota per le operazioni globali utilizzando la console Google Cloud, Google Cloud CLI e l'API Service Usage. Per maggiori informazioni, consulta Visualizzare quote e limiti per le operazioni simultanee.

Nome quota Descrizione	Nome metrica	Metodi che consumano questa quota
Concurrent global operations per project Limita il numero totale di operazioni globali simultanee per un progetto. Visualizza questa quota nella console Google Cloud	compute.googleapis.com/global_concurrent_operations	Tutti i metodi globali. L'URL della richiesta HTTP contiene global per questi metodi. Ad esempio, il metodo networks.insert: POST /compute/v1/projects/{project}/global/networks
Concurrent global operations per project operation type Limita il numero di operazioni simultanee per progetto per tipo di operazione. Visualizza questa quota nella console Google Cloud	compute.googleapis.com/global_concurrent_operations	Tutti i metodi globali. La quota per le operazioni simultanee predefinita è 500 operazioni in corso per progetto, ad eccezione dei seguenti metodi, che hanno limiti predefiniti diversi: globaladdresses.move firewalls.delete firewalls.insert images.delete images.deprecate images.insert images.patch images.setLabels images.setIamPolicy licenses.insert machineimages.delete machineimages.insert networks.addPeering networks.removePeering networks.updatePeering projects.setCommonInstaneMetadata publicAdvertisedPrefixes.delete publicAdvertisedPrefixes.insert routes.delete routes.insert securityPolicies.patchRule snapshots.delete snapshots.insert snapshots.setLabels snapshots.setIamPolicy snapshotSettings.patch

Quote di operazioni a livello di regione

Le operazioni a livello di regione simultanee utilizzano un limite a livello di regione specificato per i tipi di operazioni per progetto in una determinata regione.

La seguente tabella elenca le quote regionali per le operazioni in corso e le metriche corrispondenti.

Puoi visualizzare la quota per le operazioni a livello di regione utilizzando la console Google Cloud, Google Cloud CLI e l'API Service Usage. Per maggiori informazioni, consulta Visualizzare quote e limiti per le operazioni simultanee.

Nome quota Descrizione	Nome metrica	Metodi che consumano questa quota
Concurrent regional operations per project Limita il numero totale di operazioni regionali simultanee per un progetto. Visualizza questa quota nella console Google Cloud	compute.googleapis.com/regional_concurrent_operations	Tutti i metodi a livello di regione. L'URL della richiesta HTTP contiene regions o zones per questi metodi. Ad esempio, il metodo instances.insert: POST /compute/v1/projects/{project}/zones/{zone}/instances
Concurrent regional operations per project operation type Limita il numero di operazioni regionali simultanee per progetto per tipo di operazione. Visualizza questa quota nella console Google Cloud	compute.googleapis.com/regional_concurrent_operations	Tutti i metodi a livello di regione. La quota per le operazioni simultanee predefinita è 500 operazioni in corso per progetto e per regione, ad eccezione dei seguenti metodi, che hanno limiti predefiniti diversi: addresses.move disks.insert instances.delete instances.insert instances.simulateMaintenanceEvent networkEndpointGroups.attachNetworkEndpoints networkEndpointGroups.detachNetworkEndpoints publicDelegatedPrefixes.delete publicDelegatedPrefixes.insert

Visualizza quote e limiti per le operazioni simultanee

Per visualizzare l'utilizzo e i limiti della quota in un progetto, segui questi passaggi:

Console

1. Nella console Google Cloud, vai alla pagina Quote.

   Vai a Quote

   La pagina Quote elenca tutti gli utilizzi delle quote e i relativi limiti per il tuo progetto. Per impostazione predefinita, l'elenco è ordinato in modo da mostrare per prime le quote più utilizzate, in modo da visualizzare i limiti che rischiano di essere superati.

2. Per filtrare l'elenco e visualizzare l'utilizzo e il limite per una quota specifica, seleziona Quota o Metrica nel campo Filtro.

   Ad esempio, seleziona la quota Concurrent global operations per project operation type per visualizzare l'utilizzo della quota per i metodi globali per tipo di operazione.

   Per filtrare la quota per un'operazione specifica, aggiungi Dimensioni alla query di filtro e seleziona operation_type. Ad esempio, seleziona firewalls_insert per visualizzare l'utilizzo della quota e il limite per l'operazione firewalls.insert.

gcloud

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Puoi utilizzare Google Cloud CLI per visualizzare l'utilizzo e il limite delle quote operative simultanee.

Per utilizzare questo approccio, assicurati di aver installato il componente comandi alpha. Se utilizzi Cloud Shell per interagire con Google Cloud, Google Cloud CLI è già installato.

Per visualizzare la quota, utilizza il comando seguente:

gcloud alpha services quota list \
    --service=compute.googleapis.com \
    --consumer=projects/PROJECT_ID

Sostituisci PROJECT_ID con l'ID del progetto per il quale vuoi visualizzare la quota.

best practice

Il seguente elenco di controllo riassume le best practice per ridurre gli errori relativi a limiti di operazioni simultanee insufficienti:

• Attendi il completamento delle operazioni
• Affidati ai codici di errore, non ai messaggi
• Riduci al minimo i tentativi lato client per preservare i limiti di frequenza API
  • Evita sondaggi brevi
  • Usare la funzionalità di bursting con parsimonia e in modo selettivo
  • Effettua sempre le chiamate in un loop di nuovi tentativi con backoff esponenziale
  • Utilizzare un limitatore di frequenza lato client
  • Suddividi le applicazioni tra più progetti

Passaggi successivi

• Ulteriori informazioni sulle quote di Google Cloud.