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

Hinweis

Authentifizieren Sie sich bei der Gemini Enterprise Agent Platform, sofern nicht bereits geschehen.

Wählen Sie den Tab für die Art und Weise aus, wie Sie die Beispiele auf dieser Seite verwenden möchten:

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 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.

Console

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

  1. Rufen Sie in der Google Cloud Console im Bereich „Agent Platform“ 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