Google Cloud 콘솔, gcloud CLI 또는 REST를 사용하여 이러한 약정을 볼 수 있습니다.
시작하기 전에
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인합니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.
이 페이지의 샘플 사용 방법에 대한 탭을 선택하세요.
콘솔
Google Cloud 콘솔을 사용하여 Google Cloud 서비스 및 API에 액세스하는 경우 인증을 설정할 필요가 없습니다.
gcloud
-
Google Cloud CLI를 설치합니다. 설치 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다.
gcloud init외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
-
- 기본 리전 및 영역을 설정합니다.
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
Google Cloud CLI를 설치합니다.
외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.
필요한 역할
리소스 기반 약정을 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 뷰어 (roles/compute.viewer) 또는 Compute 관리자 (roles/compute.admin) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이 사전 정의된 역할에는 리소스 기반 약정을 보는 데 필요한 compute.commitments.get 및 compute.commitments.list 권한이 포함되어 있습니다.
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 가져올 수도 있습니다.
약정 목록 보기
Google Cloud 콘솔, gcloud CLI 또는 REST를 사용하여 프로젝트의 모든 약정 목록을 볼 수 있습니다.
콘솔
Google Cloud 콘솔에서 약정 사용 할인 페이지로 이동합니다. 약정 사용 할인으로 이동
특정 카테고리의 약정 목록을 보려면 다음 탭 중 하나를 선택합니다.
- 하드웨어 약정: vCPU, 메모리, GPU, 로컬 SSD 디스크, 단독 테넌트 노드와 같은 하드웨어 리소스의 약정을 보려면 이 탭을 선택합니다.
- 소프트웨어 라이선스 약정: OS 라이선스 약정을 보려면 이 탭을 선택합니다.
- 블록 스토리지 약정: Exapool 용량에 대한 약정을 보려면 이 탭을 선택합니다.
gcloud
특정 리전의 모든 약정을 나열하려면 gcloud compute commitments list 명령어를 사용합니다.
gcloud compute commitments list \
--regions=REGION \
--project=PROJECT_ID
다음을 바꿉니다.
REGION: 약정을 보려는 리전입니다.PROJECT_ID: 프로젝트 ID입니다.
예시
예를 들어 project-list-example 프로젝트를 사용하여 us-central1 리전 내의 약정을 나열하려면 다음 명령어를 실행합니다.
gcloud compute commitments list \
--regions=us-central1 \
--project=project-list-example
REST
특정 리전의 약정을 나열하려면 regionCommitments.list 메서드에 GET 요청을 수행합니다.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments
프로젝트의 모든 리전에서 약정을 나열하려면 regionCommitments.aggregatedList 메서드에 GET 요청을 수행합니다.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/commitments
다음을 바꿉니다.
PROJECT_ID: 약정을 보려는 프로젝트의 프로젝트 ID입니다.REGION: 약정을 보려는 리전입니다.
특정 약정의 세부정보 보기
다음과 같은 약정의 세부 속성을 볼 수 있습니다.
- 상태
- 약정 요금제
- 약정 시작 및 종료 시간
- 자동 갱신 설정
- 약정 리소스 유형 및 수량
Google Cloud 콘솔, gcloud CLI 또는 REST를 사용하여 약정을 볼 수 있습니다.
콘솔
Google Cloud 콘솔에서 약정 사용 할인 페이지로 이동합니다. 약정 사용 할인으로 이동
보려는 약정 카테고리의 탭을 선택합니다.
- 하드웨어 리소스의 약정을 보려면 하드웨어 약정 탭을 클릭합니다. 하드웨어 약정에는 vCPU, 메모리, GPU, 로컬 SSD 디스크, 단독 테넌트 노드가 포함됩니다.
- 프리미엄 소프트웨어 라이선스의 약정을 보려면 소프트웨어 라이선스 약정 탭을 선택합니다. 라이선스 약정에는 SUSE Linux Enterprise Server (SLES), SLES for SAP, Red Hat Enterprise Linux(RHEL)와 같은 운영체제 (OS) 라이선스가 포함됩니다.
- 네트워크 연결 스토리지 풀의 약정을 보려면 블록 스토리지 약정 탭을 선택합니다. 블록 스토리지 약정에는 Exapool 용량이 포함됩니다.
약정의 세부정보 페이지를 보려면 약정 이름을 클릭합니다.
gcloud
특정 약정을 설명하려면 gcloud compute commitments describe 명령어를 사용합니다.
gcloud compute commitments describe COMMITMENT_NAME \
--region=REGION \
--project=PROJECT_ID
다음을 바꿉니다.
COMMITMENT_NAME: 약정의 이름입니다.REGION: 약정이 있는 리전입니다.PROJECT_ID: 프로젝트 ID입니다.
예시
다음 예시에서는 myproject 프로젝트 및 us-central1 리전의 약정을 설명합니다.
예시 1: 하드웨어 약정 설명
기존 하드웨어 약정 (example-hardware-commitment)을 설명하려면 다음 명령어를 실행합니다.
gcloud compute commitments describe example-hardware-commitment \
--region=us-central1 \
--project=myproject
이 명령어는 다음과 유사한 약정 속성을 반환합니다.
autoRenew: true category: MACHINE creationTimestamp: '2025-05-15T09:30:00.000-07:00' endTimestamp: '2026-05-15T09:30:00.000-07:00' kind: compute#commitment name: example-hardware-commitment plan: TWELVE_MONTH region: https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1 resources: - amount: '4' type: VCPU - amount: '16384' type: MEMORY status: ACTIVE type: GENERAL_PURPOSE
예시 2: 블록 스토리지 약정 설명
기존 블록 스토리지 약정(example-block-storage-commitment)을 설명하려면 gcloud beta compute commitments describe 명령어를 실행합니다.
gcloud beta compute commitments describe example-block-storage-commitment \
--region=us-central1 \
--project=myproject
이 명령어는 다음과 유사하게 Exapool에 대한 약정 관계를 설정하여 약정 속성을 반환합니다.
autoRenew: true category: PERSISTENT_DISK creationTimestamp: '2025-08-20T14:45:00.000-07:00' endTimestamp: '2026-08-20T14:45:00.000-07:00' kind: compute#commitment name: example-block-storage-commitment persistentDiskResources: - amount: '102400' dimensionType: CAPACITY_OPTIMIZED productType: HYPERDISK_EXAPOOL_BALANCED plan: TWELVE_MONTH region: https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1 status: ACTIVE
REST
regionCommitments.get 메서드에 대해 GET 요청을 실행합니다.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/commitments/COMMITMENT_NAME
다음을 바꿉니다.
PROJECT_ID: 프로젝트의 프로젝트 IDREGION: 약정이 구매된 리전입니다.COMMITMENT_NAME: 약정의 이름입니다.
예시
다음 예시에서는 myproject 프로젝트 및 us-central1 리전에서 약정 세부정보를 검색합니다.
예시 1: 하드웨어 약정 설명
하드웨어 약정(example-hardware-commitment)의 속성을 검색하려면 다음 GET 요청을 수행합니다.
GET https://compute.googleapis.com/compute/v1/projects/myproject/regions/us-central1/commitments/example-hardware-commitment
응답에는 다음 출력과 유사한 하드웨어 약정 속성이 포함됩니다.
{
"autoRenew": true,
"category": "MACHINE",
"creationTimestamp": "2025-05-15T09:30:00.000-07:00",
"endTimestamp": "2026-05-15T09:30:00.000-07:00",
"kind": "compute#commitment",
"name": "example-hardware-commitment",
"plan": "TWELVE_MONTH",
"region": "https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1",
"resources": [
{
"amount": "4",
"type": "VCPU"
},
{
"amount": "16384",
"type": "MEMORY"
}
],
"status": "ACTIVE",
"type": "GENERAL_PURPOSE"
}
예시 2: 블록 스토리지 약정 설명
블록 스토리지 약정(example-block-storage-commitment)의 속성을 가져오려면 beta regionCommitments.get 메서드에 다음 GET 요청을 수행합니다.
GET https://compute.googleapis.com/compute/beta/projects/myproject/regions/us-central1/commitments/example-block-storage-commitment
응답에는 다음 JSON 출력과 유사하게 블록 스토리지 약정 용량을 나타내는 속성이 포함됩니다.
{
"autoRenew": true,
"category": "PERSISTENT_DISK",
"creationTimestamp": "2025-08-20T14:45:00.000-07:00",
"endTimestamp": "2026-08-20T14:45:00.000-07:00",
"kind": "compute#commitment",
"name": "example-block-storage-commitment",
"persistentDiskResources": [
{
"amount": "102400",
"dimensionType": "CAPACITY_OPTIMIZED",
"productType": "HYPERDISK_EXAPOOL_BALANCED"
}
],
"plan": "TWELVE_MONTH",
"region": "https://www.googleapis.com/compute/beta/projects/myproject/regions/us-central1",
"status": "ACTIVE"
}