BigQuery Sharing-Rollen konfigurieren

Console

1. Rufen Sie IAM für das Projekt auf.

   IAM aufrufen

2. Klicken Sie auf „person_add“ Zugriffsrechte erteilen.

3. Geben Sie die E-Mail-Adresse der Person oder Identität, der Sie Zugriff gewähren möchten, im Feld Neue Hauptkonten ein. Beispiel:

   • E-Mail-Adresse für Google-Konto: test-user@gmail.com
   • Google-Gruppe: admins@googlegroups.com
   • Dienstkonto: server@example.s3ns-system.iam.gserviceaccount.com
   • Google Workspace-Domain: example.com

4. Bewegen Sie in der Liste Rolle auswählen den Mauszeiger auf Analytics Hub und wählen Sie eine der folgenden Rollen aus:

   • Analytics Hub-Administrator
   • Analytics Hub Listing Admin
   • Analytics Hub Publisher
   • Analytics Hub Subscriber
   • Analytics Hub Subscription Owner
   • Analytics Hub-Betrachter

5. Optional: Wenn Sie den Zugriff auf Cloud de Confiance by S3NS Ressourcen genauer steuern möchten, fügen Sie eine bedingte Rollenbindung hinzu.

6. Speichern Sie die Änderungen.

   Sie können Projektadministratoren über dasselbe IAM-Steuerfeld löschen und aktualisieren.

gcloud

Wenn Sie Rollen auf Projektebene zuweisen möchten, verwenden Sie den Befehl gcloud projects add-iam-policy-binding:

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='PRINCIPAL' \
    --role='roles/analyticshub.admin'

Dabei gilt:

• PROJECT_ID: das Projekt, z. B. my-project-1.

• PRINCIPAL: eine gültige Identität, der Sie die Rolle zuweisen möchten. Beispiel:

  • E-Mail-Adresse des Google-Kontos: user:user@gmail.com
  • Google-Gruppe: group:admins@googlegroups.com
  • Dienstkonto: serviceAccount:server@example.s3ns-system.iam.gserviceaccount.com
  • Google Workspace-Domain: domain:example.com

API

1. Lesen Sie die vorhandene Richtlinie mit der entsprechenden getIamPolicy-Methode der Ressource. Für Projekte verwenden Sie die projects.getIamPolicy Methode.

   POST https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:getIamPolicy
   

   Ersetzen Sie PROJECT_ID durch das Projekt, z. B. my-project-1.

2. Bearbeiten Sie die Richtlinie mit einem Texteditor, um Hauptkonten und die zugehörigen Rollen hinzuzufügen. Verwenden Sie das folgende Format, um Mitglieder hinzuzufügen:

   • user:test-user@gmail.com
   • group:admins@example.com
   • serviceAccount:test123@example.domain.com
   • domain:example.domain.com

   Fügen Sie der Richtlinie beispielsweise die folgende Bindung hinzu, um group:admins@example.com die Rolle roles/analyticshub.admin zuzuweisen:

   {
    "members": [
      "group:admins@example.com"
    ],
    "role":"roles/analyticshub.admin"
   }
   

3. Verwenden Sie die Methode setIamPolicy, um die aktualisierte Richtlinie zu schreiben.

   Mit der Methodeproject.setIamPolicy können Sie beispielsweise eine Richtlinie auf Projektebene festlegen. Geben Sie im Anfragetext die aktualisierte IAM-Richtlinie aus dem vorherigen Schritt an.

   POST https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:setIamPolicy
   

   Ersetzen Sie PROJECT_ID durch die Projekt-ID.

Console

1. Rufen Sie in der Cloud de Confiance -Console die Seite Sharing (Analytics Hub) auf.

   Sharing (Analytics Hub) aufrufen

2. Klicken Sie auf den Namen des Datenpools, für den Sie Berechtigungen festlegen möchten.

3. Wechseln Sie zum Tab Details.

4. Klicken Sie auf person Berechtigungen festlegen.

5. Klicken Sie zum Hinzufügen von Prinzipalen auf person_add Prinzipale hinzufügen.

6. Fügen Sie im Feld Neue Prinzipale die E-Mail-Adressen hinzu, für die Sie den Zugriff gewähren möchten. Sie können auch allUsers verwenden, um eine Ressource öffentlich und für alle im Internet zugänglich zu machen, oder allAuthenticatedUsers, um sie nur für angemeldete Google-Nutzer zugänglich zu machen.

7. Wählen Sie im Menü Rolle auswählen die Option Analytics Hub und dann eine der folgenden IAM-Rollen (Identity and Access Management) aus:

   • Analytics Hub Admin
   • Analytics Hub Listing Admin
   • Analytics Hub Publisher
   • Analytics Hub Subscriber
   • Analytics Hub Subscription Owner
   • Analytics Hub Viewer

