이 페이지에서는 사용 가능한 리전 및 영역 목록을 보는 방법과 특정 리전에 관한 정보를 가져오는 방법에 대해 설명합니다.
리전과 영역에 대해 자세히 알아보려면 리전 및 영역 문서를 참조하세요.
전역, 리전, 영역 Compute Engine 리소스에 대해 자세히 알아보려면 전역, 리전, 영역 리소스 문서를 참조하세요.
시작하기 전에
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. Google Cloud
로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.
Select the tab for how you plan to use the samples on this page:
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참고하세요.
-
필요한 역할
사용 가능한 리전 및 영역을 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 뷰어(roles/compute.viewer
) IAM 역할을 부여해달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
사용 가능한 영역 목록 보기
Google Cloud 콘솔의 영역 페이지에서 영역 목록을 봅니다.
Google Cloud CLI를 사용하여 gcloud compute zones list
명령어를 실행합니다.
gcloud compute zones list
zones.list
메서드에 GET
요청을 실행하여 프로젝트의 영역 목록을 가져옵니다. PROJECT_ID
를 프로젝트 ID로 바꿉니다.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /zones
GPU 영역 목록 보기
GPU를 지원하는 영역 목록을 보려면 gcloud CLI 또는 REST를 사용하면 됩니다.
GPU 유형으로 검색
GPU 유형으로 검색하려면 --filter
플래그와 함께 gcloud compute accelerator-types list
명령어를 사용하여 사용 가능한 영역을 찾습니다.
예를 들어 H100 80GB GPU가 있는 모든 영역을 찾으려면 다음 명령어를 실행합니다.
gcloud compute accelerator-types list --filter="nvidia-h100-80gb"
출력에는 영역별로 정리된 사용 가능한 GPU 목록이 반환됩니다. 그런 다음 gcloud compute accelerator-types describe
명령어를 사용하여 반환된 각 GPU 모델에 관한 설명을 가져올 수 있습니다.
머신 유형으로 검색
A3, A2 또는 G2 가속기 최적화 머신 유형의 경우 GPU가 VM에 자동으로 연결됩니다.
이러한 머신 유형의 경우 --filter
플래그와 함께 gcloud compute machine-types list
명령어를 사용하여 사용 가능한 영역을 찾을 수 있습니다. 예를 들어 A3 High 머신 유형이 있는 모든 영역을 찾으려면 다음 명령어를 실행합니다.
gcloud compute machine-types list --filter="name=a3-highgpu-8g"
GPU 유형으로 검색
특정 GPU 모델에 사용할 수 있는 영역을 보려면 --filter
매개변수를 사용하여 acceleratorTypes.aggregatedList
메서드에 GET
요청을 보냅니다 .
예를 들어 H100 80GB GPU가 있는 모든 영역을 찾으려면 다음 명령어를 실행합니다.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /aggregated/acceleratorTypes?filter=name=nvidia-h100-80gb
머신 유형으로 검색
A3, A2 또는 G2 가속기 최적화 머신 유형의 경우 GPU가 VM에 자동으로 연결됩니다.
이러한 머신 유형의 경우 --filter
매개변수와 함께 machineTypes.aggregatedList
메서드를 사용하여 사용 가능한 영역을 찾을 수 있습니다.
예를 들어 A3 High 머신 유형이 있는 모든 영역을 찾으려면 다음 명령어를 실행합니다.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /aggregated/machineTypes?filter=name=a3-higgpu-8
PROJECT_ID
를 프로젝트 ID로 바꿉니다.
출력은 사용 가능한 GPU 목록과 각 GPU 모델에 관한 설명을 영역별로 정리하여 반환합니다.
사용 가능한 리전 목록 보기
Google Cloud 콘솔의 영역 페이지에서 리전 목록을 봅니다.
Google Cloud CLI를 사용하여 gcloud compute regions list
명령어를 실행합니다.
gcloud compute regions list
이 명령어는 사용 가능한 모든 리전을 나열하고 할당량 및 리전 자체의 상태와 같은 정보를 제공합니다.
예를 들면 다음과 같습니다.
gcloud compute regions list NAME CPUS DISKS_GB ADDRESSES RESERVED_ADDRESSES STATUS asia-east1 0/24 0/10240 0/23 0/7 UP asia-northeast1 0/24 0/10240 0/23 0/7 UP asia-southeast1 0/24 0/10240 0/23 0/7 UP europe-west1 0/24 0/10240 2/23 0/7 UP us-central1 0/24 0/10240 0/23 0/7 UP us-east1 0/24 0/10240 0/23 0/7 UP us-west1 0/24 0/10240 0/23 0/7 UP
regions.list
메서드에 GET
요청을 실행하여 영역 목록을 가져옵니다. PROJECT_ID
를 프로젝트 ID로 바꿉니다.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /regions
리전에 관한 정보 보기
Google Cloud 콘솔의 영역 페이지에서 리전에 관한 정보를 볼 수 있습니다.
단일 리전에 대한 정보를 가져오려면 gcloud compute
regions describe
명령어를 실행합니다. 여기서 REGION
은 추가 정보를 가져올 리전의 이름입니다.
gcloud compute regions describeREGION
응답은 다음과 유사합니다.
creationTimestamp: '2013-09-06T17:54:12.193-07:00'
description: us-central1
id: '5778272079688511892'
kind: compute#region
name: us-central1
quotas:
- limit: 24.0
metric: CPUS
usage: 5.0
- limit: 5120.0
metric: DISKS_TOTAL_GB
usage: 650.0
- limit: 7.0
metric: STATIC_ADDRESSES
usage: 4.0
- limit: 23.0
metric: IN_USE_ADDRESSES
usage: 5.0
- limit: 1024.0
metric: SSD_TOTAL_GB
usage: 0.0
selfLink: https://www.googleapis.com/compute/v1/projects/PROJECT_ID /regions/us-central1
status: UP
zones:
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID /zones/us-central1-a
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID /zones/us-central1-b
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID /zones/us-central1-c
- https://www.googleapis.com/compute/v1/projects/PROJECT_ID /zones/us-central1-f
regions.get
메서드에 GET
요청을 전송하여 리전에 대한 정보를 가져옵니다. PROJECT_ID
를 프로젝트 ID로 바꾸고 REGION
을 추가 정보가 필요한 리전으로 바꿉니다.
https://compute.googleapis.com/compute/v1/projects/PROJECT_ID /regions/REGION
다음 단계
- 리전 및 영역에 대해 자세히 알아보기
- 기본 리전 또는 영역 변경 알아보기
- 전역, 리전, 영역 리소스에 대해 자세히 알아보기