Em um grupo de recursos, é possível atualizar um elemento para associá-lo a uma coluna específica na fonte de dados do BigQuery associada a esse grupo.
Ao criar ou atualizar um recurso, você tem a opção de adicionar metadados definidos pelo usuário na forma de rótulos. Para saber mais sobre como atualizar rótulos definidos pelo usuário para um recurso, consulte Atualizar rótulos de um recurso.
Antes de começar
Faça a autenticação na Vertex AI, a menos que já tenha feito isso.
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Atualizar um recursos
Use o exemplo a seguir para atualizar um recurso dentro de um grupo.
REST
Para atualizar um recurso Feature
, envie uma solicitação PATCH
usando o
método
features.patch.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- LOCATION_ID: região em que o grupo de recursos que contém o recurso está localizado, como
us-central1
. - PROJECT_ID: o ID do projeto.
- FEATURE_GROUP_NAME: o nome do grupo de recursos que contém o recurso.
- FEATURE_NAME: o nome do recurso que você quer atualizar.
- VERSION_COLUMN_NAME: a coluna da tabela ou visualização de origem do BigQuery que você quer associar ao atualizar o recurso.
Método HTTP e URL:
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features?feature_id=FEATURE_NAME
Corpo JSON da solicitação:
{ "version_column_name": "VERSION_COLUMN_NAME" }
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo com o nome request.json
e execute o comando a seguir:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features?feature_id=FEATURE_NAME"
PowerShell
Salve o corpo da solicitação em um arquivo com o nome request.json
e execute o comando a seguir:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features?feature_id=FEATURE_NAME" | Select-Object -Expand Content
Você receberá uma resposta JSON semelhante a esta:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features/FEATURE_NAME/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.UpdateFeatureOperationMetadata", "genericMetadata": { "createTime": "2023-09-18T02:36:22.870679Z", "updateTime": "2023-09-18T02:36:22.870679Z" } }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.aiplatform.v1beta1.Feature", "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATURE_GROUP_NAME/features/FEATURE_NAME" } }
A seguir
Saiba como criar um recurso.
Saiba como excluir uma visualização de recurso.