Listar grupos de funciones

Puedes obtener una lista de todos los grupos de características creados para una ubicación específica de tu Google Cloud proyecto, junto con el URI de la tabla o vista de origen de BigQuery asociada a cada grupo de características.

Si un grupo de funciones está configurado para usar una cuenta de servicio específica, los detalles de ese grupo de funciones también incluyen la dirección de correo de la cuenta de servicio asociada. Para obtener más información sobre cómo crear grupos de funciones con configuraciones de cuentas de servicio específicas, consulta el artículo Configurar la cuenta de servicio de un grupo de funciones.

Antes de empezar

Autentícate en Vertex AI, a menos que ya lo hayas hecho.

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

Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.

    Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando: 

    gcloud init

    Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Listar grupos de funciones

Usa los siguientes ejemplos para obtener una lista de todos los grupos de funciones de una ubicación específica de tu proyecto.

Consola

Sigue estas instrucciones para ver la lista de grupos de funciones de una ubicación específica mediante la consola Google Cloud .

  1. En la sección Vertex AI de la Google Cloud consola, ve a la página Feature Store.

    Ir a la página Feature Store

  2. En la sección Grupos de funciones, puede ver la lista de todos los grupos de funciones de la ubicación seleccionada.

REST

Para obtener una lista de todos los recursos FeatureGroup de una ubicación específica de tu proyecto, envía una solicitud GET mediante el método featureGroups.list.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • LOCATION_ID: región de la que quiere ver la lista de grupos de funciones, como us-central1.
  • PROJECT_ID: tu ID de proyecto.

Método HTTP y URL: 

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

Para enviar tu solicitud, elige una de estas opciones:

curl

Ejecuta el comando siguiente: 

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

Ejecuta el comando siguiente: 

$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
Deberías recibir una respuesta JSON similar a la siguiente. BIGQUERY_URI_1 es la tabla o vista de origen de BigQuery registrada mediante FEATURE_GROUP_NAME_1, y BIGQUERY_URI_2 es la tabla o vista de origen de BigQuery registrada con FEATURE_GROUP_NAME_2.
Si alguno de los grupos de funciones que se indican en la respuesta tiene una configuración de cuenta de servicio específica, la dirección de correo de la cuenta de servicio también se indica en sus detalles. En este ejemplo, SERVICE_ACCOUNT_EMAIL es la dirección de correo de la cuenta de servicio asociada al grupo de funciones 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"
        }
      }
    }
  ]
}

Siguientes pasos