Elenca i gruppi di caratteristiche

Puoi recuperare un elenco di tutti i gruppi di caratteristiche creati per una località specifica nel tuo progetto Google Cloud , insieme all'URI della tabella o 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 su Vertex AI, a meno che tu non l'abbia già fatto.

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

Console

Quando utilizzi la console Google Cloud per accedere ai servizi Google Cloud 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.

    Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

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

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

  1. Nella sezione Vertex AI della console Google Cloud , 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