Gestionar suscripciones

Como suscriptor de Analytics Hub, puedes hacer lo siguiente:

  • Suscríbete a una ficha.
  • Muestra las suscripciones que tienes en un proyecto determinado.
  • Eliminar una suscripción

Como editor de Analytics Hub, puede realizar las siguientes tareas:

  • Ver todas las suscripciones a tu ficha.
  • Revocar el acceso a una suscripción específica.

Una suscripción es un recurso regionalizado que reside en el proyecto del suscriptor. Las suscripciones almacenan información relevante sobre el suscriptor y representan el contrato entre el editor y el suscriptor.

Antes de empezar

Para empezar a usar la función de compartir de BigQuery (antes Analytics Hub), debe habilitar la API Analytics Hub en su Google Cloud proyecto.

Permisos obligatorios

Para habilitar la API Analytics Hub, necesitas los siguientes permisos de gestión de identidades y accesos (IAM):

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

El siguiente rol de gestión de identidades y accesos predefinido incluye los permisos que necesitas para habilitar la API Analytics Hub:

  • roles/serviceusage.serviceUsageAdmin

Para obtener más información sobre los roles de gestión de identidades y accesos en BigQuery, consulta el artículo sobre roles y permisos predefinidos.

Habilitar la API Analytics Hub

Para habilitar la API Analytics Hub, haz lo siguiente:

Consola

Ve a la página de la API Analytics Hub y habilítala en tu proyecto. Google Cloud

Habilitar la API Analytics Hub

gcloud

Ejecuta el comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Roles obligatorios

Para obtener los permisos que necesitas para gestionar suscripciones, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Propietario de la suscripción de Analytics Hub (roles/analyticshub.subscriptionOwner) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Flujo de trabajo de suscriptor

Los suscriptores pueden realizar las siguientes acciones con las suscripciones.

Suscribirse a fichas

Para suscribirte a fichas, sigue los pasos que se indican en el artículo Suscribirse a fichas.

Mostrar suscripciones

Para ver tus suscripciones actuales en un proyecto concreto, usa el método projects.locations.subscriptions.list:

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto que contiene las suscripciones que quieres enumerar.

  • LOCATION: la ubicación de la que quieres obtener una lista de las suscripciones.

Eliminar una suscripción

Para eliminar una suscripción, utiliza el método projects.locations.subscriptions.delete:

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto que contiene la suscripción que quieres eliminar.
  • LOCATION: la ubicación de la suscripción que quieres eliminar. Para obtener más información sobre las ubicaciones que admiten el uso compartido de BigQuery, consulta Regiones admitidas.
  • SUBSCRIPTION_ID: el ID de la suscripción que quieres eliminar.

El cuerpo de la solicitud debe estar vacío. Si la solicitud se realiza correctamente, el cuerpo de la respuesta contiene una instancia de la operación.

Si un suscriptor inicia la eliminación de una suscripción, se eliminará el conjunto de datos vinculado del proyecto del suscriptor.

Cuando se elimina una suscripción de una ficha de varias regiones (Vista previa), también se eliminan todas las réplicas de conjuntos de datos vinculados primarias y secundarias del proyecto del suscriptor.

Para obtener más información sobre las tareas que puedes realizar en las suscripciones con la API, consulta los métodos projects.locations.subscriptions.

Flujo de trabajo del editor

Los editores pueden realizar las siguientes acciones con las suscripciones. Para obtener más información sobre cómo gestionar las suscripciones a fichas, consulta Gestionar fichas.

Mostrar suscripciones

Para ver todas las suscripciones, selecciona una de las siguientes opciones.

Consola

  1. En la Google Cloud consola, vaya a la página Compartir (Analytics Hub).

    Ir a Compartir (Analytics Hub)

    Aparecerá una página con todas las transferencias de datos a las que puedes acceder.

  2. Haga clic en el nombre del intercambio de datos en el que quiera mostrar las suscripciones.

  3. Haga clic en la pestaña Suscripciones para ver todas las suscripciones a fichas en el intercambio de datos.

API

Para enumerar las suscripciones de Listings en un Data Exchange concreto, usa el método projects.locations.dataExchanges.listSubscriptions.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto de Intercambio de Datos del que quieres obtener la lista de suscripciones que quieres eliminar.
  • LOCATION: la ubicación del Intercambio de Datos del que quieres obtener la lista de suscripciones.
  • DATAEXCHANGE_ID: el ID del Intercambio de Datos del que quiere obtener la lista de suscripciones.

Revocar una suscripción

Cuando un editor revoca una suscripción, el suscriptor pierde la capacidad de consultar el conjunto de datos vinculado. Como se trata de una acción iniciada por el editor en un recurso propiedad del suscriptor, el conjunto de datos vinculado permanece colgado en el proyecto del suscriptor. El suscriptor puede eliminar el conjunto de datos huérfano.

Si un editor revoca una suscripción de una ficha para varias regiones (Vista previa), los suscriptores ya no podrán consultar ninguna réplica de conjunto de datos vinculada, ya sea principal o secundaria.

puede que afecte a tus clientes y que infrinjas los términos del servicio de Cloud Marketplace.

Para revocar una suscripción, selecciona una de las siguientes opciones:

Consola

  1. En la Google Cloud consola, vaya a la página Compartir (Analytics Hub).

    Ir a Compartir (Analytics Hub)

    Aparecerá una página con todos los intercambios de datos a los que tienes acceso.

  2. Haga clic en el nombre del intercambio de datos en el que quiera crear la ficha.

  3. Haz clic en la pestaña Suscripciones para ver todas las suscripciones al intercambio de datos.

  4. Selecciona la casilla situada junto a las suscripciones que quieras revocar o selecciona todas las suscripciones.

  5. Haz clic en Revocar suscripciones.

API

Para revocar una suscripción, usa el método projects.locations.subscriptions.revoke.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto de la suscripción que quieres revocar.
  • LOCATION: la ubicación de la suscripción.
  • SUBSCRIPTION_ID: el ID de la suscripción que quieres revocar.

Limitaciones

Las suscripciones están sujetas a las siguientes limitaciones:

  • Los conjuntos de datos vinculados creados antes del 25 de julio del 2023 no se rellenan. Solo las suscripciones creadas después del 25 de julio del 2023 funcionan con los métodos de la API.

Siguientes pasos