gcloud alpha CLI를 사용하여 할당량 보기 및 관리

다음 섹션에는 예시 gcloud alpha quotas info 및 gcloud alpha quotas preferences 명령어가 포함되어 있습니다. 이 명령어를 사용하면 QuotaInfo 및 QuotaPreference 리소스를 보고 관리할 수 있습니다.

Google Cloud CLI(gcloud CLI)를 사용하여 현재 할당량 값을 가져오고 일부 Google Cloud API 및 서비스의 할당량 환경설정을 지정할 수 있습니다.

제한사항

Cloud Quotas에는 다음과 같은 제한사항이 있습니다.

할당량 상향 조정은 프로젝트 수준에서 이루어져야 하며 Google Cloud 승인을 받아야 합니다.
project-, folder-, 조직 수준 할당량에 대한 할당량 하향 조정을 요청할 수 있습니다.
Cloud Quotas API는 프로젝트 수준의 작업만 지원합니다. 폴더 수준 및 조직 수준 작업은 지원되지 않습니다.

시작하기 전에

gcloud CLI를 사용하기 전에 gcloud CLI를 설치하고 초기화해야 합니다.

QUOTA_ID 값이 필요할 수도 있습니다. 이러한 경우 할당량 ID 찾기 안내를 참조하세요.

gcloud CLI 설치 및 초기화

Cloud 할당량에 gcloud CLI를 사용하려면 구성요소를 설치하고 초기화해야 합니다.

gcloud CLI 설치

Cloud Shell을 사용하는 경우 gcloud CLI가 사전 설치되어 있으므로 이 단계를 건너뛸 수 있습니다.
gcloud CLI 초기화
다음 명령어를 실행하여 알파 구성요소를 설치합니다.
```
gcloud components install alpha
```

할당량 ID 찾기

이 페이지의 여러 gcloud CLI 명령어에서 할당량 ID 값을 참조합니다. Google Cloud 콘솔, gcloud CLI, 클라이언트 라이브러리 또는 REST API를 사용하여 할당량 ID를 찾을 수 있습니다. 이 섹션에서는 Google Cloud 콘솔이나 gcloud CLI를 사용하여 할당량 ID를 찾는 방법을 보여줍니다.

콘솔

할당량 및 시스템 한도 페이지로 이동합니다.
할당량 및 시스템 한도로 이동
필터를 클릭하여 서비스를 필터링합니다.
한도 이름 열이 표시되지 않으면 열 표시 옵션... 아이콘을 클릭합니다. 제한 이름을 선택하고 확인을 클릭합니다.
한도 이름 열에 할당량 ID가 표시됩니다.

gcloud

gcloud CLI를 사용하여 할당량 ID 값을 찾으려면 다음 명령어를 실행하여 지정된 서비스의 할당량 정보를 나열합니다.

터미널 창에 다음 gcloud CLI 명령어를 입력합니다.
```
gcloud alpha quotas info list --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
--billing-project=BILLING_PROJECT_ID_OR_NUMBER
```
다음을 바꿉니다.
- SERVICE_NAME: 확인할 할당량이 있는 서비스 이름입니다. 예를 들어 Compute Engine의 서비스 이름은 compute.googleapis.com입니다.
- PROJECT_ID_OR_NUMBER: 프로젝트 ID 또는 프로젝트 번호입니다.
  
  Google Cloud 콘솔을 사용하여 프로젝트 ID를 찾으려면 Resource Manager 페이지로 이동합니다.
  Resource Manager로 이동
- BILLING_PROJECT_ID_OR_NUMBER: 할당량 및 결제에 사용되는 프로젝트 ID 또는 프로젝트 번호입니다. gcloud 명령어를 실행하면 REST 또는 RPC API를 통해 직접 동등한 요청을 한 것처럼 할당량이 영향을 받습니다.
  
  할당량을 사용할 프로젝트를 지정합니다. 할당량 ID를 찾으려는 서비스가 포함된 프로젝트와 다를 수 있습니다.
  
  gcloud CLI를 설정할 때 이미 결제 프로젝트를 설정한 경우 이 플래그는 선택사항입니다. 그렇지 않고 생략하면 권한 거부 오류가 발생할 수 있습니다. 자세한 내용은 할당량 프로젝트 설정을 참조하세요.

gcloud alpha quotas info list 명령어의 출력에는 다음 샘플과 비슷한 텍스트가 포함됩니다.

