서비스 할당량 관리

이 페이지에서는 특정 서비스에 대한 Google Cloud 프로젝트의 모든 할당량 측정항목 및 한도를 확인하는 방법과 할당량 재정의를 사용하여 해당 서비스의 할당량 사용을 제한하는 방법에 대해 설명합니다. 서비스 사용량을 사용하여 공개 Google Cloud 서비스Cloud Endpoints를 사용하여 생성된 비공개 서비스를 포함한 모든 서비스에 대한 프로젝트 할당량을 관리할 수 있습니다. 공개 API 및 서비스와 비공개 API 및 서비스의 차이점에 대한 자세한 내용은 공개 및 비공개 서비스를 참조하세요.

대부분의 운영 사례에서 할당량을 관리하는 가장 간단한 방법은 Google Cloud Console을 사용하는 것입니다. Service Usage API와 달리 프로그래밍해야 하는 경우에는 제공된 클라이언트 라이브러리 중에 하나를 사용하는 것이 좋습니다. API를 실험하려는 경우 이 가이드의 안내에 따라 gcurl 명령어를 사용하면 전체 애플리케이션 개발 환경을 설정하지 않고 API를 테스트할 수 있습니다.

시작하기 전에

이 페이지의 예시를 사용하려면 시작하기 가이드에 나열된 모든 단계를 완료합니다. 이러한 단계에는 표준 curl 명령어의 인증된 별칭인 gcurl을 정의하고 환경 변수 PROJECT_NUMBER를 정의하는 과정이 포함됩니다.

이 가이드에 사용된 용어를 이해하기 위해서는 서비스 할당량 모델을 숙지해야 합니다.

서비스 할당량 표시

서비스의 특정 소비자에게 적용되는 모든 할당량 측정항목 및 한도를 보려면 다음 명령어를 사용하세요.

gcurl "https://serviceusage.googleapis.com/v1beta1/projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics"

이 호출은 서비스에서 정의한 측정항목 목록으로 응답합니다. 각 항목에는 이 소비자에게 적용되는 측정항목에 대한 한도 목록, 해당 한도의 값, 모든 재정의가 포함됩니다. 일부 응답 예시는 다음과 같습니다.


