O Feature Store da Vertex AI permite adicionar ou atualizar rótulos para os seguintes tipos de recursos:
- Grupo de recursos (
FeatureGroup) - Recurso (
Feature) - Instância de loja on-line (
FeatureOnlineStore) - Instância da visualização de recursos (
FeatureView)
Os rótulos podem ser adicionados durante a criação do recurso ou a um recurso atual. Observe que é opcional adicionar rótulos a esses recursos.
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 initPara mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Atualizar os rótulos de um grupo de recursos
Use o exemplo a seguir para atualizar os rótulos de um grupo de recursos existente.
REST
Para atualizar os rótulos de um recurso FeatureGroup existente, envie uma
solicitação PATCH usando o
método
featureGroups.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 está localizado, como
us-central1. - PROJECT_ID: o ID do projeto.
- FEATUREGROUP_NAME: o nome do grupo de recursos que você quer atualizar.
- LABELS_JSON: os rótulos que serão anexados ao grupo de recursos como pares de chave-valor no formato JSON.
Por exemplo:
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
Método HTTP e URL:
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATUREGROUP_NAME
Corpo JSON da solicitação:
{
"labels": LABELS_JSON
}
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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATUREGROUP_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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATUREGROUP_NAME" | Select-Object -Expand Content
Você receberá uma resposta JSON semelhante a esta:
{
"name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureGroupOperationMetadata",
"genericMetadata": {
"createTime": "2023-09-18T03:00:13.060636Z",
"updateTime": "2023-09-18T03:00:13.060636Z"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.aiplatform.v1.FeatureGroup",
"name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME"
}
}
Atualizar rótulos de um recurso
Use o exemplo a seguir para atualizar os rótulos de um recurso atual.
REST
Para atualizar os rótulos de um recurso Feature existente, 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.
- FEATUREGROUP_NAME: o nome do grupo de recursos que contém o recurso.
- FEATURE_NAME: o nome do recurso que você quer atualizar.
- LABELS_JSON: os rótulos que vão ser anexados ao recurso como pares de chave-valor no formato JSON.
Por exemplo:
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
Método HTTP e URL:
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME
Corpo JSON da solicitação:
{
"labels": LABELS_JSON
}
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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_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/FEATUREGROUP_NAME/features/FEATURE_NAME/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.aiplatform.v1.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.v1.Feature",
"name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features/FEATURE_NAME"
}
}
Atualizar os rótulos de uma loja on-line
Use o exemplo a seguir para atualizar os rótulos de uma instância de loja on-line atual.
REST
Para atualizar os rótulos de um recurso FeatureOnlineStore existente, envie uma
solicitação PATCH usando o
método
featureOnlineStores.patch.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- REGION_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 você quer atualizar.
- LABELS_JSON: os rótulos que serão anexados ao armazenamento on-line como pares de chave-valor no formato JSON.
Por exemplo:
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
Método HTTP e URL:
PATCH https://REGION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME
Corpo JSON da solicitação:
{
"labels": LABELS_JSON
}
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://REGION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_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://REGION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content
Você receberá uma resposta JSON semelhante a esta:
{
"name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
"genericMetadata": {
"createTime": "2023-09-18T17:49:23.847496Z",
"updateTime": "2023-09-18T17:49:23.847496Z"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.aiplatform.v1.FeatureView",
"name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME"
}
}
Atualizar rótulos para uma visualização de recursos
Use o exemplo a seguir para atualizar os rótulos de uma visualização de recursos existente.
REST
Para atualizar os rótulos de um recurso FeatureView existente, envie uma solicitação PATCH usando o método featureViews.patch.
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 visualização do recurso.
- FEATUREVIEW_NAME: o nome da visualização do recurso que você quer atualizar.
- LABELS_JSON: os rótulos que serão anexados à visualização do recurso como pares de chave-valor no formato JSON.
Por exemplo:
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
Método HTTP e URL:
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME
Corpo JSON da solicitação:
{
"labels": LABELS_JSON
}
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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_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/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME" | Select-Object -Expand Content
Você receberá uma resposta JSON semelhante a esta:
{
"name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.aiplatform.v1.UpdateFeatureViewOperationMetadata",
"genericMetadata": {
"createTime": "2023-09-15T04:53:34.832192Z",
"updateTime": "2023-09-15T04:53:34.832192Z"
}
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.aiplatform.v1.FeatureView",
"name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME"
}
}
A seguir
Saiba como atualizar um grupo de recursos.
Saiba como atualizar um recurso.
Saiba como atualizar uma instância de loja on-line
Saiba como atualizar uma visualização de recurso.