...
"quotaInfos": [
    ...
    {
        "name": "projects/PROJECT_NUMBER/locations/global/services/compute.googleapis.com/quotaInfos/CPUS-per-project-region",
        "quotaId": "CPUS-per-project-region",
        "metric": "compute.googleapis.com/cpus",
        "containerType": "PROJECT",
        "dimensions": [
            "region"
        ],
        "dimensionsInfo": [
            {
                "details": {
                    "value": 20
                },
                "applicableLocations": [
                    "us-central1",
                    "us-central2",
                    "us-west1",
                    "us-east1"
                ]
                ...
            }
        ]
    },
    ...
]
...

quotaId에 해당하는 값을 찾고 다음 섹션에서 QUOTA_ID를 지정할 때 이 값을 사용합니다.

gcloud 할당량 정보 명령어 예시

이 섹션에서는 gcloud alpha quotas info 명령어를 사용하여 특정 서비스나 조직의 할당량 정보를 보는 방법을 보여주는 예시를 제공합니다.

QuotaInfo는 지정된 프로젝트, 폴더 또는 조직의 특정 할당량에 대한 메타데이터와 할당량 값 정보를 제공하는 읽기 전용 리소스입니다.

특정 서비스의 할당량 정보 보기

특정 서비스의 할당량 정보를 보려면 다음 명령어를 실행합니다.

gcloud alpha quotas info describe QUOTA_ID --service=SERVICE_NAME \
    --project=PROJECT_ID_OR_NUMBER --billing-project=BILLING_PROJECT_ID_OR_NUMBER

다음을 바꿉니다.

QUOTA_ID: 할당량 ID 값입니다. 이 값을 찾으려면 할당량 ID 찾기를 참조하세요.
SERVICE_NAME: 확인할 할당량이 있는 서비스 이름입니다. 예를 들어 Compute Engine의 서비스 이름은 compute.googleapis.com입니다.
PROJECT_ID_OR_NUMBER: 프로젝트 ID 또는 프로젝트 번호입니다.
BILLING_PROJECT_ID_OR_NUMBER: 할당량 및 결제에 사용되는 프로젝트 ID 또는 프로젝트 번호입니다. gcloud 명령어를 실행하면 REST 또는 RPC API를 통해 직접 동등한 요청을 한 것처럼 할당량이 영향을 받습니다.

할당량을 사용할 프로젝트를 지정합니다. 할당량 정보를 보려는 서비스가 포함된 프로젝트와 다를 수 있습니다.

gcloud CLI를 설정할 때 이미 결제 프로젝트를 설정한 경우 이 플래그는 선택사항입니다. 그렇지 않고 생략하면 권한 거부 오류가 발생할 수 있습니다. 자세한 내용은 할당량 프로젝트 설정을 참조하세요.

조직의 할당량 정보 보기

조직의 동일한 서비스 할당량 세부정보를 보려면 다음 명령어를 실행합니다.

gcloud alpha quotas info list --service=SERVICE_NAME --organization=ORGANIZATION_ID \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

다음을 바꿉니다.

SERVICE_NAME: 확인할 할당량이 있는 서비스 이름입니다. 예를 들어 Compute Engine의 서비스 이름은 compute.googleapis.com입니다.
ORGANIZATION_ID: 조직 ID입니다.
BILLING_PROJECT_ID_OR_NUMBER: 할당량 및 결제에 사용되는 프로젝트 ID 또는 프로젝트 번호입니다. gcloud 명령어를 실행하면 REST 또는 RPC API를 통해 직접 동등한 요청을 한 것처럼 할당량이 영향을 받습니다.

할당량을 사용할 프로젝트를 지정합니다. 할당량 정보를 보려는 서비스가 포함된 프로젝트와 다를 수 있습니다.

gcloud CLI를 설정할 때 이미 결제 프로젝트를 설정한 경우 이 플래그는 선택사항입니다. 그렇지 않고 생략하면 권한 거부 오류가 발생할 수 있습니다. 자세한 내용은 할당량 프로젝트 설정을 참조하세요.

gcloud 할당량 환경설정 명령어 예시

이 섹션에서는 gcloud alpha quotas preferences 명령어를 사용하여 기존 할당량 환경설정을 확인하고 할당량 값을 조정하는 방법을 보여주는 예시를 제공합니다.

