Featuregruppen auflisten

Sie können eine Liste aller Featuregruppen abrufen, die für einen bestimmten Standort in Ihrem Cloud de Confiance -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.

Hinweis

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

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

Console

Wenn Sie über die Cloud de Confiance Console auf Cloud de Confiance by S3NS -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 und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an.

Weitere Informationen finden Sie in der Dokumentation zur Cloud de Confiance -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 Cloud de Confiance -Console die Liste der Featuregruppen für einen bestimmten Standort auf:

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