Administrar suscripciones

Como suscriptor de Analytics Hub, puedes realizar las siguientes tareas:

• Suscríbete a una ficha.
• Enumera tus suscripciones actuales en un proyecto determinado.
• Borra una suscripción.

Como publicador de Analytics Hub, puedes realizar las siguientes tareas:

• Visualiza todas las suscripciones a tu ficha.
• Revoca 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 publicador y el suscriptor.

Antes de comenzar

Para comenzar a usar BigQuery sharing (anteriormente Analytics Hub), debes habilitar la API de Analytics Hub en tu Google Cloud proyecto.

Permisos necesarios

Para habilitar la API de Analytics Hub, necesitas los siguientes permisos de Identity and Access Management (IAM):

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

El siguiente rol predefinido de IAM incluye los permisos que necesitas para habilitar la API de Analytics Hub:

• roles/serviceusage.serviceUsageAdmin

Para obtener más información de los roles de IAM en BigQuery, consulta Funciones y permisos predefinidos.

Habilita la API de Analytics Hub

Para habilitar la API de Analytics Hub, haz lo siguiente:

gcloud services enable analyticshub.googleapis.com

Roles requeridos

Para obtener los permisos que necesitas para administrar suscripciones, pídele a tu administrador que te otorgue el rol de IAM Propietario de la suscripción a Analytics Hub (roles/analyticshub.subscriptionOwner) en el proyecto. 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.

Flujo de trabajo del suscriptor

Los suscriptores pueden realizar las siguientes acciones con las suscripciones.

Suscríbete a fichas

Para suscribirte a fichas, sigue los pasos que se indican en Suscríbete a fichas.

Enumerar suscripciones

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

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

Reemplaza lo siguiente:

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

• LOCATION: la ubicación para la que deseas enumerar las suscripciones existentes.

Borra una suscripción

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

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

Reemplaza lo siguiente:

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

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

Cuando un suscriptor inicia la acción de borrar una suscripción, se borra el conjunto de datos vinculado del proyecto del suscriptor.

Cuando se borra una suscripción de una ficha para varias regiones (versión preliminar), también se borran todas las réplicas de conjuntos de datos vinculados principales y secundarios 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 publicador

Los publicadores pueden realizar las siguientes acciones con suscripciones. Para obtener más información sobre la administración de suscripciones a fichas, consulta Administra fichas.

Enumerar suscripciones

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

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

Cómo revocar una suscripción

Cuando un publicador revoca una suscripción, el suscriptor pierde la capacidad de consultar el conjunto de datos vinculado. Dado que se trata de una acción iniciada por el publicador en un recurso propiedad del suscriptor, el conjunto de datos vinculado permanece pendiente en el proyecto del suscriptor. El suscriptor puede borrar el conjunto de datos pendiente para quitarlo.

Si un publicador revoca una suscripción de una ficha para varias regiones (versión preliminar), los suscriptores ya no podrán consultar ninguna réplica de conjuntos de datos vinculados primarios o secundarios.

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

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

Limitaciones

Las suscripciones están sujetos a las siguientes limitaciones:

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

¿Qué sigue?

• Obtén información sobre la arquitectura de uso compartido de BigQuery.
• Obtén información sobre cómo ver fichas y suscribirte a ellas.
• Obtén información sobre los roles de los usuarios de Analytics Hub.
• Obtén información sobre cómo crear conjuntos de datos.
• Obtén más información sobre el registro de auditoría del uso compartido de BigQuery.