QuotaPreference 리소스는 특정 측정기준 조합에 대한 선호도를 나타냅니다. 측정기준은 리전이나 영역 또는 서비스별 측정기준(예: gpu_family 또는 network_id)을 나타내는 속성입니다.

기존 환경설정 확인

기존 환경설정을 확인하려면 다음 명령어를 실행합니다.

gcloud alpha quotas preferences list --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

다음을 바꿉니다.

PROJECT_ID_OR_NUMBER: 프로젝트 ID 또는 프로젝트 번호입니다.
BILLING_PROJECT_ID_OR_NUMBER: 할당량 및 결제에 사용되는 프로젝트 ID 또는 프로젝트 번호입니다. gcloud 명령어를 실행하면 REST 또는 RPC API를 통해 직접 동등한 요청을 한 것처럼 할당량이 영향을 받습니다.

할당량을 사용할 프로젝트를 지정합니다. 할당량 환경설정을 확인하는 프로젝트와 다를 수 있습니다.

gcloud CLI를 설정할 때 이미 결제 프로젝트를 설정한 경우 이 플래그는 선택사항입니다. 그렇지 않고 생략하면 권한 거부 오류가 발생할 수 있습니다. 자세한 내용은 할당량 프로젝트 설정을 참조하세요.

할당량 조정이 대기 중인 기존 환경설정 확인

할당량 조정이 대기 중인 기존 환경설정을 확인하려면 다음 명령어와 같이 --reconciling-only=true 플래그를 추가합니다.

gcloud alpha quotas preferences list --project=PROJECT_ID_OR_NUMBER --reconciling-only=true \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

다음을 바꿉니다.

PROJECT_ID_OR_NUMBER: 프로젝트 ID 또는 프로젝트 번호입니다.
BILLING_PROJECT_ID_OR_NUMBER: 할당량 및 결제에 사용되는 프로젝트 ID 또는 프로젝트 번호입니다. gcloud 명령어를 실행하면 REST 또는 RPC API를 통해 직접 동등한 요청을 한 것처럼 할당량이 영향을 받습니다.

할당량을 사용할 프로젝트를 지정합니다. 할당량 환경설정을 확인하는 프로젝트와 다를 수 있습니다.

gcloud CLI를 설정할 때 이미 결제 프로젝트를 설정한 경우 이 플래그는 선택사항입니다. 그렇지 않고 생략하면 권한 거부 오류가 발생할 수 있습니다. 자세한 내용은 할당량 프로젝트 설정을 참조하세요.

할당량 환경설정이 아직 설정되지 않은 경우 할당량 상향 조정 요청

환경설정이 아직 설정되지 않은 경우 특정 리전의 할당량 상향 조정을 요청하려면 다음 명령어를 실행합니다.

gcloud alpha quotas preferences create --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME  --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER --email=EMAIL --preference-id=PREFERENCE_ID

다음을 바꿉니다.

PREFERRED_VALUE: 선호하는 할당량 값입니다.
QUOTA_ID: 할당량 ID 값입니다. 이 값을 찾으려면 할당량 ID 찾기를 참조하세요.
SERVICE_NAME: 확인할 할당량이 있는 서비스 이름입니다. 예를 들어 Compute Engine의 서비스 이름은 compute.googleapis.com입니다.
PROJECT_ID_OR_NUMBER: 프로젝트 ID 또는 프로젝트 번호입니다.
BILLING_PROJECT_ID_OR_NUMBER: 할당량 및 결제에 사용되는 프로젝트 ID 또는 프로젝트 번호입니다. gcloud 명령어를 실행하면 REST 또는 RPC API를 통해 직접 동등한 요청을 한 것처럼 할당량이 영향을 받습니다.

할당량을 사용할 프로젝트를 지정합니다. 할당량 조정을 요청하는 프로젝트와 다를 수 있습니다.

gcloud CLI를 설정할 때 이미 결제 프로젝트를 설정한 경우 이 플래그는 선택사항입니다. 그렇지 않고 생략하면 권한 거부 오류가 발생할 수 있습니다. 자세한 내용은 할당량 프로젝트 설정을 참조하세요.
EMAIL: 추가 할당량을 부여하기 전에 Google Cloud에서 결정을 내리는 데 더 많은 정보가 필요한 경우 연락처로 사용할 수 있는 이메일 주소입니다.
PREFERENCE_ID: 선택적 환경설정 ID입니다. 환경설정 ID를 지정하지 않으면 API에서 범용 고유 식별자(UUID)를 자동으로 생성합니다.

