빠른 시작: Cloud Location Finder 사용 설정 및 쿼리 실행

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

시작하기 전에

  1. Google Cloud CLI를 설치합니다.
  2. Google Cloud CLI를 초기화하려면 다음 명령어를 실행합니다. 
    gcloud init
  3. Cloud Location Finder API를 사용 설정합니다. 
    gcloud services enable cloudlocationfinder.googleapis.com  --project PROJECT
  4. cloudlocationfinder.viewer 역할을 추가합니다. 
    gcloud projects add-iam-policy-binding PROJECT \
    --member USER_IDENTIFIER \
    --role roles/cloudlocationfinder.viewer
    • PROJECT를 프로젝트 ID로 바꿉니다.
    • USER_IDENTIFIER를 사용자 계정의 식별자로 바꿉니다. 예를 들어 user:myemail@example.com입니다.
  5. Cloud Location Finder를 사용하여 Google Distributed Cloud 연결 위치를 찾으려면 GDC Hardware Management API를 사용 설정하고 gdchardwaremanagement.reader 역할을 추가합니다. 
    gcloud projects add-iam-policy-binding PROJECT \
    --member USER_IDENTIFIER \
    --role roles/gdchardwaremanagement.reader

일반적인 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)" -H "X-Goog-User-Project: PROJECT "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 연결 영역 찾기

이 쿼리를 사용하여 특정 리전 내의 Distributed Cloud 연결 영역을 나열합니다.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT '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)" -H "X-Goog-User-Project: PROJECT "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 search \
    --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)" -H "X-Goog-User-Project: PROJECT "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

다음 단계