Gérer les abonnements

Vous pouvez gérer vos abonnements dans BigQuery Sharing (anciennement Analytics Hub) pour contrôler l'accès aux données et le partage. En tant qu'abonné, vous pouvez vous abonner à des fiches, afficher vos abonnements et les supprimer. En tant qu'éditeur, vous pouvez surveiller qui a accès à vos fiches et révoquer les abonnements si nécessaire. Un abonnement BigQuery Sharing est une ressource régionalisée qui réside dans le projet de l'abonné. Les abonnements stockent des informations sur l'abonné et représentent le contrat entre l'éditeur et l'abonné.

Avant de commencer

Pour commencer à utiliser BigQuery Sharing (anciennement Analytics Hub), vous devez activer l'API Analytics Hub dans votre Google Cloud projet.

Pour activer l'API Analytics Hub, vous devez disposer des autorisations IAM (Identity and Access Management) suivantes :

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

Le rôle IAM prédéfini suivant inclut les autorisations dont vous avez besoin pour activer l'API Analytics Hub :

Pour activer l'API Analytics Hub, sélectionnez l'une des options suivantes :

Console

Accédez à la page API Analytics Hub et activez l'API Analytics Hub pour votre Google Cloud projet.

Activer l'API Analytics Hub

gcloud

Exécutez la commande gcloud services enable :

gcloud services enable analyticshub.googleapis.com

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les abonnements, demandez à votre administrateur de vous accorder le rôle IAM Propriétaire d'abonnement Analytics Hub (roles/analyticshub.subscriptionOwner) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Limites

Les abonnements sont soumis aux limites suivantes :

  • Vous ne pouvez utiliser l'API Analytics Hub que pour gérer les abonnements créés après le 25 juillet 2023. Les ensembles de données associés créés avant cette date ne sont pas compatibles, car ils ne disposent pas de la ressource d'abonnement requise.

Gérer les abonnements en tant qu'abonné

Les sections suivantes décrivent comment les abonnés BigQuery Sharing gèrent les abonnements.

S'abonner à des fiches

Pour vous abonner à des fiches, suivez les étapes décrites dans Afficher les fiches et les échanges de données et s'y abonner.

Répertorier les abonnements

Pour répertorier vos abonnements dans un projet, appelez la projects.locations.subscriptions.list méthode :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet du Google Cloud projet contenant les abonnements que vous souhaitez répertorier.
  • LOCATION: emplacement des abonnements que vous souhaitez répertorier. Pour en savoir plus sur les emplacements compatibles avec le partage, consultez Régions compatibles.

Supprimer un abonnement

Pour supprimer un abonnement, appelez la projects.locations.subscriptions.delete méthode :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet du Google Cloud projet contenant l'abonnement que vous souhaitez supprimer.
  • LOCATION: emplacement de l'abonnement que vous souhaitez supprimer.
  • SUBSCRIPTION_ID: ID de l'abonnement que vous souhaitez supprimer.

Le corps de la requête doit être vide. En cas de réussite, le corps de la réponse contient une instance d'opération.

Lorsque vous supprimez un abonnement, l'ensemble de données associé est également supprimé de votre projet.

Lorsque vous supprimez un abonnement d'une fiche multirégionale, toutes les répliques d'ensemble de données associés primaires et secondaires sont également supprimées de votre projet.

Pour en savoir plus sur la gestion des abonnements à l'aide de l'API Analytics Hub, consultez les projects.locations.subscriptions méthodes.

Gérer les abonnements en tant qu'éditeur

Les sections suivantes décrivent comment les éditeurs BigQuery Sharing gèrent les abonnements. Pour en savoir plus sur la gestion des abonnements aux fiches, consultez Gérer les fiches.

Répertorier les abonnements

Pour répertorier tous les abonnements, sélectionnez l'une des options suivantes :

Console

  1. Dans la Google Cloud console, accédez à la page Partage (Analytics Hub).

    Accéder à Partage (Analytics Hub)

    La page répertorie tous les échanges de données auxquels vous pouvez accéder.

  2. Dans la liste des échanges de données, cliquez sur le nom de l'échange de données contenant les abonnements que vous souhaitez répertorier.

  3. Cliquez sur l'onglet Abonnements.

API

Pour répertorier les abonnements aux fiches d'un échange de données particulier, appelez la projects.locations.dataExchanges.listSubscriptions méthode :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du Google Cloud projet du projet contenant l'échange de données.
  • LOCATION: emplacement de l'échange de données contenant les abonnements que vous souhaitez répertorier.
  • DATAEXCHANGE_ID: ID de l'échange de données pour lequel répertorier les abonnements.

Révoquer un abonnement

Lorsque vous révoquez un abonnement en tant qu'éditeur BigQuery Sharing, l'abonné ne peut plus interroger l'ensemble de données associé. Étant donné que vous lancez cette action sur une ressource appartenant à un abonné, l'ensemble de données associé reste dans le projet de l'abonné. L'abonné peut supprimer l'ensemble de données.

Lorsque vous révoquez un abonnement d'une fiche multirégionale, les abonnés ne peuvent plus interroger les répliques d'ensemble de données associés primaires ou secondaires.

Pour révoquer un abonnement, sélectionnez l'une des options suivantes :

Console

  1. Dans la Google Cloud console, accédez à la page Partage (Analytics Hub).

    Accéder à Partage (Analytics Hub)

    La page répertorie tous les échanges de données auxquels vous pouvez accéder.

  2. Dans la liste des échanges de données, cliquez sur le nom de l'échange de données contenant l'abonnement que vous souhaitez révoquer.

  3. Cliquez sur l'onglet Abonnements.

  4. Cochez la case à côté de chaque abonnement que vous souhaitez révoquer.

  5. Cliquez sur Révoquer les abonnements.

API

Pour révoquer un abonnement, appelez la projects.locations.subscriptions.revoke méthode :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet du Google Cloud projet contenant l'abonnement que vous souhaitez révoquer.
  • LOCATION: emplacement de l'abonnement que vous souhaitez révoquer.
  • SUBSCRIPTION_ID: ID de l'abonnement que vous souhaitez révoquer.

Étape suivante