Administra las suscripciones

En este documento, se describe cómo administrar las suscripciones en BigQuery sharing (anteriormente Analytics Hub), que abarca tareas para suscriptores y publicadores.

Los suscriptores de BigQuery sharing pueden hacer lo siguiente:

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

Los publicadores de BigQuery sharing pueden hacer lo siguiente:

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

Una suscripción de BigQuery sharing 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 dentro de tu Cloud de Confiance by S3NS proyecto.

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:

• Administrador de Service Usage (roles/serviceusage.serviceUsageAdmin)

Para habilitar la API de Analytics Hub, selecciona una de las siguientes opciones:

gcloud services enable analyticshub.googleapis.com

Roles obligatorios

Para obtener los permisos que necesitas para administrar las suscripciones, pídele a tu administrador que te otorgue el rol de IAM Propietario de suscripción de 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.

Flujos de trabajo de los suscriptores para administrar suscripciones

En esta sección, se describe cómo los suscriptores de BigQuery sharing administran las suscripciones.

Suscríbete a fichas

Para suscribirte a fichas, sigue los pasos que se indican en Visualiza fichas e intercambios de datos y suscríbete a ellos.

Enumerar suscripciones

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

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

Reemplaza lo siguiente:

• PROJECT_ID: el Cloud de Confiance ID del proyecto para las suscripciones que deseas enumerar.
• LOCATION: la ubicación de las suscripciones que deseas enumerar.

Borra una suscripción

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

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

Reemplaza lo siguiente:

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

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

Cuando un suscriptor de BigQuery sharing borra una suscripción, también se borra el conjunto de datos vinculado del proyecto del suscriptor.

Cuando borras una suscripción de una ficha multirregional, también se borran todas las réplicas de conjuntos de datos vinculados primarias y secundarias del proyecto del suscriptor.

Para obtener más información sobre la administración de suscripciones con la API, consulta los projects.locations.subscriptions métodos.

Flujos de trabajo del publicador para administrar suscripciones

En esta sección, se describe cómo los publicadores de BigQuery sharing administran las 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 de BigQuery sharing revoca una suscripción, el suscriptor ya no puede consultar el conjunto de datos vinculado. Dado que el publicador inicia esta acción en un recurso propiedad del suscriptor, el conjunto de datos vinculado permanece en el proyecto del suscriptor. El suscriptor puede quitar el conjunto de datos borrándolo.

Si un publicador revoca una suscripción de una ficha multirregional, los suscriptores ya no podrán consultar ninguna réplica de conjunto de datos vinculado primaria o secundaria.

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 tienen las siguientes limitaciones:

• Solo puedes usar la API para administrar las suscripciones creadas después del 25 de julio de 2023. Los conjuntos de datos vinculados creados antes de esta fecha no son compatibles porque no tienen el recurso de suscripción requerido.

¿Qué sigue?

• Lee sobre la arquitectura de BigQuery sharing.
• Obtén información para ver fichas e intercambios de datos y suscribirte a ellos.
• Obtén información sobre los roles de usuario de BigQuery sharing.
• Obtén información para crear conjuntos de datos.
• Obtén información sobre el registro de auditoría de BigQuery sharing.