이 페이지에서는 사용 가능한 리전 및 영역 목록을 보는 방법과 특정 리전에 관한 정보를 가져오는 방법에 대해 설명합니다.
리전과 영역에 대해 자세히 알아보려면 리전 및 영역 문서를 참조하세요.
전역, 리전, 영역 Compute Engine 리소스에 대해 자세히 알아보려면 전역, 리전, 영역 리소스 문서를 참조하세요.
시작하기 전에
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다.
로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음과 같이 Compute Engine에 인증하면 됩니다.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
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 콘솔의 영역 페이지에서 영역 목록을 봅니다.
gcloud
Google Cloud CLI를 사용하여
gcloud compute zones list
명령어를 실행합니다.gcloud compute zones list
REST
zones.list
메서드에GET
요청을 실행하여 프로젝트의 영역 목록을 가져옵니다.PROJECT_ID
를 PROJECT_ID로 바꿉니다.https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones
GPU 영역 목록 보기
GPU를 지원하는 영역 목록을 보려면 gcloud CLI 또는 REST를 사용하면 됩니다.
gcloud
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"
REST
GPU 유형별로 검색
특정 GPU 모델에 사용할 수 있는 영역을 보려면
--filter
매개변수를 사용하여GET
요청을acceleratorTypes.aggregatedList
메서드로 보냅니다 .예를 들어 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 콘솔의 영역 페이지에서 리전 목록을 봅니다.
gcloud
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
REST
regions.list
메서드에GET
요청을 실행하여 영역 목록을 가져옵니다.PROJECT_ID
를 PROJECT_ID로 바꿉니다.https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions
리전에 관한 정보 보기
콘솔
Google Cloud 콘솔의 영역 페이지에서 리전에 관한 정보를 볼 수 있습니다.
gcloud
단일 리전에 대한 정보를 가져오려면
gcloud compute regions describe
명령어를 실행합니다. 여기서REGION
은 추가 정보를 가져올 리전의 이름입니다.gcloud compute regions describe REGION
응답은 다음과 유사합니다.
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
REST
regions.get
메서드에GET
요청을 전송하여 리전에 대한 정보를 가져옵니다.PROJECT_ID
를 PROJECT_ID로 바꾸고REGION
을 추가 정보가 필요한 리전으로 바꿉니다.https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-12-03(UTC)
-