Guía de inicio rápido: Habilita Cloud Location Finder y ejecuta una consulta

En esta página, se muestra cómo habilitar Cloud Location Finder con la Google Cloud CLI y encontrar ubicaciones en la nube por proximidad, jurisdicción y huella de carbono. Puedes encontrar ubicaciones con solicitudes HTTP o comandos de Google Cloud CLI.

Antes de comenzar

  1. Instala Google Cloud CLI.
  2. Para inicializar Google Cloud CLI, ejecuta el siguiente comando: 
    gcloud init
  3. Habilita la API de Cloud Location Finder: 
    gcloud services enable cloudlocationfinder.googleapis.com  --project PROJECT
  4. Agrega el rol cloudlocationfinder.viewer: 
    gcloud projects add-iam-policy-binding PROJECT \
    --member USER_IDENTIFIER \
    --role roles/cloudlocationfinder.viewer
    • Reemplaza PROJECT por el ID del proyecto.
    • Reemplaza USER_IDENTIFIER por el identificador de tu cuenta de usuario. Por ejemplo, user:myemail@example.com.
  5. Si planeas encontrar ubicaciones conectadas de Google Distributed Cloud con Cloud Location Finder, habilita la API de GDC Hardware Management y agrega el rol gdchardwaremanagement.reader: 
    gcloud projects add-iam-policy-binding PROJECT \
    --member USER_IDENTIFIER \
    --role roles/gdchardwaremanagement.reader

Explora las consultas comunes de Cloud Location Finder

Cloud Location Finder te permite consultar el repositorio de ubicaciones en la nube para identificar ubicaciones cercanas en función de la proximidad, el código de territorio o el consumo de energía sin emisiones de carbono (CFE%) de Google. En las siguientes secciones, se proporcionan ejemplos comunes de cómo interactuar con el repositorio de Cloud Location Finder.

Cloud Location Finder usa la sintaxis de transcodificación gRPC.

  • Reemplaza PROJECT por el ID del proyecto.
  • Reemplaza CLOUD_REGION por la región de la nube de origen para encontrar la ubicación más cercana, incluido el prefijo del proveedor de servicios en la nube. Por ejemplo, gcp-us-central1 o aws-us-east-1.
  • Reemplaza CLOUD_PROVIDER por el proveedor de servicios en la nube para encontrar la ubicación más cercana. Por ejemplo, AWS o GCP.

Encuentra la zona de la nube más cercana

Usa esta consulta para identificar la zona más cercana a una ubicación en la nube con datos de proximidad para un proveedor de servicios en la nube que especifiques. 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

Encuentra todas las zonas conectadas de Google Distributed Cloud en una región

Usa esta consulta para enumerar las zonas conectadas de Distributed Cloud dentro de una región específica.

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

Encuentra regiones dentro de un territorio específico

Usa esta consulta para identificar regiones dentro de un territorio o jurisdicción específicos con un código de territorio que proporciones.

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

Enumera las ubicaciones en la nube que minimizan la huella de carbono

Usa esta consulta para identificar las regiones con la huella de carbono más baja en función de la energía sin emisiones de carbono para Google Cloud regiones.

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

¿Qué sigue?