Administrar etiquetas

En esta sección, aprenderás a adjuntar, desconectar y enumerar etiquetas en los recursos de Datastream, como transmisiones, perfiles de conexión o conexiones privadas. Para obtener una descripción general de las etiquetas en Datastream, consulta Control de acceso con etiquetas.

Acerca de las etiquetas de política

Una etiqueta es un par clave-valor que se puede adjuntar a un recurso dentro de Google 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 adjuntan a los recursos con la creación de un recurso de vinculación de etiqueta que vincula el valor al recurso de Google Cloud.

Si quieres agrupar transmisiones, perfiles de conexión o conexiones privadas dentro de Datastream para fines de automatización y facturación, usa etiquetas. Las etiquetas funcionan de forma independiente, y puedes aplicar ambas a los recursos.

Permisos necesarios

Los permisos que necesitas dependen de la acción que debes realizar.

Para obtener estos permisos, pídele a tu administrador que otorgue el rol sugerido en el nivel adecuado de la jerarquía de recursos.

Visualiza etiquetas

Para ver las definiciones y etiquetas de etiquetas que se adjuntan a los recursos, necesitas el rol visualizador de etiquetas (roles/resourcemanager.tagViewer) o bien otro rol que incluya los siguientes permisos:

Permisos necesarios

resourcemanager.tagKeys.get
resourcemanager.tagKeys.list
resourcemanager.tagValues.list
resourcemanager.tagValues.get
listTagBindings para el tipo de recurso adecuado. Por ejemplo, compute.instances.listTagBindings para ver las etiquetas adjuntas a las instancias de Compute Engine.
listEffectiveTags

compute.instances.listEffectiveTags

Para ver las etiquetas a nivel de la organización, necesitas el rol Visualizador de la organización (roles/resourcemanager.organizationViewer) en el recurso de la organización.

Administra etiquetas

Para crear, actualizar y borrar definiciones de etiquetas, necesitas el rol Administrador de etiquetas (roles/resourcemanager.tagAdmin) o algún otro rol que incluya los siguientes permisos:

Permisos necesarios

resourcemanager.tagKeys.create
resourcemanager.tagKeys.update
resourcemanager.tagKeys.delete
resourcemanager.tagKeys.list
resourcemanager.tagKeys.get
resourcemanager.tagKeys.getIamPolicy
resourcemanager.tagKeys.setIamPolicy
resourcemanager.tagValues.create
resourcemanager.tagValues.update
resourcemanager.tagValues.delete
resourcemanager.tagValues.list
resourcemanager.tagValues.get
resourcemanager.tagValues.getIamPolicy
resourcemanager.tagValues.setIamPolicy

Para administrar etiquetas a nivel de la organización, necesitas el rol Visualizador de la organización (roles/resourcemanager.organizationViewer) en el recurso de la organización.

Administra etiquetas en los recursos

Para agregar y quitar etiquetas adjuntas a los recursos, necesitas el rol Usuario de etiquetas (roles/resourcemanager.tagUser) o bien otro rol con permisos equivalentes, en el valor de etiqueta y los recursos a los que adjuntas el valor de etiqueta. El rol de Usuario de etiquetas incluye los siguientes permisos:

Permisos necesarios

Permisos necesarios para el recurso al que adjuntas el valor de la etiqueta

Permiso createTagBinding específico del recurso, como compute.instances.createTagBinding para instancias de Compute Engine.
Permiso deleteTagBinding específico del recurso, como compute.instances.deleteTagBinding para instancias de Compute Engine.

Permisos necesarios para el valor de etiqueta:

resourcemanager.tagValueBindings.create
resourcemanager.tagValueBindings.delete

Permisos que te permiten ver proyectos y definiciones de etiquetas:

resourcemanager.tagValues.get
resourcemanager.tagValues.list
resourcemanager.tagKeys.get
resourcemanager.tagKeys.list
resourcemanager.projects.get

Para adjuntar etiquetas a los recursos de Datastream, necesitas la función Administrador de Datastream (roles/datastream.admin) o alguna otra función que incluya los siguientes permisos:

Permisos necesarios

datastream.connectionProfiles.createTagBinding
datastream.connectionProfiles.deleteTagBinding
datastream.connectionProfiles.listTagBindings
datastream.connectionProfiles.listEffectiveTags
datastream.streams.createTagBinding
datastream.streams.deleteTagBinding
datastream.streams.listTagBindings
datastream.streams.listEffectiveTags
datastream.privateConnections.createTagBinding
datastream.privateConnections.deleteTagBinding
datastream.privateConnections.listTagBindings
datastream.privateConnections.listEffectiveTags

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.

Cómo adjuntar una etiqueta a una transmisión, un perfil de conexión o una conexión privada

Después de crear la etiqueta, debes adjuntarla a una transmisión, un perfil de conexión o una conexión privada.

Consola

Ve a la página Datastream en la consola de Google Cloud.

