Listar grupos de recursos

É possível recuperar uma lista de todos os grupos de recursos criados para um local específico no seu Google Cloud projeto, com o URI da tabela ou visualização de origem do BigQuery associada a cada grupo de recursos.

Se um grupo de recursos estiver configurado para usar uma conta de serviço dedicada, os detalhes desse grupo também vão incluir o endereço de e-mail da conta de serviço associada. Para mais informações sobre como criar grupos de recursos com configurações de contas de serviço dedicadas, consulte Configurar a conta de serviço para um grupo 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 Google Cloud console para acessar Google Cloud serviços e APIs, não é necessário configurar a autenticação.

REST

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

    Instale a Google Cloud CLI.

    Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

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

Listar grupos de recursos

Use os exemplos a seguir para recuperar uma lista de todos os grupos de recursos para um local específico no seu projeto.

Console

Siga as instruções abaixo para conferir a lista de grupos de recursos de um local específico usando o Google Cloud console.

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

    Acessar a página da Feature Store

  2. Na seção Grupos de recursos, você encontra a lista de todos os grupos de recursos do local selecionado.

REST

Para recuperar uma lista de todos osFeatureGroup recursos para um local específico do projeto, envie umGET solicitação usando o métodofeatureGroups.list.

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

  • LOCATION_ID: região onde você quer visualizar a lista de grupos de recursos, como us-central1.
  • PROJECT_ID: o ID do projeto.

Método HTTP e URL: 

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

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/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
Você receberá uma resposta JSON semelhante a seguinte. BIGQUERY_URI_1 é a tabela ou visualização de origem do BigQuery registrada via FEATURE_GROUP_NAME_1 e BIGQUERY_URI_2 é a tabela ou visualização de origem do BigQuery registrada com FEATURE_GROUP_NAME_2.
Se algum dos grupos de recursos listados na resposta tiver uma configuração de conta de serviço dedicada, o endereço de e-mail da conta de serviço também será listado nos detalhes. Neste exemplo, SERVICE_ACCOUNT_EMAIL é o endereço de e-mail da conta de serviço associada ao grupo de recursos 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"
        }
      }
    }
  ]
}

A seguir