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

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

Pré-lançamento

Este produto está sujeito aos "Termos da Oferta Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

Nesta página, mostramos como ativar o Localizador de locais do Cloud usando a Google Cloud CLI e encontrar locais do Cloud 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 CLI do Google Cloud.
2. Para inicializar a Google Cloud CLI, execute o seguinte comando:

   gcloud init
   

Se você já instalou a Google Cloud CLI, verifique se tem a versão mais recente disponível executando gcloud components update.

3. Ative a API Cloud Location Finder:

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

4. Adicionar 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:[e-mail].

Conheça consultas comuns do Cloud Location Finder

Com o Localizador de locais na nuvem, é possível consultar o repositório de locais na nuvem para identificar locais próximos com base na proximidade, no código do território ou no consumo de energia livre de carbono (CFE%) 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 da 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 esta consulta para identificar a zona Google Cloud mais próxima de um local na nuvem usando dados de proximidade de um provedor de nuvem especificado.

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

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

Use esta consulta para listar as zonas conectadas da nuvem distribuída em uma região específica.

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"'

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

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

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

Listar locais na nuvem que minimizam a pegada de carbono

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

Observação: os dados de CFE estão disponíveis apenas para Google Cloud locais.

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

A seguir

• Confira os locais com suporte.
• Saiba mais sobre a sintaxe de consulta de pesquisa de local.
• Confira a referência da API.