{
  "metrics": [
    ...
    {
      "name": "projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fcpus",
      "displayName": "CPUs",
      "consumerQuotaLimits": [
        {
          "name": "projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fcpus/limits/%2Fproject%2Fzone",
          "unit": "1/{project}/{zone}",
          "isPrecise": true,
          "metric": "compute.googleapis.com/cpus",
          "quotaBuckets": [
            {
              "effectiveLimit": "-1",
              "defaultLimit": "-1"
            }
          ]
        },
        {
          "name": "projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion",
          "unit": "1/{project}/{region}",
          "isPrecise": true,
          "metric": "compute.googleapis.com/cpus",
          "quotaBuckets": [
            {
              "effectiveLimit": "24",
              "defaultLimit": "24"
            },
            {
              "effectiveLimit": "72",
              "defaultLimit": "72",
              "dimensions": {
                "region": "asia-northeast1"
              }
            },

            ...

            {
              "effectiveLimit": "72",
              "defaultLimit": "72",
              "dimensions": {
                "region": "australia-southeast1"
              }
            }
          ]
        }
      ],
      "metric": "compute.googleapis.com/cpus",
      "unit": "1"
    },
    ...
    {
      "name": "projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways",
      "displayName": "External VPN gateways",
      "consumerQuotaLimits": [
        {
          "name": "projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways/limits/%2Fproject",
          "unit": "1/{project}",
          "isPrecise": true,
          "metric": "compute.googleapis.com/external_vpn_gateways",
          "quotaBuckets": [
            {
              "effectiveLimit": "15",
              "defaultLimit": "15"
            }
          ]
        }
      ],
      "metric": "compute.googleapis.com/external_vpn_gateways",
      "unit": "1"
    },
    ...

응답의 각 측정항목에는 name 필드가 있습니다. 모든 측정항목이 아닌 이 측정항목에 대한 할당량 설정만 검사하려면 URL에 name을 사용하세요. 이 가이드에서 환경 변수 METRIC_RESOURCE_NAME은 할당량 측정항목 리소스 이름을 저장합니다.

METRIC_RESOURCE_NAME="projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways"
gcurl "https://serviceusage.googleapis.com/v1beta1/${METRIC_RESOURCE_NAME}"

특정 측정 항목 리소스 이름이 지정되었으므로 호출은 해당 측정항목에 대한 정보만 반환합니다.

{
  "name": "projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways",
  "displayName": "External VPN gateways",
  "consumerQuotaLimits": [
    {
      "name": "projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways/limits/%2Fproject",
      "unit": "1/{project}",
      "isPrecise": true,
      "metric": "compute.googleapis.com/external_vpn_gateways",
      "quotaBuckets": [
        {
          "effectiveLimit": "15",
          "defaultLimit": "15"
        }
      ]
    }
  ],
  "metric": "compute.googleapis.com/external_vpn_gateways",
  "unit": "1"
}

마찬가지로 측정항목 내의 각 한도에는 name 필드가 있습니다. 어떤 측정항목 또는 모든 측정항목의 전체 한도가 아닌 해당 측정항목의 이 한도에 대한 할당량 설정만 검사하려면 URL에 name을 사용하세요. 이 가이드에서 환경 변수 LIMIT_RESOURCE_NAME은 할당량 한도 리소스 이름을 저장합니다.

LIMIT_RESOURCE_NAME="projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways/limits/%2Fproject"
gcurl "https://serviceusage.googleapis.com/v1beta1/${LIMIT_RESOURCE_NAME}"

특정 한도가 지정되면 호출은 해당 한도에 대한 정보만 반환합니다.

{
  "name": "projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways/limits/%2Fproject",
  "unit": "1/{project}",
  "isPrecise": true,
  "metric": "compute.googleapis.com/external_vpn_gateways",
  "quotaBuckets": [
    {
      "effectiveLimit": "15",
      "defaultLimit": "15"
    }
  ]
}

소비자 할당량 재정의 만들기

프로젝트 소유자는 해당 프로젝트의 특정 할당량 한도에 소비자 재정의를 적용하여 소비자가 해당 한도에 대해 청구할 수 있는 총 할당량을 줄일 수 있습니다.

소비자 재정의는 사용 가능 할당량을 서비스 기본값 또는 다른 당사자(예: 서비스 소유자 또는 조직의 할당량 관리자)의 기존 재정의에서 허용된 것보다 늘릴 수 없습니다. 사용 가능 할당량을 늘리려면 할당량 기본 페이지에서 할당량 수정 옵션을 사용하거나 조직 관리자에게 할당량 증가를 요청하십시오.

재정의할 한도를 식별하려면 먼저 이전 방법 중 하나를 사용하여 원하는 할당량 한도를 찾습니다. 그런 다음 할당량 한도의 이름 필드를 사용하여 해당 한도에서 새로운 소비자 재정의를 만듭니다. 다음은 Compute Engine 서비스의 '외부 VPN 게이트웨이' 할당량 측정항목의 프로젝트별 한도에 대한 예시입니다.

LIMIT_RESOURCE_NAME="projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways/limits/%2Fproject"
gcurl "https://serviceusage.googleapis.com/v1beta1/${LIMIT_RESOURCE_NAME}/consumerOverrides" -d '{"overrideValue": "14"}'

호출이 성공하면 할당량 변경이 백엔드 시스템으로 전달될 때 서버에서 진행 중인 작업을 나타내는 작업 식별자가 반환됩니다.

{
  "name": "operations/quf.92accba3-6530-4fc1-9a95-c1280d48a6b7"
}

작업 진행 상황을 확인하려면 name을 사용합니다.

OPERATION_NAME="operations/quf.92accba3-6530-4fc1-9a95-c1280d48a6b7"
gcurl "https://serviceusage.googleapis.com/v1/${OPERATION_NAME}"

작업에 성공하면 응답 메시지에 done: true와 새로 작성된 재정의 리소스가 포함됩니다. 작업에 실패하면 응답 메시지에 done: true와 리소스가 아닌 오류 세부정보가 포함됩니다.

재정의가 생성되었는지 확인하려면 한도에 대한 모든 소비자 재정의를 나열합니다.

gcurl "https://serviceusage.googleapis.com/v1beta1/${LIMIT_RESOURCE_NAME}/consumerOverrides"

새롭게 생성된 재정의가 목록에 표시됩니다.

{
  "overrides": [
    {
      "name": "projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways/limits/%2Fproject/consumerOverrides/Cg1RdW90YU92ZXJyaWRl",
      "overrideValue": "14"
    }
  ]
}

리전 또는 영역 할당량 재정의 만들기

일부 할당량 한도는 리전 또는 영역별로 적용됩니다. 이는 한도의 unit 필드에 {region} 또는 {zone}이 있는지 여부로 확인할 수 있습니다. 예를 들어 "1/{project}/{region}" 단위의 한도는 리전별로 적용됩니다. 이러한 한도에 재정의를 적용하면 각 리전 또는 영역의 기본 할당량이 변경됩니다. 특정 리전 또는 영역에 대한 할당량만 변경하려면 재정의를 만들 때 dimensions 필드를 사용하여 할당량 측정기준을 추가합니다. 예를 들어 다음과 같이 Compute Engine 리전 할당량 한도에 리전 재정의를 만듭니다.

REGIONAL_LIMIT_RESOURCE_NAME="projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion"
gcurl "https://serviceusage.googleapis.com/v1beta1/${REGIONAL_LIMIT_RESOURCE_NAME}/consumerOverrides" -d '{"overrideValue": "65", "dimensions": {"region": "southamerica-east1"} }'

리전 재정의가 생성되었는지 확인하려면 한도에 대한 모든 소비자 재정의를 나열합니다.

gcurl "https://serviceusage.googleapis.com/v1beta1/${REGIONAL_LIMIT_RESOURCE_NAME}/consumerOverrides"

새로 생성된 리전 재정의가 목록에 표시됩니다.

{
  "overrides": [
    {
      "name": "projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fcpus/limits/%2Fproject%2Fregion/consumerOverrides/Cg1RdW90YU92ZXJyaWRlGhwKBnJlZ2lvbhISc291dGhhbWVyaWNhLWVhc3Qx",
      "overrideValue": "65",
      "dimensions": {
        "region": "southamerica-east1"
      }
    }
  ]
}

소비자 할당량 재정의 업데이트

프로젝트 소유자는 프로젝트에 대한 기존 소비자 재정의 값을 변경할 수도 있습니다.

예를 들어 이전 생성 호출이 다음과 같이 name 필드가 포함된 재정의를 반환했다고 가정합니다.

name: "projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways/limits/%2Fproject/consumerOverrides/Cg1RdW90YU92ZXJyaWRl"

그러면 해당 name을 사용하여 다음과 같이 업데이트할 재정의를 식별합니다.

OVERRIDE_RESOURCE_NAME="projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways/limits/%2Fproject/consumerOverrides/Cg1RdW90YU92ZXJyaWRl"
gcurl "https://serviceusage.googleapis.com/v1beta1/${OVERRIDE_RESOURCE_NAME}" -X PATCH -d '{"overrideValue": "13"}'

호출이 성공하면 할당량 변경이 백엔드 시스템으로 전달될 때 서버에서 진행 중인 작업을 나타내는 작업 식별자가 반환됩니다.

{
  "name": "operations/quf.92accba3-6530-4fc1-9a95-c1280d48a6b7"
}

작업 진행 상황을 확인하려면 name을 사용합니다.

OPERATION_NAME="operations/quf.92accba3-6530-4fc1-9a95-c1280d48a6b7"
gcurl "https://serviceusage.googleapis.com/v1/${OPERATION_NAME}"

작업에 성공하면 응답 메시지에 done: true와 업데이트된 재정의 리소스가 포함됩니다. 작업에 실패하면 응답 메시지에 done: true와 업데이트된 리소스가 아닌 오류 세부정보가 포함됩니다.

재정의가 업데이트되었는지 확인하려면 한도에 대한 모든 소비자 재정의를 나열합니다.

LIMIT_RESOURCE_NAME="projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways/limits/%2Fproject"
gcurl "https://serviceusage.googleapis.com/v1beta1/${LIMIT_RESOURCE_NAME}/consumerOverrides"

이제 재정의가 업데이트된 값으로 목록에 나타납니다.

{
  "overrides": [
    {
      "name": "projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways/limits/%2Fproject/consumerOverrides/Cg1RdW90YU92ZXJyaWRl",
      "overrideValue": "13"
    }
  ]
}

소비자 할당량 재정의 삭제하기

프로젝트 소유자는 프로젝트에서 소비자 재정의를 삭제할 수도 있습니다.

예를 들어 이전 생성 호출이 다음과 같이 name 필드가 포함된 재정의를 반환했다고 가정합니다.

name: "projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fdefault_requests/limits/%2Fmin%2Fproject/consumerOverrides/Cg1RdW90YU92ZXJyaWRl"

재정의를 삭제하려면 다음과 같이 합니다.

OVERRIDE_RESOURCE_NAME="projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fdefault_requests/limits/%2Fmin%2Fproject/consumerOverrides/Cg1RdW90YU92ZXJyaWRl"
gcurl "https://serviceusage.googleapis.com/v1beta1/${OVERRIDE_RESOURCE_NAME}" -X DELETE

재정의가 삭제되었는지 확인하려면 한도에 대한 모든 소비자 재정의를 나열합니다.

LIMIT_RESOURCE_NAME="projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways/limits/%2Fproject"
gcurl "https://serviceusage.googleapis.com/v1beta1/${LIMIT_RESOURCE_NAME}/consumerOverrides"

삭제된 재정의는 더 이상 목록에 표시되지 않습니다.

대규모 할당량 변경 강제 적용

할당량 재정의 변경으로 인해 적용된 할당량이 10% 이상 감소할 수 있는 경우 할당량이 의도치 않게 너무 빨리 감소하는 걸 방지하기 위한 안전 조치로 호출이 거부됩니다. 이 제한사항을 무시하려면 force 플래그를 사용하세요. 예를 들어 다음은 force 플래그를 사용하는 생성 호출입니다.

LIMIT_RESOURCE_NAME="projects/${PROJECT_NUMBER}/services/compute.googleapis.com/consumerQuotaMetrics/compute.googleapis.com%2Fexternal_vpn_gateways/limits/%2Fproject"
gcurl "https://serviceusage.googleapis.com/v1beta1/${LIMIT_RESOURCE_NAME}/consumerOverrides?force=true" -d '{"overrideValue": "0"}'