할당량 환경설정이 설정된 경우 할당량 상향 조정 요청

특정 리전의 할당량 상향 조정을 요청하려고 하는데 이미 환경설정이 있는 경우 다음 명령어를 실행합니다.

gcloud alpha quotas preferences update PREFERENCE_ID --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
    --email=EMAIL --billing-project=BILLING_PROJECT_ID_OR_NUMBER

다음을 바꿉니다.

PREFERENCE_ID: 환경설정 ID입니다. gcloud alpha quotas preferences update 명령어를 사용할 때 첫 번째 인수로 필요합니다.
PREFERRED_VALUE: 선호하는 할당량 값입니다.
QUOTA_ID: 할당량 ID 값입니다. 이 값을 찾으려면 할당량 ID 찾기를 참조하세요.
SERVICE_NAME: 확인할 할당량이 있는 서비스 이름입니다. 예를 들어 Compute Engine의 서비스 이름은 compute.googleapis.com입니다.
PROJECT_ID_OR_NUMBER: 프로젝트 ID 또는 프로젝트 번호입니다.
EMAIL: 추가 할당량을 부여하기 전에 Google Cloud에서 결정을 내리는 데 더 많은 정보가 필요한 경우 연락처로 사용할 수 있는 이메일 주소입니다.
BILLING_PROJECT_ID_OR_NUMBER: 할당량 및 결제에 사용되는 프로젝트 ID 또는 프로젝트 번호입니다. gcloud 명령어를 실행하면 REST 또는 RPC API를 통해 직접 동등한 요청을 한 것처럼 할당량이 영향을 받습니다.

할당량을 사용할 프로젝트를 지정합니다. 할당량 조정을 요청하는 프로젝트와 다를 수 있습니다.

gcloud CLI를 설정할 때 이미 결제 프로젝트를 설정한 경우 이 플래그는 선택사항입니다. 그렇지 않고 생략하면 권한 거부 오류가 발생할 수 있습니다. 자세한 내용은 할당량 프로젝트 설정을 참조하세요.

측정기준을 사용하여 할당량 상향 조정 요청

측정기준을 사용하여 할당량 상향 조정을 요청하려면 다음 명령어를 실행합니다.

gcloud alpha quotas preferences create --preferred-value=PREFERRED_VALUE \
    --quota-id=QUOTA_ID --service=SERVICE_NAME --project=PROJECT_ID_OR_NUMBER \
    --dimensions=KEY1=VALUE1,KEY2=VALUE2,... --billing-project=BILLING_PROJECT_ID_OR_NUMBER \
    --email=EMAIL --justification=JUSTIFICATION --preference-id=PREFERENCE_ID

다음을 바꿉니다.

PREFERRED_VALUE: 선호하는 할당량 값입니다.
QUOTA_ID: 할당량 ID 값입니다. 이 값을 찾으려면 할당량 ID 찾기를 참조하세요.
SERVICE_NAME: 확인할 할당량이 있는 서비스 이름입니다. 예를 들어 Compute Engine의 서비스 이름은 compute.googleapis.com입니다.
PROJECT_ID_OR_NUMBER: 프로젝트 ID 또는 프로젝트 번호입니다.
KEY1=VALUE1,KEY2=VALUE2,...: 측정기준을 쉼표로 구분된 키-값 쌍 목록으로 지정하는 선택적 목록입니다. 예를 들어 측정기준에서 다음 Compute Engine 값을 지정할 수 있습니다.
- KEY1=VALUE1: region=us-east4
- KEY2=VALUE2: gpu_family=NVIDIA_H100
BILLING_PROJECT_ID_OR_NUMBER: 할당량 및 결제에 사용되는 프로젝트 ID 또는 프로젝트 번호입니다. gcloud 명령어를 실행하면 REST 또는 RPC API를 통해 직접 동등한 요청을 한 것처럼 할당량이 영향을 받습니다.

할당량을 사용할 프로젝트를 지정합니다. 할당량 조정을 요청하는 프로젝트와 다를 수 있습니다.

