Elenco dei gruppi di funzionalità

Puoi recuperare un elenco di tutti i gruppi di caratteristiche creati per una posizione 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.

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, utilizzi le credenziali che fornisci a gcloud CLI.

    After installing the Google Cloud CLI, initialize it by running the following command: 

    gcloud init

    If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

Per saperne di più, consulta la sezione 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 del tuo progetto.

Console

Per visualizzare l'elenco dei gruppi di funzionalità per una località specifica utilizzando la console Google Cloud , segui queste istruzioni.

  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 posizione 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