Enumerar grupos de funciones

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

Si un grupo de funciones está configurado para usar una cuenta de servicio dedicada, los detalles de ese grupo de funciones también incluyen la dirección de correo electrónico 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 dedicadas, consulta Configura la cuenta de servicio para un grupo de funciones.

Antes de comenzar

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 de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a gcloud CLI.

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

    gcloud init

    Si usas un proveedor de identidad externo (IdP), primero debes acceder a gcloud CLI con tu identidad federada.

Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Enumerar grupos de funciones

Usa los siguientes ejemplos para recuperar una lista de todos los grupos de atributos para una ubicación específica en tu proyecto.

Console

Usa las siguientes instrucciones para ver la lista de grupos de atributos de una ubicación específica con la Google Cloud consola.

  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 atributos, puedes ver la lista de todos los grupos de atributos para la ubicación seleccionada.

REST

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • LOCATION_ID: La región para la que deseas ver la lista de grupos de atributos, como us-central1.
  • PROJECT_ID: ID del 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 siguiente 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

Ejecuta el siguiente 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
Deberías recibir una respuesta JSON similar a la que se muestra a continuación: BIGQUERY_URI_1 es la tabla o vista de origen de BigQuery registrada a través de 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 enumeran en la respuesta tiene una configuración de cuenta de servicio dedicada, la dirección de correo electrónico de la cuenta de servicio también se incluye en sus detalles. En este ejemplo, SERVICE_ACCOUNT_EMAIL es la dirección de correo electrónico de la cuenta de servicio asociada con el 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"
        }
      }
    }
  ]
}

¿Qué sigue?