빠른 시작: Cloud 위치 찾기 사용 설정 및 쿼리 실행

이 페이지에서는 Google Cloud CLI를 사용하여 Cloud Location Finder를 사용 설정하고 근접성, 관할권, 탄소 발자국을 기준으로 클라우드 위치를 찾는 방법을 보여줍니다. HTTP 요청 또는 Google Cloud CLI 명령어를 사용하여 위치를 찾을 수 있습니다.

시작하기 전에

Google Cloud CLI를 설치합니다.
Google Cloud CLI를 초기화하려면 다음 명령어를 실행합니다.
```
gcloud init
```

Cloud Location Finder API를 사용 설정합니다.

gcloud services enable cloudlocationfinder.googleapis.com  --project PROJECT

cloudlocationfinder.viewer 역할 추가:
```
gcloud projects add-iam-policy-binding PROJECT \
    --member USER_IDENTIFIER \
    --role roles/cloudlocationfinder.viewer
```
- PROJECT를 프로젝트 ID로 바꿉니다.
- USER_IDENTIFIER를 사용자 계정의 식별자로 바꿉니다. 예: user:myemail@example.com

일반적인 Cloud Location Finder 쿼리 살펴보기

Cloud Location Finder를 사용하면 클라우드 위치 저장소를 쿼리하여 근접성, 지역 코드 또는 Google 무탄소 에너지 (CFE%) 소비를 기반으로 가까운 클라우드 위치를 식별할 수 있습니다. 다음 섹션에서는 Cloud Location Finder 저장소와 상호작용하는 일반적인 방법을 보여줍니다.

Cloud Location Finder는 gRPC 트랜스코딩 구문을 사용합니다.

PROJECT를 프로젝트 ID로 바꿉니다.
CLOUD_REGION을 소스 클라우드 리전으로 바꿔 클라우드 제공업체 접두사를 포함하여 가장 가까운 위치를 찾습니다. 예를 들면 gcp-us-central1 또는 aws-us-east-1입니다.
CLOUD_PROVIDER을 클라우드 제공업체로 바꿔 가장 가까운 위치를 찾습니다. 예를 들면 AWS 또는 GCP입니다.

가장 가까운 클라우드 영역 찾기

이 쿼리를 사용하여 지정한 클라우드 제공업체의 근접성 데이터를 사용하여 클라우드 위치에 가장 가까운 Google Cloud 영역을 식별합니다.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://cloudlocationfinder.googleapis.com/v1alpha/projects/PROJECT/locations/global/cloudLocations:search?source_cloud_location=projects/PROJECT/locations/global/cloudLocations/CLOUD_REGION&query=cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER%20AND%20cloud_location_type=CLOUD_LOCATION_TYPE_ZONE&page_size=1"

gcloud

gcloud alpha cloudlocationfinder cloud-locations search \
    --source-cloud-location=CLOUD_REGION \
    --query="cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER AND cloud_location_type=CLOUD_LOCATION_TYPE_ZONE" \
    --limit=1

리전의 모든 Google Distributed Cloud Connected 영역 찾기

이 쿼리를 사용하여 특정 리전 내의 분산 클라우드 연결 영역을 나열합니다.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" 'https://cloudlocationfinder.googleapis.com/v1alpha/projects/PROJECT/locations/global/cloudLocations?filter=containing_cloud_location="projects/PROJECT/locations/global/cloudLocations/CLOUD_REGION%20AND%20cloud_provider=CLOUD_PROVIDER_GCP%20AND%20cloud_location_type=CLOUD_LOCATION_TYPE_GDCC_ZONE"'

gcloud

gcloud cloudlocationfinder cloud-locations list --filter='cloud_provider=CLOUD_PROVIDER_GCP AND cloud_location_type=CLOUD_LOCATION_TYPE_GDCC_ZONE AND containing_cloud_location="projects/PROJECT/locations/global/cloudLocations/CLOUD_REGION"'

특정 지역 내의 지역 찾기

이 쿼리를 사용하여 사용자가 제공한 지역 코드를 통해 특정 지역 또는 관할 구역 내의 지역을 식별합니다.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://cloudlocationfinder.googleapis.com/v1alpha/projects/PROJECT/locations/global/cloudLocations:search?source_cloud_location=projects/PROJECT/locations/global/cloudLocations/CLOUD_REGION&query=cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER%20AND%20cloud_location_type=CLOUD_LOCATION_TYPE_REGION%20AND%20territory_code=TERRITORY_CODE&page_size=1"

gcloud

gcloud alpha cloudlocationfinder cloud-locations list \
    --source-cloud-location=CLOUD_REGION \
    --filter="cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER AND cloud_location_type=CLOUD_LOCATION_TYPE_REGION" AND filter="territory_code=\"TERRITORY_CODE\"" \
    --limit=1

탄소 발자국을 최소화하는 클라우드 위치 나열

이 쿼리를 사용하여 리전의 무탄소 에너지 Google Cloud 를 기준으로 탄소 발자국이 가장 낮은 리전을 식별합니다.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" "https://cloudlocationfinder.googleapis.com/v1alpha/projects/PROJECT/locations/global/cloudLocations?query=cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER%20AND%20cloud_location_type=CLOUD_LOCATION_TYPE_REGION&page_size=5"

gcloud

gcloud alpha cloudlocationfinder cloud-locations list \
    --filter="cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER AND cloud_location_type=CLOUD_LOCATION_TYPE_REGION" \
    --limit=5

다음 단계

지원되는 위치 검토
위치 검색어 구문에 대해 알아보기
API 참조 확인