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: 작업 할당량 한도를 초과하는 리전 지정

자세한 오류 로그는 API 응답을 통해서만 반환됩니다. 로그 탐색기의 오류는 다음과 유사합니다.

   "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은 비율 제한이 초과된 API 메서드를 나타냅니다. 예를 들면 v1.compute.instances.stop입니다.

동시 작업 할당량 그룹

이 섹션에서는 다양한 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

미리보기

이 제품 또는 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 제품 및 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

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로 바꿉니다.

권장사항

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

• 작업 완료 대기
• 오류 메시지 대신 오류 코드 사용
• 클라이언트 측 재시도를 최소화하여 API 비율 제한 보존
  • 단기 폴링 피하기
  • 버스팅은 부득이한 경우에만 선별적으로 사용
  • 항상 지수 백오프로 재시도 루프에서 호출
  • 클라이언트 측 비율 제한 사용
  • 애플리케이션을 여러 프로젝트에 분할

다음 단계

• Google Cloud 할당량 알아보기