Elenco dei gruppi di funzionalità

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 ulteriori informazioni sulla creazione di gruppi di funzionalità con configurazioni di account di servizio dedicate, vedi 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.

Select the tab for how you plan to use the samples on this page:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

REST

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

    Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando: 

    gcloud init

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

Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Elenca i gruppi di caratteristiche

Utilizza gli esempi riportati di seguito 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 seguenti sostituzioni:

  • 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