gcloud CLI를 설정할 때 이미 결제 프로젝트를 설정한 경우 이 플래그는 선택사항입니다. 그렇지 않고 생략하면 권한 거부 오류가 발생할 수 있습니다. 자세한 내용은 할당량 프로젝트 설정을 참조하세요.
EMAIL: 추가 할당량을 부여하기 전에 Google Cloud에서 결정을 내리는 데 더 많은 정보가 필요한 경우 연락처로 사용할 수 있는 이메일 주소입니다.
JUSTIFICATION: 요청을 설명하는 선택적 문자열입니다.
PREFERENCE_ID: 선택적 환경설정 ID입니다. 환경설정 ID를 지정하지 않으면 API에서 범용 고유 식별자(UUID)를 자동으로 생성합니다.

출력에는 구성과 관련된 데이터가 포함되며 다음 예시 출력과 유사하게 표시됩니다.

{
    "createTime":"CREATE_TIME",
    "dimensions":{
        "gpu_family":"NVIDIA_H100",
        "region":"us-east4"
    },
    "etag":"ETAG_VALUE",
    "name":"projects/12345/locations/global/quotaPreferences/PREFERENCE_ID",
    "quotaConfig":{
        "grantedValue":"0",
        "preferredValue":"128",
        "traceId":"TRACE_ID"
    },
    "quotaId":"GPUS-PER-GPU-FAMILY-per-project-region",
    "reconciling":true,
    "service":"compute.googleapis.com",
    "updateTime":"UPDATE_TIME",
}

기존 할당량 환경설정 보기

방금 만든 할당량 환경설정 세부정보를 보려면 다음 명령어를 실행합니다.

gcloud alpha quotas preferences describe PREFERENCE_ID \
    --project=PROJECT_ID_OR_NUMBER \
    --billing-project=BILLING_PROJECT_ID_OR_NUMBER

다음을 바꿉니다.

PREFERENCE_ID: 환경설정 ID입니다. gcloud alpha quotas preferences describe 명령어를 사용할 때 첫 번째 인수로 필요합니다.
PROJECT_ID_OR_NUMBER: 프로젝트 ID 또는 프로젝트 번호입니다.
BILLING_PROJECT_ID_OR_NUMBER: 할당량 및 결제에 사용되는 프로젝트 ID 또는 프로젝트 번호입니다. gcloud 명령어를 실행하면 REST 또는 RPC API를 통해 직접 동등한 요청을 한 것처럼 할당량이 영향을 받습니다.

할당량을 사용할 프로젝트를 지정합니다. 할당량 환경설정을 보고 있는 프로젝트와 다를 수 있습니다.

gcloud CLI를 설정할 때 이미 결제 프로젝트를 설정한 경우 이 플래그는 선택사항입니다. 그렇지 않고 생략하면 권한 거부 오류가 발생할 수 있습니다. 자세한 내용은 할당량 프로젝트 설정을 참조하세요.

출력에는 구성과 관련된 데이터가 포함되며 다음 예시 출력과 유사하게 표시됩니다.

createTime: 'CREATE_TIME'
dimensions:
  gpu_family: NVIDIA_H100
  region: us-east4
etag: ETAG_VALUE
name: projects/12345/locations/global/quotaPreferences/PREFERENCE_ID
quotaConfig:
  grantedValue: '0'
  preferredValue: '128'
  traceId: TRACE_ID
quotaId: GPUS-PER-GPU-FAMILY-per-project-region
reconciling: true
service: compute.googleapis.com
updateTime: 'UPDATE_TIME'

할당량 관련 gcloud CLI 명령어가 있는 기타 서비스

gcloud alpha quotas 외에도 일부 서비스는 할당량 및 리소스 사용량 정보에 대한 자체 명령줄에 액세스할 수 있습니다.

예를 들어 Compute Engine을 사용하면 할당량 정보에 액세스할 수 있습니다. 자세한 내용은 다음 Compute Engine 섹션을 참조하세요.

배정 할당량
gcloud CLI 컴퓨팅 개요
Google Cloud SDK 참조의 gcloud CLI 컴퓨팅 섹션입니다.

다음 단계

gcloud alpha quotas 명령어 관련 문제를 해결하려면 gcloud CLI 오류 문제 해결을 참조하세요.
gcloud alpha quotas 명령어와 플래그에 대한 자세한 내용은 Google Cloud CLI 참조의 gcloud 알파 할당량 섹션을 참조하세요.
할당량 용어에 대한 자세한 내용은 할당량 값 및 시스템 한도 이해를 참조하세요.