Puedes adjuntar etiquetas a los siguientes recursos de Cloud VPN:
- Puerta de enlace de VPN externa
- Puerta de enlace de VPN
- Túnel VPN
- Puerta de enlace de VPN de destino
Acerca de las etiquetas de política
Una etiqueta es un par clave-valor que se puede adjuntar a un recurso dentro deGoogle Cloud. Puedes usar etiquetas para permitir o denegar políticas de forma condicional en función de si un recurso tiene una etiqueta específica. Por ejemplo, puedes otorgar de forma condicional roles de Identity and Access Management (IAM) en función de si un recurso tiene una etiqueta específica. Para obtener más información sobre las etiquetas, consulta Descripción general de las etiquetas.
Las etiquetas se conectan a los recursos con la creación de un recurso de vinculación de etiqueta que vincula el valor al recurso Google Cloud .
Permisos necesarios
Para obtener los permisos que necesitas para administrar etiquetas, pídele a tu administrador que te otorgue los siguientes roles de IAM:
- Visualizador de etiquetas (
roles/resourcemanager.tagViewer) en los recursos a los que se adjuntan las etiquetas -
Ver y administrar etiquetas a nivel de la organización:
Visualizador de la organización (
roles/resourcemanager.organizationViewer) en la organización -
Crear, actualizar y borrar definiciones de etiquetas:
Administrador de etiquetas (
roles/resourcemanager.tagAdmin) en el recurso para el que creas, actualizas o borras etiquetas -
Adjuntar y quitar etiquetas de los recursos:
Usuario de etiquetas (
roles/resourcemanager.tagUser) en el valor de la etiqueta y los recursos a los que adjuntas o quitas el valor de la etiqueta
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.
Para adjuntar etiquetas a los recursos de Cloud VPN, necesitas el rol de administrador de red de Compute (roles/compute.networkAdmin).
Crea claves y valores de etiqueta
Antes de poder adjuntar una etiqueta, debes crear una y configurar su valor. Para crear claves y valores de etiqueta, consulta Crea una etiqueta y Agrega un valor a una etiqueta.
Agrega etiquetas durante la creación de recursos
Puedes agregar etiquetas cuando creas recursos de VPN. Si agregas etiquetas, podrás proporcionar al instante metadatos esenciales para tus recursos de VPN y, además, mejorar la organización, el seguimiento de costos y la aplicación automática de políticas.
gcloud
Para adjuntar una etiqueta a una puerta de enlace de VPN durante la creación del recurso, debes agregar la marca --resource-manager-tags al comando gcloud compute vpn-gateways create:
gcloud compute vpn-gateways create VPN_GATEWAY_NAME \
--network=NETWORK_NAME \
--resource-manager-tags=tagKeys/TAGKEY_ID=tagValues/TAGVALUE_ID
Reemplaza lo siguiente:
VPN_GATEWAY_NAME: Es el nombre de tu puerta de enlace de VPN.NETWORK_NAME: Es el nombre de la red a la que pertenece la puerta de enlace de VPN.TAGKEY_ID: El ID numérico de clave de etiquetaTAGVALUE_ID: Es el ID numérico permanente del valor de la etiqueta que se adjunta; por ejemplo,4567890123.
Para especificar varias etiquetas, sepáralas con una coma, por ejemplo, TAGKEY1=TAGVALUE1,TAGKEY2=TAGVALUE2.
API
Envía una solicitud POST a la siguiente URL:
POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/vpnGatewaysProporciona el siguiente JSON en el cuerpo de la solicitud:
{
"name": "VPN_GATEWAY_NAME",
"network": "projects/PROJECT/global/networks/NETWORK_NAME",
"params": {
"resourceManagerTags": {
"tagKeys/TAGKEY_ID": "tagValues/TAGVALUE_ID"
},
}
// Other fields omitted
}Reemplaza lo siguiente:
VPN_GATEWAY_NAME: Es el nombre de tu puerta de enlace de VPN.NETWORK_NAME: Es el nombre de la red a la que pertenece la puerta de enlace de VPN.TAGKEY_ID: El ID numérico de clave de etiquetaTAGVALUE_ID: Es el ID numérico permanente del valor de la etiqueta que se adjunta; por ejemplo,4567890123.
Agrega etiquetas a recursos existentes
Para agregar una etiqueta a los recursos existentes de Cloud VPN, sigue estos pasos:
Console
- Ve a la página Cloud VPN en la consola de Google Cloud .
- Selecciona el recurso de Cloud VPN al que deseas adjuntar una etiqueta.
- Haz clic en Etiquetas.
- Si tu organización no aparece en el panel Etiquetas, haz clic en Seleccionar permiso. Selecciona tu organización y haz clic en Abrir.
- Haz clic en Agregar etiqueta.
- Selecciona la clave para la etiqueta que deseas adjuntar de la lista. Puedes filtrar la lista escribiendo palabras clave.
- Selecciona el valor de la etiqueta que deseas adjuntar de la lista. Puedes filtrar la lista escribiendo palabras clave.
- Haz clic en Guardar.
- En el cuadro de diálogo Confirmar, haz clic en Confirmar para adjuntar la etiqueta.
Aparecerá una notificación para confirmar que se actualizaron tus etiquetas.
gcloud
Para adjuntar una etiqueta a un recurso de Cloud VPN, debes crear un recurso de vinculación de etiqueta con el comando gcloud resource-manager tags bindings create:
gcloud resource-manager tags bindings create \
--tag-value=TAGVALUE_NAME \
--parent=RESOURCE_ID \
--location=LOCATION
Reemplaza lo siguiente:
TAGVALUE_NAME: Es el ID permanente o el nombre con espacio de nombres del valor de la etiqueta que adjuntas a un recurso, por ejemplo,tagValues/567890123456.-
RESOURCE_ID: el ID completo del recurso, incluido el nombre de dominio de la API para identificar el tipo de recurso (//compute.googleapis.com/). Debes usar los IDs numéricos para los recursos, no sus nombres.Por ejemplo:
- El ID de recurso de un recurso global, como un recurso de REST de puerta de enlace de VPN externa en
projects/7890123456, es el siguiente://compute.googleapis.com/projects/7890123456/global/externalVpnGateways/4567891234 - El ID de recurso de un recurso regional, como un recurso de REST de túnel VPN en
projects/7890123456, es el siguiente://compute.googleapis.com/projects/7890123456/regions/REGION/vpnTunnels/6789012345
- El ID de recurso de un recurso global, como un recurso de REST de puerta de enlace de VPN externa en
LOCATION: es la ubicación de tu recurso. Si adjuntas una etiqueta a un recurso global, como una carpeta o un proyecto, omite esta marca. Si adjuntas una etiqueta a un recurso regional o zonal, debes especificar la ubicación; por ejemplo,us-central1(región) ous-central1-a(zona).
Enumera las etiquetas adjuntas a los recursos
Puedes ver una lista de vinculaciones de etiquetas adjuntas o heredadas por el recurso de Cloud VPN directamente.
Console
- Ve a la página Cloud VPN en la consola de Google Cloud .
- Selecciona el recurso para ver sus detalles. Las etiquetas se muestran en la fila Etiquetas.
gcloud
Para obtener una lista de vinculaciones de etiquetas adjuntas a un recurso, usa el comando gcloud resource-manager tags bindings list:
gcloud resource-manager tags bindings list \
--parent=RESOURCE_ID \
--location=LOCATION
Reemplaza lo siguiente:
-
RESOURCE_ID: el ID completo del recurso, incluido el nombre de dominio de la API para identificar el tipo de recurso (//compute.googleapis.com/). Debes usar los IDs numéricos para los recursos, no sus nombres.Por ejemplo:
- El ID de recurso de un recurso global, como un recurso de REST de puerta de enlace de VPN externa en
projects/7890123456, es el siguiente://compute.googleapis.com/projects/7890123456/global/externalVpnGateways/4567891234 - El ID de recurso de un recurso regional, como un recurso de REST de túnel VPN en
projects/7890123456, es el siguiente://compute.googleapis.com/projects/7890123456/regions/REGION/vpnTunnels/6789012345
- El ID de recurso de un recurso global, como un recurso de REST de puerta de enlace de VPN externa en
LOCATION: es la ubicación de tu recurso. Si ves una etiqueta adjunta a un recurso global, como una carpeta o un proyecto, omite esta marca. Si ves una etiqueta adjunta a un recurso regional o zonal, debes especificar la ubicación; por ejemplo,us-central1(región) ous-central1-a(zona).
Deberías recibir una respuesta similar a la que figura a continuación:
name: tagBindings/%2F%2Fcloudresourcemanager.googleapis.com%2Fprojects%2F7890123456/tagValues/567890123456
tagValue: tagValues/567890123456
resource:
//compute.googleapis.com/projects/7890123456/global/externalVpnGateways/4567891234
Desconecta etiquetas de recursos
Puedes desconectar las etiquetas que se adjuntaron directamente a un recurso de Cloud VPN. Las etiquetas heredadas se pueden anular conectando una etiqueta con la misma clave y un valor diferente, pero no se pueden desconectar.
Console
- Ve a la página Cloud VPN en la consola de Google Cloud .
- Selecciona el recurso de Cloud VPN del que deseas quitar una etiqueta.
- Haz clic en Etiquetas.
- En el panel Etiquetas, junto a la etiqueta que deseas desconectar, haz clic en Borrar elemento.
- Haz clic en Guardar.
- En el cuadro de diálogo Confirmar, haz clic en Confirmar para desconectar la etiqueta.
Aparecerá una notificación para confirmar que se actualizaron tus etiquetas.
gcloud
Para borrar una vinculación de etiqueta, usa el comando gcloud resource-manager tags bindings delete:
gcloud resource-manager tags bindings delete \
--tag-value=TAGVALUE_NAME \
--parent=RESOURCE_ID \
--location=LOCATION
Reemplaza lo siguiente:
TAGVALUE_NAMEes el ID permanente o el nombre de espacio de nombres del valor de la etiqueta que se adjunta; por ejemplo,tagValues/567890123456.-
RESOURCE_ID: el ID completo del recurso, incluido el nombre de dominio de la API para identificar el tipo de recurso (//compute.googleapis.com/). Debes usar los IDs numéricos para los recursos, no sus nombres.Por ejemplo:
- El ID de recurso de un recurso global, como un recurso de REST de puerta de enlace de VPN externa en
projects/7890123456, es el siguiente://compute.googleapis.com/projects/7890123456/global/externalVpnGateways/4567891234 - El ID de recurso de un recurso regional, como un recurso de REST de túnel VPN en
projects/7890123456, es el siguiente://compute.googleapis.com/projects/7890123456/regions/REGION/vpnTunnels/6789012345
- El ID de recurso de un recurso global, como un recurso de REST de puerta de enlace de VPN externa en
LOCATION: es la ubicación de tu recurso. Si adjuntas una etiqueta a un recurso global, como una carpeta o un proyecto, omite esta marca. Si adjuntas una etiqueta a un recurso regional o zonal, debes especificar la ubicación; por ejemplo,us-central1(región) ous-central1-a(zona).
Borra claves y valores de etiqueta
Cuando quites una definición de valor o clave de etiqueta, asegúrate de que la etiqueta esté desconectada del recurso de Cloud VPN. Debes borrar los adjuntos de etiqueta existentes, llamados vinculaciones de etiquetas, antes de borrar la definición de la etiqueta en sí. Para borrar claves y valores de etiqueta, consulta Borra etiquetas.
Etiquetas y condiciones de Identity and Access Management
Puedes usar etiquetas y condiciones de IAM para otorgar de forma condicional vinculaciones de roles a los usuarios en la jerarquía de tu proyecto. Cambiar o borrar la etiqueta adjunta a un recurso puede quitar el acceso del usuario a ese recurso si se aplicó una política de IAM con vinculaciones de funciones condicionales. Para obtener más información, consulta Etiquetas y condiciones de Identity and Access Management.
¿Qué sigue?
- Consulta los demás servicios que admiten etiquetas.
- Consulta Etiquetas y control de acceso para aprender a usar etiquetas con la IAM.