Ir a Datastream

Selecciona la página del recurso al que deseas adjuntar una etiqueta. Por ejemplo, para adjuntar una etiqueta a un perfil de conexión, ve a la página Perfiles de conexión.
Haz clic en Etiquetas.
Si tu organización no aparece en el panel Etiquetas, haz clic en Seleccionar alcance. Selecciona tu organización y haz clic en **Abrir**.
Haz clic en Agregar etiqueta (Add tag).
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 diálogo Confirmar, haz clic en Confirmar para adjuntar la etiqueta.

Una notificación confirma que se actualizaron tus etiquetas.

gcloud

Para adjuntar una etiqueta a una transmisión, un perfil de conexión o una conexión privada, debes crear un recurso de vinculación de etiquetas 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 de espacio de nombres del valor de la etiqueta que se adjunta; por ejemplo: tagValues/567890123456.
RESOURCE_ID es el ID completo del recurso, incluido el nombre de dominio de la API para identificar el tipo de recurso (//datastream.googleapis.com/). Por ejemplo, para adjuntar una etiqueta a projects/PROJECT_NAME/streams/STREAM_NAME, el ID completo es: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
LOCATION: Es la ubicación de tu recurso. Si adjuntas una etiqueta a un recurso global, como una carpeta o un proyecto, debes omitir esta marca. Si adjuntas una etiqueta a un recurso regional o zonal, debes especificar la ubicación, por ejemplo, us-central1 (región) o us-central1-a (zona).

Enumerar las etiquetas adjuntas a una transmisión, un perfil de conexión o una conexión privada

Puedes ver una lista de vinculaciones de etiquetas que la transmisión, el perfil de conexión o la conexión privada hereda o adjuntan de forma directa.

Consola

Ve a la página Datastream en la consola de Google Cloud.

Ir a Datastream

Selecciona la página del recurso para el que deseas ver las etiquetas. Por ejemplo, para ver las etiquetas del perfil de conexión, ve a la página Perfiles de conexión.

Las etiquetas se muestran en la columna Etiquetas de la transmisión, el perfil de conexión o la conexión privada.

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 es el ID completo del recurso, incluido el nombre de dominio de la API para identificar el tipo de recurso (//datastream.googleapis.com/). Por ejemplo, para adjuntar una etiqueta a projects/PROJECT_NAME/streams/STREAM_NAME, el ID completo es: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
LOCATION: Es la ubicación de tu recurso. Si ves una etiqueta adjunta a un recurso global, como una carpeta o un proyecto, debes omitir esta marca. Si ves una etiqueta adjunta a un recurso regional o zonal, debes especificar la ubicación, por ejemplo, us-central1 (región) o us-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: //datastream.googleapis.com/projects/project-abc/streams/stream-xyz<

Desconecta etiquetas de una transmisión, un perfil de conexión o una conexión privada

Puedes desconectar las etiquetas que se adjuntaron de forma directa a una transmisión, un perfil de conexión o una conexión privada. Las etiquetas heredadas se pueden anular adjuntando una etiqueta con la misma clave y un valor diferente, pero no se pueden desconectar. Antes de borrar una etiqueta, debes desconectar su clave y sus valores de cada recurso al que esté conectado.

Consola

Ve a la página Datastream en la consola de Google Cloud.

Ir a Datastream

Selecciona la página del recurso para el que deseas quitar una etiqueta. Por ejemplo, para quitar una etiqueta de un perfil de conexión, ve a la página Perfiles de conexión.
Haz clic en Etiquetas.
En el panel Etiquetas, junto a la etiqueta que deseas desvincular, haz clic en Borrar elemento.
Haz clic en Guardar.
En el diálogo Confirmar, haz clic en Confirmar para desconectar la etiqueta.

Una notificación confirma 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_NAME es el ID permanente o el nombre de espacio de nombres del valor de la etiqueta que se adjunta; por ejemplo: tagValues/567890123456.
RESOURCE_ID es el ID completo del recurso, incluido el nombre de dominio de la API para identificar el tipo de recurso (//datastream.googleapis.com/). Por ejemplo, para adjuntar una etiqueta a projects/PROJECT_NAME/streams/STREAM_NAME, el ID completo es: //datastream.googleapis.com/projects/PROJECT_NAME/streams/STREAM_NAME.
LOCATION: Es la ubicación de tu recurso. Si adjuntas una etiqueta a un recurso global, como una carpeta o un proyecto, debes omitir esta marca. Si adjuntas una etiqueta a un recurso regional o zonal, debes especificar la ubicación, por ejemplo, us-central1 (región) o us-central1-a (zona).

Borra claves y valores de etiqueta

Cuando quites una definición de clave o valor de etiqueta, asegúrate de que la etiqueta esté desconectada de la transmisión, el perfil de conexión o la conexión privada. 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.

Usar APIs de Datastream

Gestionar configuraciones de conectividad privada con la API