En esta página, se explica cómo configurar una región o zona predeterminadas para tu proyecto de la consola de Google Cloud .
Cuando realizas una solicitud a Compute Engine, quizás se te solicite que proporciones una región o una zona, según los requisitos específicos de tu solicitud. Cualquier solicitud que incluya recursos regionales requiere que proporciones un nombre de región, y cualquier solicitud relacionada con recursos zonales requiere que proporciones un nombre de zona. Por ejemplo, debes especificar una región cuando creas una dirección IP externa estática y debes especificar una zona cuando creas una instancia de Compute Engine. Para obtener una lista completa de las regiones y zonas, consulta Regiones y zonas.
Para obtener más información sobre los recursos globales, regionales y zonales de Compute Engine, consulta Recursos globales, regionales y zonales.
Antes de comenzar
-
Si aún no lo hiciste, configura la autenticación.
La autenticación verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar
código o muestras desde un entorno de desarrollo local, puedes autenticarte en
Compute Engine seleccionando una de las siguientes opciones:
Selecciona la pestaña según cómo planeas usar las muestras de esta página:
Console
Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.
gcloud
-
Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando:
gcloud initSi usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.
-
- Configura una región y una zona predeterminadas.
Roles obligatorios
Para obtener los permisos que necesitas para ver o cambiar la configuración predeterminada de la región y la zona, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto:
-
Visualiza la configuración predeterminada de la región y la zona:
Visualizador de Compute (
roles/compute.viewer) -
Cambia la configuración predeterminada de la región y la zona:
- Administrador de instancias de Compute (v1) (
roles/compute.instanceAdmin.v1) - Administrador de Compute (
roles/compute.admin)
- Administrador de instancias de Compute (v1) (
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para ver o cambiar la configuración predeterminada de la región y la zona. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para ver o cambiar la configuración predeterminada de la región y la zona:
-
Visualiza la configuración predeterminada de la región y la zona:
compute.projects.get -
Cambia la configuración predeterminada de la región y la zona:
-
compute.projects.get -
compute.projects.setCommonInstanceMetadata
-
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Cómo una región y zona predeterminadas afectan a tu proyecto
La configuración de región y zona predeterminadas solo afecta a las herramientas del cliente, como Google Cloud CLI y la consola de Google Cloud . Cuando usas estas herramientas para crear solicitudes, estas te permiten administrar los recursos mediante la selección automática de la región y la zona predeterminadas.
Cuando usas la consola de Google Cloud para crear recursos regionales o zonales, como instancias y direcciones, Compute Engine establece los campos de región y zona por ti. Puedes aceptar los valores propagados previamente o cambiar los valores de forma explícita.
Cuando uses gcloud CLI, omite la configuración de las marcas --region y
--zone para usar las propiedades de región y zona predeterminadas para el proyecto
nuevo.
Siempre puedes cambiar la configuración predeterminada de región y zona en el servidor de metadatos, anular la región y zona predeterminadas para la gcloud CLI o anular manualmente la configuración de cada solicitud con la gcloud CLI o la consola de Google Cloud .
Busca la región o zona predeterminada
El servidor de metadatos contiene información de metadatos sobre un proyecto, incluidos el ID y el nombre del proyecto. Puedes consultar el servidor de metadatos para obtener y usar la información sobre el proyecto.
Si especificas una región y una zona predeterminadas para el proyecto, Compute Engine establece estos valores en el servidor de metadatos del proyecto.
Las regiones y zonas predeterminadas se establecen con los siguientes valores:
google-compute-default-regiongoogle-compute-default-zone
Para ver cuál es tu configuración de región y zona predeterminadas, ejecuta el siguiente comando gcloud y reemplaza PROJECT_ID por el ID del proyecto:
gcloud compute project-info describe --project PROJECT_ID
Busca los valores de metadatos de región y zona predeterminadas en la respuesta. Si faltan las claves y los valores de google-compute-default-region y google-compute-default-zone de la respuesta, significa que no se estableció ninguna región o zona predeterminadas.
Cambia la región o zona predeterminadas
No hay restricciones sobre las regiones o las zonas que puedes establecer para tus propiedades predeterminadas. Por ejemplo, es posible establecer una zona predeterminada que esté fuera de la región predeterminada. Verifica la configuración de región y zona predeterminadas cuando crees y administres tus recursos.
Console
Para cambiar la región o zona predeterminadas, sigue estos pasos:
En la consola de Google Cloud , ve a la página Configuración.
En el menú desplegable Región, selecciona una región predeterminada.
En el menú desplegable Zona, selecciona una zona predeterminada.
Haz clic en Guardar.
gcloud
Puedes cambiar la región y zona predeterminadas si realizas una solicitud al servidor de metadatos. Por ejemplo:
gcloud compute project-info add-metadata \
--metadata google-compute-default-region=europe-west1,google-compute-default-zone=europe-west1-b
Después de actualizar los metadatos predeterminados mediante cualquier método, ejecuta el comando gcloud init para reiniciar tu configuración default.
La gcloud CLI actualiza la configuración de la región y la zona predeterminadas
solo después de ejecutar el comando gcloud init.
Si deseas obtener más información sobre el uso de las opciones de gcloud CLI para establecer regiones y zonas predeterminadas, consulta Establece propiedades predeterminadas.
¿Qué sigue?
- Obtén más información sobre las regiones y zonas.
- Obtén más información sobre Recursos globales, regionales y zonales.