8. Klicken Sie auf Speichern.

API

1. Lesen Sie die vorhandene Richtlinie mit der Eintragsmethode getIamPolicy. Verwenden Sie dazu die Methode projects.locations.dataExchanges.getIamPolicy:

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:getIamPolicy
   

   Dabei gilt:

   • PROJECT_ID: die Projekt-ID, z. B. my-project-1.
   • LOCATION: der Standort für Ihren Datenpool. Verwenden Sie Kleinbuchstaben.
   • DATAEXCHANGE_ID: die Datenpool-ID.

   BigQuery Sharing (früher Analytics Hub) gibt die aktuelle Richtlinie zurück.

2. Bearbeiten Sie die Richtlinie mit einem Texteditor, um Mitglieder und ihre zugehörigen IAM-Rollen (Identity and Access Management) hinzuzufügen oder zu entfernen. Verwenden Sie das folgende Format, um Mitglieder hinzuzufügen:

   • user:test-user@gmail.com
   • group:admins@example.com
   • serviceAccount:test123@example.domain.com
   • domain:example.domain.com

   Fügen Sie der Richtlinie beispielsweise die folgende Bindung hinzu, um group:subscribers@example.com die Rolle roles/analyticshub.subscriber zuzuweisen:

   {
    "members": [
      "group:subscribers@example.com"
    ],
    "role":"roles/analyticshub.subscriber"
   }
   

3. Verwenden Sie die Methode projects.locations.dataExchanges.setIamPolicy, um die aktualisierte Richtlinie zu schreiben. Geben Sie im Anfragetext die aktualisierte IAM-Richtlinie aus dem vorherigen Schritt an.

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:setIamPolicy
   

   Geben Sie im Anfragetext die Eintragsdetails an. Wenn die Anfrage erfolgreich ist, enthält der Antworttext Details zum Eintrag.

Console

1. Rufen Sie in der Cloud de Confiance -Console die Seite Sharing (Analytics Hub) auf.

   Sharing (Analytics Hub) aufrufen

2. Klicken Sie auf den Namen des Datenaustauschs, der den Eintrag enthält.

3. Klicken Sie auf den Eintrag, für den Sie Nutzer hinzufügen möchten.

4. Klicken Sie auf person Berechtigungen festlegen.

5. Klicken Sie zum Hinzufügen von Prinzipalen auf „person_add“ Prinzipal hinzufügen.

6. Fügen Sie im Feld Neue Prinzipale die E-Mail-Adressen der Identität hinzu, auf die Sie Zugriff gewähren möchten.

7. Wählen Sie im Menü Rolle auswählen die Option Analytics Hub und dann eine der folgenden IAM-Rollen (Identity and Access Management) aus:

   • Analytics Hub Admin
   • Analytics Hub Listing Admin
   • Analytics Hub Publisher
   • Analytics Hub Subscriber
   • Analytics Hub Subscription Owner
   • Analytics Hub Viewer

8. Klicken Sie auf Speichern.

API

1. Lesen Sie die vorhandene Richtlinie mit der Eintragsmethode getIamPolicy. Verwenden Sie dazu die Methode projects.locations.dataExchanges.listings.getIamPolicy:

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:getIamPolicy
   

   Dabei gilt:

   • PROJECT_ID: die Projekt-ID, z. B. my-project-1.
   • LOCATION: der Standort des Datenpools, der den Eintrag enthält. Verwenden Sie Kleinbuchstaben.
   • DATAEXCHANGE_ID: die Datenpool-ID.
   • LISTING_ID: die ID des Eintrags.

   Sharing gibt die aktuelle Richtlinie zurück.

2. Bearbeiten Sie die Richtlinie mit einem Texteditor, um Mitglieder und ihre zugehörigen IAM-Rollen (Identity and Access Management) hinzuzufügen oder zu entfernen. Verwenden Sie das folgende Format, um Mitglieder hinzuzufügen:

   • user:test-user@gmail.com
   • group:admins@example.com
   • serviceAccount:test123@example.domain.com
   • domain:example.domain.com

   Fügen Sie der Richtlinie beispielsweise die folgende Bindung hinzu, um group:publishers@example.com die Rolle roles/analyticshub.publisher zuzuweisen:

   {
    "members": [
      "group:publishers@example.com"
    ],
    "role":"roles/analyticshub.publisher"
   }
   

3. Verwenden Sie die Methode projects.locations.dataExchanges.listings.setIamPolicy, um die aktualisierte Richtlinie zu schreiben. Geben Sie im Anfragetext die aktualisierte IAM-Richtlinie aus dem vorherigen Schritt an.

   POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING-ID:setIamPolicy
   

   Geben Sie im Anfragetext die Eintragsdetails an. Wenn die Anfrage erfolgreich ist, enthält der Antworttext Details zum Eintrag.