Répertorier les groupes de caractéristiques

Vous pouvez récupérer la liste de tous les groupes de caractéristiques créés pour un emplacement spécifique dans votre projet Cloud de Confiance , ainsi que l'URI de la table ou de la vue source BigQuery associée à chaque groupe de caractéristiques.

Si un groupe de caractéristiques est configuré pour utiliser un compte de service dédié, les détails de ce groupe de caractéristiques incluent également l'adresse e-mail du compte de service associé. Pour en savoir plus sur la création de groupes de caractéristiques avec des configurations de compte de service dédiées, consultez Configurer le compte de service pour un groupe de caractéristiques.

Avant de commencer

Authentifiez-vous auprès de Gemini Enterprise Agent Platform, sauf si vous l'avez déjà fait.

Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

Console

Lorsque vous utilisez la console Cloud de Confiance pour accéder aux services et aux API Cloud de Confiance by S3NS , vous n'avez pas besoin de configurer l'authentification.

REST

Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.

    Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée.

Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Cloud de Confiance .

Répertorier les groupes de caractéristiques

Utilisez les exemples suivants pour récupérer la liste de tous les groupes de caractéristiques pour un emplacement spécifique de votre projet.

Console

Suivez les instructions ci-dessous pour afficher la liste des groupes de caractéristiques pour un emplacement spécifique à l'aide de la console Cloud de Confiance .

  1. Dans la section "Agent Platform" de la console Cloud de Confiance , accédez à la page Feature Store.

    Accéder à la page Feature Store

  2. Dans la section Groupes de caractéristiques, vous pouvez afficher la liste de tous les groupes de caractéristiques pour l'emplacement sélectionné.

REST

Pour récupérer une liste de toutes les ressources FeatureGroup pour un emplacement spécifique de votre projet, envoyez une requête GET à l'aide de la méthode featureGroups.list.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • LOCATION_ID : région pour laquelle vous souhaitez afficher la liste des groupes de caractéristiques, telle que us-central1.
  • PROJECT_ID : ID du projet.

Méthode HTTP et URL : 

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

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

Exécutez la commande suivante :

$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
Vous devriez recevoir une réponse JSON semblable à la suivante. BIGQUERY_URI_1 correspond à la table ou à la vue source BigQuery enregistrée via FEATURE_GROUP_NAME_1, et BIGQUERY_URI_2 correspond à la table ou à la vue source BigQuery enregistrée avec FEATURE_GROUP_NAME_2.
Si l'un des groupes de fonctionnalités listés dans la réponse dispose d'une configuration de compte de service dédiée, l'adresse e-mail du compte de service est également indiquée dans ses détails. Dans cet exemple, SERVICE_ACCOUNT_EMAIL correspond à l'adresse e-mail du compte de service associé au groupe de caractéristiques FEATURE_GROUP_NAME_1. 
{
  "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"
        }
      }
    }
  ]
}

Étapes suivantes