Elenca i gruppi di caratteristiche

Puoi recuperare un elenco di tutti i gruppi di caratteristiche creati per una località specifica nel tuo progetto Cloud de Confiance , insieme all'URI della tabella o della vista di origine BigQuery associata a ogni gruppo di caratteristiche.

Se un gruppo di funzionalità è configurato per utilizzare un account di servizio dedicato, i dettagli di questo gruppo di funzionalità includono anche l'indirizzo email del account di servizio associato. Per saperne di più sulla creazione di gruppi di funzionalità con configurazioni di account di servizio dedicate, consulta Configurare il account di servizio per un gruppo di funzionalità.

Prima di iniziare

Autenticati in Gemini Enterprise Agent Platform, a meno che tu non l'abbia già fatto.

Seleziona la scheda relativa a come prevedi di utilizzare i campioni in questa pagina:

Console

Quando utilizzi la console Cloud de Confiance per accedere ai servizi Cloud de Confiance by S3NS e alle API, non devi configurare l'autenticazione.

REST

Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

    Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Cloud de Confiance .

Elenca i gruppi di caratteristiche

Utilizza gli esempi seguenti per recuperare un elenco di tutti i gruppi di funzionalità per una posizione specifica nel tuo progetto.

Console

Utilizza le seguenti istruzioni per visualizzare l'elenco dei gruppi di funzionalità per una località specifica utilizzando la console Cloud de Confiance .

  1. Nella sezione Piattaforma dell'agente della console Cloud de Confiance , vai alla pagina Feature Store.

    Vai alla pagina Feature Store

  2. Nella sezione Gruppi di funzionalità, puoi visualizzare l'elenco di tutti i gruppi di funzionalità per la località selezionata.

REST

Per recuperare un elenco di tutte le risorse FeatureGroup per una località specifica nel tuo progetto, invia una richiesta GET utilizzando il metodo featureGroups.list.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • LOCATION_ID: la regione per cui vuoi visualizzare l'elenco dei gruppi di funzionalità, ad esempio us-central1.
  • PROJECT_ID: il tuo ID progetto.

Metodo HTTP e URL: 

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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando: 

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

Esegui questo comando: 

$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
Dovresti ricevere una risposta JSON simile alla seguente. BIGQUERY_URI_1 è la tabella o la vista di origine BigQuery registrata tramite FEATURE_GROUP_NAME_1 e BIGQUERY_URI_2 è la tabella o la vista di origine BigQuery registrata con FEATURE_GROUP_NAME_2.
Se uno dei gruppi di funzionalità elencati nella risposta ha una configurazione del account di servizio dedicata, anche l'indirizzo email del account di servizio è elencato nei relativi dettagli. In questo esempio, SERVICE_ACCOUNT_EMAIL è l'indirizzo email del account di servizio associato al gruppo di funzionalità 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"
        }
      }
    }
  ]
}

Passaggi successivi