Datendomains verwalten

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Pre-GA-Angebotsbedingungen“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind "im Ist-Zustand" verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Mit Knowledge Catalog (ehemals Dataplex Universal Catalog) können Sie Datendomains und ‑subdomains über die Google Cloud Console und die REST API ansehen, aktualisieren und löschen. Sie können enthaltene Ressourcen prüfen, Anzeigenamen und Labels ändern oder leere Domains entfernen, um die Hierarchie an Ihre Geschäftsstruktur anzupassen.

Hinweis

Bevor Sie Data Domains verwalten, müssen Sie die erforderlichen Rollen und APIs aktivieren.

APIs aktivieren

Aktivieren Sie die Dataplex API, falls sie noch nicht aktiviert ist.

Erforderliche Rollen zum Aktivieren von APIs

Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen

API aktivieren

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Verwalten von Datendomains benötigen:

• Daten-Domains und Ressourcenbindungen aktualisieren: Dataplex Data Domain Configuration Editor (roles/dataplex.dataDomainEditor)
• Konfiguration der Datendomain und der Bindungen ansehen: Dataplex Data Domain Configuration Viewer (roles/dataplex.dataDomainViewer)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Daten-Domains und ‑Subdomains ansehen

Daten-Domains und -Subdomains in einem bestimmten Projekt ansehen.

Console

Alle Datendomains ansehen

1. Rufen Sie in der Google Cloud Console die Seite Daten-Domains auf.

   Zu „Daten-Domains“

2. In der Tabelle sind die erstellten Domains aufgeführt. Klicken Sie neben dem Namen der Datendomain auf den Maximierungspfeil, um die verschachtelten Subdomains aufzurufen.

Details zu Datendomains und Subdomains ansehen

1. Rufen Sie in der Google Cloud Console die Seite Daten-Domains auf.

   Zu „Daten-Domains“

2. Klicken Sie auf den Namen der Domain oder Subdomain, die Sie sich ansehen möchten.

3. Auf der Seite Domaindetails werden die folgenden Tabs angezeigt:

   • Übersicht: Hier finden Sie eine Übersicht über die Domain und eine Liste der erforderlichen und optionalen Aspekte.
   • Ressourcen: Listet die in dieser Domain enthaltenen Ressourcen auf. In der Liste werden nur Ordner, Projekte und Ressourcen angezeigt, die direkt in die Domain aufgenommen wurden.

REST

Daten-Domains und ‑Subdomains ansehen

Verwenden Sie die Methode projects.locations.dataDomains.list, um Datendomains aufzurufen:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: die ID Ihres Projekts in Google Cloud .
• LOCATION_ID: die Region Ihres Projekts. Beispiel: us-central1.

HTTP-Methode und URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains" | Select-Object -Expand Content

Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

Datensubdomains ansehen

Verwenden Sie die Methode projects.locations.dataDomains.listSubdomains, um Datensubdomains aufzurufen:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: die ID Ihres Projekts in Google Cloud .
• LOCATION_ID: die Region, in der sich die übergeordnete Datendomain befindet. Beispiel: us-central1.
• DOMAIN_ID: die eindeutige Kennung der übergeordneten Datendomain.

HTTP-Methode und URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/subdomains

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/subdomains"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID/subdomains" | Select-Object -Expand Content

Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

Mit dem Parameter filter können Sie Subdomains auflisten, die zu einer bestimmten übergeordneten Domain gehören:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: die ID Ihres Projekts in Google Cloud .
• LOCATION_ID: die Region, in der sich die übergeordnete Datendomain befindet. Beispiel: us-central1.
• PARENT_DOMAIN_ID: die eindeutige Kennung der übergeordneten Datendomain.

HTTP-Methode und URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?filter=parent_data_domain="projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/PARENT_DOMAIN_ID"

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?filter=parent_data_domain="projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/PARENT_DOMAIN_ID""

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains?filter=parent_data_domain="projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/PARENT_DOMAIN_ID"" | Select-Object -Expand Content

Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

Details zur Datendomain aufrufen

Verwenden Sie die Methode projects.locations.dataDomains.get, um Details zu einer Domain oder Subdomain abzurufen:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: die ID Ihres Projekts in Google Cloud .
• LOCATION_ID: die Region, in der sich die Datendomain befindet. Beispiel: us-central1.
• DOMAIN_ID: die eindeutige Kennung der Datendomain oder ‑subdomain.

HTTP-Methode und URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" | Select-Object -Expand Content

Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

Datendomain oder ‑subdomain aktualisieren

Sie können den Anzeigenamen, die Beschreibung und die Labels einer Domain aktualisieren. Sie können die Domain-ID oder den Standort nach dem Erstellen der Domain nicht mehr ändern.

Console

1. Rufen Sie in der Google Cloud Console die Seite Daten-Domains auf.

   Zu „Daten-Domains“

2. Klicken Sie auf den Namen der Domain oder Subdomain, um die Detailseite aufzurufen.

3. Klicken Sie in der oberen Leiste auf Bearbeiten.

4. Aktualisieren Sie den Anzeigenamen oder die Beschreibung.

5. Klicken Sie auf Speichern.

REST

Verwenden Sie die Methode projects.locations.dataDomains.patch, um eine Datendomain zu aktualisieren:

Hinweis: Sie müssen mit dem Abfrageparameter updateMask angeben, welche Felder aktualisiert werden sollen, damit andere Attribute nicht überschrieben werden.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: die ID Ihres Projekts in Google Cloud .
• LOCATION_ID: die Region, in der sich die Datendomain befindet. Beispiel: us-central1.
• DOMAIN_ID: die eindeutige Kennung der Datendomain oder ‑subdomain.

HTTP-Methode und URL:

PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID?updateMask=description,labels

JSON-Text anfordern:

{
  "description": "Updated description for the domain",
  "labels": {
    "status": "active"
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID?updateMask=description,labels"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID?updateMask=description,labels" | Select-Object -Expand Content

Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

Data Domain oder Subdomain löschen

Sie können nur eine leere Datendomain löschen. Sie müssen alle Subdomains löschen und alle mit der Domain verknüpften Ressourcenbindungen entfernen, bevor Sie die Domain selbst löschen können. Wenn die Domain nicht leer ist, schlägt die Löschanfrage mit einem Fehler fehl.

Console

1. Rufen Sie in der Google Cloud Console die Seite Daten-Domains auf.

   Zu „Daten-Domains“

2. Klicken Sie auf den Namen der Domain oder Subdomain, um die Detailseite aufzurufen.

3. Klicken Sie in der oberen Leiste auf Löschen.

4. Bestätigen Sie das Löschen, indem Sie den Namen der Datendomain oder -subdomain eingeben.

5. Klicken Sie auf Löschen.

REST

Verwenden Sie die Methode projects.locations.dataDomains.delete, um eine Datendomain zu löschen:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: die ID Ihres Projekts in Google Cloud .
• LOCATION_ID: die Region, in der sich die Datendomain befindet. Beispiel: us-central1.
• DOMAIN_ID: die eindeutige Kennung der Datendomain oder ‑subdomain.

HTTP-Methode und URL:

DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" | Select-Object -Expand Content

Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.

Nächste Schritte

• Weitere Informationen zu Datendomains
• Weitere Informationen zur Ressourcenbindung und -einbindung
• Daten-Domains erstellen
• Informationen zur Verwendung von Datendomains