Visualizações de recursos em lista

É possível recuperar uma lista de todas as instâncias de visualização de recursos criadas em uma loja on-line no seu projeto Cloud de Confiance . Para cada visualização de recurso, também é possível ver a fonte de dados de recursos, que pode ser uma das seguintes:

  • Um ou mais grupos de recursos e os elementos constituintes deles. Cada grupo de recursos está associado a uma fonte de dados de elementos, como uma tabela ou visualização do BigQuery. Cada recurso designa uma coluna na fonte de dados do BigQuery.

  • Uma tabela ou visualização do BigQuery diretamente associada à visualização do recurso.

Se uma visualização de recursos estiver configurada para usar uma conta de serviço dedicada, os detalhes dessa visualização de recursos também vão incluir o endereço de e-mail da conta de serviço associado. Para mais informações sobre como criar visualizações de recursos com configurações dedicadas de conta de serviço, consulte Configurar a conta de serviço para uma visualização de recursos.

Antes de começar

Faça a autenticação na Gemini Enterprise Agent Platform, a menos que já tenha feito isso.

Selecione a guia para como planeja usar as amostras nesta página:

Console

Quando você usa o console Cloud de Confiance para acessar os serviços e as APIs Cloud de Confiance by S3NS , não é necessário configurar a autenticação.

REST

Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

    Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada.

Saiba mais em Autenticar para usar REST na documentação de autenticação do Cloud de Confiance .

Listar visualizações de recursos em uma loja on-line

Use os exemplos a seguir para recuperar uma lista de visualizações de atributos criadas para uma loja on-line no seu projeto para um local específico.

Console

Use as instruções a seguir para consultar a lista de visualizações de atributos em uma loja on-line com o console Cloud de Confiance .

  1. Na seção "Agent Platform" do console Cloud de Confiance , acesse a página Feature Store.

    Acessar a página da Feature Store

  2. Clique em Loja on-line.

  3. Clique no nome da loja on-line para ver as informações na página Detalhes da loja on-line.

  4. Na seção Visualizações de recursos, é possível visualizar a lista de todas as lojas on-line do local selecionado.

REST

Para recuperar uma lista de todas as instâncias de FeatureView criadas em uma loja on-line específica do projeto, envie uma solicitação GET usando featureViews.list.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • LOCATION_ID: região em que a loja on-line está localizada, como us-central1.
  • PROJECT_ID: o ID do projeto.
  • FEATUREONLINESTORE_NAME: o nome da loja on-line que contém a lista de visualizações de elementos que você quer ver.

Método HTTP e URL: 

GET https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews

Para enviar a solicitação, 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/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews"

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/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews" | Select-Object -Expand Content
Você receberá uma resposta JSON semelhante a seguinte. Se alguma das visualizações de atributos listadas na resposta tiver uma configuração de conta de serviço dedicada, o endereço de e-mail da conta também será listado nos detalhes. Neste exemplo, SERVICE_ACCOUNT_EMAIL é o endereço de e-mail da conta de serviço associado à visualização de recursos FEATUREVIEW_NAME_1. 
{
  "featureViews": [
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME_1",
      "createTime": "2023-09-06T23:46:49.936284Z",
      "updateTime": "2023-09-06T23:46:49.936284Z",
      "etag": "sample_etag",
      "featureRegistrySource": {
        "featureGroups": [
          {
            "featureGroupId": "FEATUREGROUP_ID",
            "featureIds": [
              "FEATURE_ID_1",
              "FEATURE_ID_2",
            ]
          }
        ]
      }
      "serviceAccountEmail": "SERVICE_ACCOUNT_EMAIL"
    },
    {
      "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME_2",
      "createTime": "2024-02-05T23:48:49.936284Z",
      "updateTime": "2024-02-05T23:48:49.936284Z",
      "etag": "sample_etag",
      "featureRegistrySource": {
        "featureGroups": [
          {
            "featureGroupId": "FEATUREGROUP_ID",
            "featureIds": [
              "FEATURE_ID_3",
              "FEATURE_ID_4",
            ]
          }
        ]
      }
    }
  ]
}

A seguir