Featuregruppen auflisten

Sie können eine Liste aller Featuregruppen abrufen, die für einen bestimmten Standort in Ihrem Google Cloud -Projekt erstellt wurden, sowie den URI der BigQuery-Quelltabelle oder -Ansicht, die jeder Featuregruppe zugeordnet ist.

Wenn eine Feature-Gruppe für die Verwendung eines speziellen Dienstkontos konfiguriert ist, enthalten die Details für diese Feature-Gruppe auch die zugehörige E-Mail-Adresse des Dienstkontos. Weitere Informationen zum Erstellen von Funktionsgruppen mit dedizierten Dienstkontokonfigurationen finden Sie unter Dienstkonto für eine Funktionsgruppe konfigurieren.

Hinweise

Authentifizieren Sie sich bei Vertex AI, sofern nicht bereits geschehen.

Select the tab for how you plan to use the samples on this page:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

REST

Wenn Sie die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, nutzen Sie die Anmeldedaten, die Sie der gcloud CLI bereitstellen.

    Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl: 

    gcloud init

    Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Weitere Informationen finden Sie in der Dokumentation zur Google Cloud -Authentifizierung unter Für die Verwendung von REST authentifizieren.

Featuregruppen auflisten

Verwenden Sie die folgenden Beispiele, um eine Liste aller Featuregruppen für einen bestimmten Standort in Ihrem Projekt abzurufen.

Konsole

So rufen Sie mit der Google Cloud -Konsole die Liste der Featuregruppen für einen bestimmten Standort auf:

  1. Rufen Sie im Bereich „Vertex AI“ der Google Cloud Console die Seite Feature Store auf.

    Zur Seite „Feature Store“

  2. Im Bereich Featuregruppen finden Sie eine Liste aller Featuregruppen für den ausgewählten Standort.

REST

Um eine Liste aller FeatureGroup-Ressourcen für einen bestimmten Standort in Ihrem Projekt abzurufen, senden Sie eine GET-Anfrage mithilfe der Methode featureGroups.list.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • LOCATION_ID: Region, für die Sie die Liste der Featuregruppen aufrufen möchten, z. B. us-central1.
  • PROJECT_ID: Ihre Projekt-ID.

HTTP-Methode und URL:

GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus: 

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

PowerShell

Führen Sie diesen Befehl aus:

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups" | Select-Object -Expand Content
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten: BIGQUERY_URI_1 ist die BigQuery-Quelltabelle oder ‑Ansicht, die über FEATURE_GROUP_NAME_1 registriert wurde, und BIGQUERY_URI_2 ist die BigQuery-Quelltabelle oder ‑Ansicht, die mit FEATURE_GROUP_NAME_2 registriert wurde.
Wenn für eine der in der Antwort aufgeführten Funktionsgruppen eine dedizierte Dienstkontokonfiguration vorhanden ist, wird die E-Mail-Adresse des Dienstkontos auch in den zugehörigen Details aufgeführt. In diesem Beispiel ist SERVICE_ACCOUNT_EMAIL die E-Mail-Adresse des Dienstkontos, das der Funktionsgruppe FEATURE_GROUP_NAME_1 zugeordnet ist. 
{
  "featureGroups": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME_1",
      "createTime": "2023-09-07T00:57:00.142639Z",
      "updateTime": "2023-09-07T00:57:00.142639Z",
      "etag": "AMEw9yOY0byP8qKsDY0DoZyouAtX23zDru2l422C0affZZPYNFOGgIrONELNrM49uH4=",
      "bigQuery": {
        "bigQuerySource": {
          "inputUri": "BIGQUERY_URI_1"
        }
      }
      "serviceAccountEmail": "SERVICE_ACCOUNT_EMAIL"
    },
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME_2",
      "createTime": "2023-09-06T23:14:30.795502Z",
      "updateTime": "2023-09-06T23:14:30.795502Z",
      "etag": "AMEw9yO5UfrPWobGR2Ry-PnbJUQoklW5lX0uW4JmKqj6OgQui6p-rMdUHfuENpQjbJ3t",
      "bigQuery": {
        "bigQuerySource": {
          "inputUri": "BIGQUERY_URI_2"
        }
      }
    }
  ]
}

Nächste Schritte