Compute Engine 동시 작업 할당량

이 문서에서는 Compute Engine의 동시 작업 할당량을 설명합니다.

동시 작업 할당량

동시 작업 할당량은 특정 시점에 발생할 수 있는 진행 중인 작업이나 동시 작업의 수를 정의합니다. Compute Engine 리소스를 생성, 수정 또는 삭제하는 API 요청에는 동시 작업 한도 검사가 수행되어 어느 시점에서나 진행 중인 작업 총개수가 해당 작업에 지정된 한도를 초과하지 않는지 확인합니다.

동시 작업 한도 초과 오류

프로젝트가 진행 중인 작업에 대한 동시 작업 한도를 초과하면 rateLimitExceeded라는 이유와 함께 403 오류가 표시됩니다.

오류의 API 응답은 다음과 비슷합니다.

    "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"
            }
          ]
        },
      ...
      ...

오류 세부정보에는 다음 값이 포함됩니다.

  • PROJECT_ID: 할당량이 한도를 초과하는 프로젝트의 ID입니다.

  • QUOTA_METRIC: 한도를 초과하는 동시 할당량의 측정항목입니다. 다음 중 하나일 수 있습니다.

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

  • QUOTA_LIMIT: 동시 할당량의 한도 이름입니다. 다음 중 하나일 수 있습니다.

    • GlobalConcurrentOperationsPerProject
    • GlobalConcurrentOperationsPerProjectOperationType
    • RegionalConcurrentOperationsPerProject
    • RegionalConcurrentOperationsPerProjectOperationType

  • OPERATION_TYPE: 할당량이 한도를 초과하는 전역 또는 리전 작업입니다. 작업 목록은 동시 작업 할당량 그룹을 참조하세요.

  • location는 다음 중 하나일 수 있습니다.

    • global: 전역 작업 할당량 한도를 초과하도록 지정
    • REGION: 작업 할당량 한도를 초과하는 리전 지정

동시 작업 할당량 사용 및 한도를 보고 이러한 할당량 오류를 줄이기 위한 권장사항을 읽어보세요.

동시 작업 할당량 그룹

이 섹션에서는 다양한 Compute Engine의 진행 중인 작업 또는 동시 작업에 대한 한도를 설명합니다.

전역 작업 할당량

동시 전역 작업은 프로젝트별로 작업 유형에 지정된 전역 한도를 사용합니다. 다음 표에는 진행 중인 작업의 전역 할당량과 해당 측정항목이 나와 있습니다.

Google Cloud 콘솔, Google Cloud CLI, Service Usage API를 사용하여 전역 작업의 할당량을 볼 수 있습니다. 자세한 내용은 동시 작업 할당량 및 한도 보기를 참조하세요.

할당량 이름
설명		 측정항목 이름 이 할당량을 사용하는 메서드
Concurrent global operations per project
프로젝트의 동시 전역 작업 총개수를 제한합니다.

Google Cloud 콘솔에서 이 할당량 보기

compute.googleapis.com/global_concurrent_operations

모든 전역 메서드.

HTTP 요청 URL에는 이러한 메서드의 global이 포함됩니다. 예를 들면 networks.insert 메서드입니다.
POST /compute/v1/projects/{project}/global/networks
Concurrent global operations per project operation type
작업 유형별로 프로젝트당 동시 작업 수를 제한합니다.

Google Cloud 콘솔에서 이 할당량 보기

compute.googleapis.com/global_concurrent_operations

모든 전역 메서드.

기본 한도가 다른 다음 메서드를 제외하고 기본 동시 작업 할당량은 프로젝트당 진행 중인 작업 500개입니다.

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

리전 작업 할당량

동시 리전 작업은 특정 리전의 프로젝트별로 작업 유형에 지정된 리전 한도를 사용합니다.

다음 표에는 진행 중인 작업의 리전 할당량과 해당 측정항목이 나와 있습니다.

Google Cloud 콘솔, Google Cloud CLI, Service Usage API를 사용하여 리전 작업의 할당량을 볼 수 있습니다. 자세한 내용은 동시 작업 할당량 및 한도 보기를 참조하세요.

할당량 이름
설명		 측정항목 이름 이 할당량을 사용하는 메서드
Concurrent regional operations per project
프로젝트의 동시 리전 작업 총개수를 제한합니다.

Google Cloud 콘솔에서 이 할당량 보기

compute.googleapis.com/regional_concurrent_operations

모든 리전 메서드.

HTTP 요청 URL에는 이러한 메서드의 regions 또는 zones가 포함됩니다.
예를 들면 instances.insert 메서드입니다.
POST /compute/v1/projects/{project}/zones/{zone}/instances
Concurrent regional operations per project operation type
작업 유형별로 프로젝트당 동시 리전 작업 수를 제한합니다.

Google Cloud 콘솔에서 이 할당량 보기

compute.googleapis.com/regional_concurrent_operations

모든 리전 메서드.

기본 한도가 다른 다음 메서드를 제외하고 기본 동시 작업 할당량은 리전별 프로젝트당 진행 중인 작업 500개입니다.

addresses.move

disks.insert

instances.delete

instances.insert

instances.simulateMaintenanceEvent

networkEndpointGroups.attachNetworkEndpoints

networkEndpointGroups.detachNetworkEndpoints

publicDelegatedPrefixes.delete

publicDelegatedPrefixes.insert

동시 작업 할당량 및 한도 보기

프로젝트의 할당량 사용 및 한도를 보려면 다음을 수행합니다.

콘솔

  1. Google Cloud 콘솔에서 할당량 페이지로 이동합니다.

    할당량으로 이동

    할당량 페이지에는 프로젝트의 모든 할당량 사용 및 한도가 나와 있습니다. 기본적으로 목록은 가장 많이 사용된 할당량이 먼저 표시되도록 정렬되므로 초과될 위험이 있는 한도를 확인하는 데 유용합니다.

  2. 목록을 필터링하고 특정 할당량의 사용량과 한도를 보려면 필터 필드에서 할당량 또는 측정항목을 선택합니다.

    예를 들어 할당량 Concurrent global operations per project operation type을 선택하여 작업 유형별로 전역 메서드의 할당량 사용을 확인합니다.

    특정 작업의 할당량을 필터링하려면 필터 쿼리에 측정기준을 추가하고 operation_type을 선택합니다. 예를 들어 firewalls.insert 작업의 할당량 사용과 한도를 확인하려면 firewalls_insert을 선택합니다.

gcloud

Google Cloud CLI를 사용하여 동시 작업 할당량 사용과 한도를 볼 수 있습니다.

이 방식을 사용하려면 알파 명령어 구성요소를 설치했는지 확인합니다. Cloud Shell을 사용하여 Google Cloud와 상호작용하는 경우 Google Cloud CLI가 설치됩니다.

할당량을 보려면 다음 명령어를 사용합니다.

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

PROJECT_ID를 할당량을 보려는 프로젝트의 ID로 바꿉니다.

권장사항

다음 체크리스트에는 동시 작업 한도 부족 오류를 줄이기 위한 권장사항이 요약되어 있습니다.

다음 단계