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 Featuregruppe für die Verwendung eines speziellen Dienstkontos konfiguriert ist, enthalten die Details für diese Featuregruppe auch die zugehörige E-Mail-Adresse des Dienstkontos. Weitere Informationen zum Erstellen von Featuregruppen mit speziellen Dienstkontokonfigurationen finden Sie unter Dienstkonto für eine Featuregruppe konfigurieren.

Hinweis

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

Wählen Sie den Tab für die Verwendung der Beispiele auf dieser Seite aus:

Console

Wenn Sie über die Google Cloud Console auf Google Cloud Dienste und APIs zugreifen, müssen Sie die Authentifizierung nicht einrichten.

REST

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

    Installieren Sie die Google Cloud CLI.

    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 Google Cloud Authentifizierungsdokumentation 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.

Console

So rufen Sie mit der Google Cloud Console 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 Featuregruppen eine Konfiguration für ein spezielles Dienstkonto vorhanden ist, wird die E-Mail-Adresse des Dienstkontos auch in den Details aufgeführt. In diesem Beispiel ist SERVICE_ACCOUNT_EMAIL die E-Mail-Adresse des Dienstkontos, das der Featuregruppe 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