Guia de início rápido: ativar o Cloud Location Finder e executar uma consulta

Esta página mostra como ativar o Cloud Location Finder usando a Google Cloud CLI e encontrar locais de nuvem por proximidade, jurisdição e pegada de carbono. É possível encontrar locais usando solicitações HTTP ou comandos da Google Cloud CLI.

Antes de começar

  1. Instale a Google Cloud CLI.
  2. Para inicializar a Google Cloud CLI, execute o seguinte comando: 
    gcloud init
  3. Ative a API Cloud Location Finder: 
    gcloud services enable cloudlocationfinder.googleapis.com  --project PROJECT
  4. Adicione o papel cloudlocationfinder.viewer: 
    gcloud projects add-iam-policy-binding PROJECT \
    --member USER_IDENTIFIER \
    --role roles/cloudlocationfinder.viewer
    • Substitua PROJECT pela ID do seu projeto.
    • Substitua USER_IDENTIFIER pelo identificador da sua conta de usuário. Por exemplo, user:myemail@example.com.
  5. Se você planeja encontrar locais conectados do Google Distributed Cloud usando o Cloud Location Finder, ative a API GDC Hardware Management e adicione o papel gdchardwaremanagement.reader: 
    gcloud projects add-iam-policy-binding PROJECT \
    --member USER_IDENTIFIER \
    --role roles/gdchardwaremanagement.reader

Conheça as consultas comuns do Cloud Location Finder

O Cloud Location Finder permite consultar o repositório de locais de nuvem para identificar locais próximos com base na proximidade, código do território ou consumo de energia livre de carbono (CFE, na sigla em inglês) do Google. As seções a seguir fornecem exemplos comuns de como interagir com o repositório do Cloud Location Finder.

O Cloud Location Finder usa a sintaxe de transcodificação gRPC.

  • Substitua PROJECT pela ID do seu projeto.
  • Substitua CLOUD_REGION pela região de nuvem de origem para encontrar o local mais próximo, incluindo o prefixo do provedor de nuvem. Por exemplo, gcp-us-central1 ou aws-us-east-1.
  • Substitua CLOUD_PROVIDER pelo provedor de nuvem para encontrar o local mais próximo. Por exemplo, AWS ou GCP.

Encontrar a zona de nuvem mais próxima

Use essa consulta para identificar a zona mais próxima de um local de nuvem usando dados de proximidade de um provedor de nuvem especificado. Google Cloud

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT "https://cloudlocationfinder.googleapis.com/v1/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 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

Encontrar todas as zonas conectadas do Google Distributed Cloud em uma região

Use essa consulta para listar as zonas conectadas do Distributed Cloud em uma região específica.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT 'https://cloudlocationfinder.googleapis.com/v1/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"'

Encontrar regiões em um território específico

Use essa consulta para identificar regiões em um território ou jurisdição específica usando um código de território fornecido.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT "https://cloudlocationfinder.googleapis.com/v1/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 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

Listar locais de nuvem que minimizam a pegada de carbono

Use essa consulta para identificar regiões com a menor pegada de carbono com base em Energia livre de carbono para Google Cloud regiões.

HTTP

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "X-Goog-User-Project: PROJECT "https://cloudlocationfinder.googleapis.com/v1/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 cloudlocationfinder cloud-locations list \
    --filter="cloud_provider=CLOUD_PROVIDER_CLOUD_PROVIDER AND cloud_location_type=CLOUD_LOCATION_TYPE_REGION" \
    --limit=5

A seguir