Quote di operazioni simultanee di Compute Engine

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

Quote di operazioni simultanee

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

Errore di limite di operazioni simultanee superato

Se il tuo progetto supera il limite di operazioni simultanee per qualsiasi operazione in corso, ricevi 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",
          "metadata": {
            "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 cui la quota supera il limite. Per un elenco delle operazioni, vedi Gruppi di quote per le operazioni simultanee.

• location può essere uno dei seguenti:

  • global: specifica che il limite è stato superato per la quota di operazioni globale
  • REGION: specifica la regione in cui è stato superato il limite per la quota di operazioni

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 API per il quale è stata superata la limitazione 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 simultanee di Compute Engine.

Quote di operazioni globali

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

Puoi visualizzare la quota per le operazioni globali utilizzando la console Trusted Cloud , Google Cloud CLI e l'API Service Usage. Per ulteriori informazioni, vedi Visualizza quote e limiti per le operazioni simultanee.

Quote di operazioni regionali

Le operazioni regionali simultanee 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 volo e le metriche corrispondenti.

Puoi visualizzare la quota per le operazioni regionali utilizzando la console Trusted Cloud , Google Cloud CLI e l'API Service Usage. Per ulteriori informazioni, vedi Visualizza quote e limiti per le operazioni simultanee.

Visualizza quote e limiti per le operazioni simultanee

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

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

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
• Riduci al minimo i nuovi tentativi lato client per rispettare i limiti di frequenza dell'API
  • Evita intervalli di polling brevi
  • Utilizza il bursting con parsimonia e in modo selettivo
  • Esegui sempre le chiamate in un ciclo di nuovi tentativi con backoff esponenziale
  • Utilizza un limitatore di frequenza lato client
  • Suddividi le applicazioni in più progetti

Passaggi successivi

• Scopri di più sulle quote di Cloud.