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

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

Versión preliminar

Este producto está con sujeción a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección de Términos Generales del Servicio de los Términos Específicos del Servicio. Los productos de la fase previa a la DG están disponibles sin modificaciones y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta página, se muestra cómo habilitar Cloud Location Finder con Google Cloud CLI y cómo encontrar ubicaciones de Cloud 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
   

Si ya instalaste Google Cloud CLI, ejecuta gcloud components update para asegurarte de tener la última versión disponible.

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 con el ID del proyecto.
   • Reemplaza USER_IDENTIFIER por el identificador de tu cuenta de usuario. Por ejemplo, user:[e-mail].

Explora las consultas comunes de Cloud Location Finder

Cloud Location Finder te permite consultar el repositorio de ubicaciones de la nube para identificar las ubicaciones cercanas según 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 de gRPC.

• Reemplaza PROJECT con 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 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.

Cómo encontrar la zona de nube más cercana

Usa esta consulta para identificar la zona Google Cloud más cercana a una ubicación de la nube con datos de proximidad para un proveedor de servicios en la nube que especifiques.

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

Encuentra todas las zonas de Google Distributed Cloud conectado 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)" '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"'

Cómo encontrar 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)" "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

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

Usa esta consulta para identificar las regiones con la huella de carbono más baja según la Energía sin emisiones de carbono para las regiones de Google Cloud .

Nota: Los datos de CFE solo están disponibles para Google Cloud ubicaciones.

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

¿Qué sigue?

• Revisa las ubicaciones admitidas
• Obtén más información sobre la sintaxis de las consultas de búsqueda de ubicación
• Consulta la referencia de la API.