Quote di operazioni simultanee di Compute Engine

---

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

Quote di operazioni simultanee

Le quote di operazioni contemporanee definiscono il numero di operazioni in corso o contemporanee 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 in qualsiasi momento non superi il limite specificato per l'operazione.

Errore: limite di operazioni simultanee superato

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

La risposta dell'API dell'errore è 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 simultanea 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 la quale la quota supera il limite. Per un elenco delle operazioni, consulta Gruppi di quota per le operazioni simultanee.

• location può essere uno dei seguenti:

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

I log degli errori dettagliati vengono restituiti solo tramite la risposta dell'API. L'errore in Esplora log è simile al seguente:

   "protoPayload":{
    "@type": "type.googleapis.com/google.cloud.audit.AuditLog",
    "status": {
      "message": "Rate Limit Exceeded"
    }
    "serviceName": "compute.googleapis.com",
    "methodName": "METHOD_NAME",
    ...
    ...
    "response": {
      "error": {
        "message": "Rate Limit Exceeded",
        "code": 403,
        "errors": [
          {
            "message": "Rate Limit Exceeded",
            "reason": "rateLimitExceeded",
            "domain": "usageLimits"
          }
        ]
      },
      "@type": "type.googleapis.com/error"
    },
    ...
    ... 

METHOD_NAME nell'errore rappresenta il metodo dell'API per il quale è stato superato il limite di frequenza. Ad esempio, v1.compute.instances.stop.

Gruppi di quote per le operazioni simultanee

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

Quote di operazioni globali

Le operazioni globali concorrenti consumano un limite globale specificato per i tipi di operazioni per progetto. La tabella seguente 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 ulteriori 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. Visualizzare 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 e per tipo di operazione. Visualizzare questa quota nella console Google Cloud	compute.googleapis.com/global_concurrent_operations	Tutti i metodi globali. La quota di operazioni simultanee predefinita è di 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 regionali concorrenti consumano un limite regionale specificato per i tipi di operazioni per progetto in una determinata regione.

La tabella seguente elenca le quote regionali per le operazioni in-flight 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 ulteriori 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. Visualizzare questa quota nella console Google Cloud	compute.googleapis.com/regional_concurrent_operations	Tutti i metodi regionali. 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 e per tipo di operazione. Visualizzare questa quota nella console Google Cloud	compute.googleapis.com/regional_concurrent_operations	Tutti i metodi regionali. La quota di operazioni simultanee predefinita è di 500 operazioni in corso per progetto 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

Visualizzare quote e limiti per le operazioni simultanee

Per visualizzare l'utilizzo e i limiti delle quote in un progetto:

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 progetto. Per impostazione predefinita, l'elenco è ordinato in modo da mostrare innanzitutto le quote più utilizzate, permettendoti di individuare le quote che rischiano di essere superate.

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 Quota Concurrent global operations per project operation type per visualizzare l'utilizzo della quota per i metodi globali in base al 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 e il limite della quota 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 di operazioni contemporaneamente.

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 seguente comando:

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 al limite di operazioni simultanee insufficienti:

• Attendi il completamento delle operazioni
• Fai affidamento sui codici di errore, non sui messaggi di errore
• Ridurre al minimo i tentativi lato client per rispettare i limiti di frequenza dell'API
  • Evitare il polling breve
  • Utilizza la funzionalità di invio frazionato con parsimonia e in modo selettivo
  • Esegui sempre le chiamate in un ciclo di nuovi tentativi con backoff esponenziale
  • Utilizzare un limitatore di frequenza lato client
  • Suddividere le applicazioni in più progetti

Passaggi successivi

• Scopri di più sulle quote di Google Cloud.