Liste grupos de funcionalidades

Pode obter uma lista de todos os grupos de funcionalidades criados para uma localização específica no seu Google Cloud projeto, juntamente com o URI da tabela de origem ou da vista do BigQuery associada a cada grupo de funcionalidades.

Se um grupo de funcionalidades estiver configurado para usar uma conta de serviço dedicada, os detalhes desse grupo de funcionalidades também incluem o endereço de email da conta de serviço associada. Para mais informações sobre a criação de grupos de funcionalidades com configurações de contas de serviço dedicadas, consulte o artigo Configure a conta de serviço para um grupo de funcionalidades.

Antes de começar

Autentique o Vertex AI, a menos que já o tenha feito.

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 os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

    Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

    gcloud init

    Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Liste grupos de funcionalidades

Use os seguintes exemplos para obter uma lista de todos os grupos de funcionalidades de uma localização específica no seu projeto.

Consola

Siga as instruções abaixo para ver a lista de grupos de funcionalidades de uma localização específica através da Google Cloud consola.

  1. Na secção do Vertex AI da Google Cloud consola, aceda à página Feature Store.

    Aceda à página da Feature Store

  2. Na secção Grupos de elementos, pode ver a lista de todos os grupos de elementos da localização selecionada.

REST

Para obter uma lista de todos os recursos FeatureGroup para uma localização específica no seu projeto, envie um pedido GET através do método featureGroups.list.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • LOCATION_ID: região para a qual quer ver a lista de grupos de funcionalidades, como us-central1.
  • PROJECT_ID: o ID do seu projeto.

Método HTTP e URL: 

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

Para enviar o seu pedido, escolha uma destas opções:

curl

Execute o seguinte 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

Execute o seguinte 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
Deve receber uma resposta JSON semelhante à seguinte. BIGQUERY_URI_1 é a tabela ou a vista de origem do BigQuery registada através de FEATURE_GROUP_NAME_1 e BIGQUERY_URI_2 é a tabela ou a vista de origem do BigQuery registada com FEATURE_GROUP_NAME_2.
Se algum dos grupos de funcionalidades indicados na resposta tiver uma configuração de conta de serviço dedicada, o endereço de email da conta de serviço também é indicado nos respetivos detalhes. Neste exemplo, SERVICE_ACCOUNT_EMAIL é o endereço de email da conta de serviço associado ao grupo de funcionalidades 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"
        }
      }
    }
  ]
}

O que se segue?