Vertex AI Feature Store consente di aggiungere o aggiornare le etichette per i seguenti tipi di risorse:
- Gruppo di caratteristiche (
FeatureGroup) - Caratteristica (
Feature) - Istanza del negozio online (
FeatureOnlineStore) - Istanza della visualizzazione caratteristiche (
FeatureView)
Puoi aggiungere etichette durante la creazione delle risorse o a una risorsa esistente. Tieni presente che l'aggiunta di etichette a queste risorse è facoltativa.
Prima di iniziare
Autenticati a Vertex AI, se non l'hai già fatto.
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI.
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
Per saperne di più, consulta Autenticati per usare REST nella Google Cloud documentazione sull'autenticazione di.
Aggiornare le etichette per un gruppo di caratteristiche
Utilizza il seguente esempio per aggiornare le etichette di un gruppo di caratteristiche esistente.
REST
Per aggiornare le etichette di una risorsa FeatureGroup esistente, invia una richiesta
PATCH utilizzando il metodo
featureGroups.patch.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- LOCATION_ID: regione in cui si trova il gruppo di caratteristiche, ad esempio
us-central1. - PROJECT_ID: il tuo ID progetto.
- FEATUREGROUP_NAME: il nome del gruppo di caratteristiche che vuoi aggiornare.
- LABELS_JSON: le etichette da allegare al gruppo di caratteristiche come coppie chiave-valore in formato JSON.
Ad esempio:
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
Metodo 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 della richiesta:
{
"labels": LABELS_JSON
}
Per inviare la richiesta, scegli una di queste opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
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
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
$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
Dovresti ricevere una risposta JSON simile alla seguente:
{
"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"
}
}
Aggiornare le etichette per una caratteristica
Utilizza il seguente esempio per aggiornare le etichette di una caratteristica esistente.
REST
Per aggiornare le etichette di una risorsa Feature esistente, invia una richiesta
PATCH utilizzando il metodo
features.patch.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- LOCATION_ID: regione in cui si trova il gruppo di caratteristiche contenente la caratteristica, ad esempio
us-central1. - PROJECT_ID: il tuo ID progetto.
- FEATUREGROUP_NAME: il nome del gruppo di caratteristiche contenente la caratteristica.
- FEATURE_NAME: il nome della caratteristica che vuoi aggiornare.
- LABELS_JSON: le etichette da allegare alla caratteristica come coppie chiave-valore in formato JSON.
Ad esempio:
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
Metodo 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 della richiesta:
{
"labels": LABELS_JSON
}
Per inviare la richiesta, scegli una di queste opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
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
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
$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
Dovresti ricevere una risposta JSON simile alla seguente:
{
"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"
}
}
Aggiornare le etichette per un negozio online
Utilizza il seguente esempio per aggiornare le etichette di un'istanza del negozio online esistente.
REST
Per aggiornare le etichette di una risorsa FeatureOnlineStore esistente, invia una richiesta
PATCH utilizzando il metodo
featureOnlineStores.patch.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- REGION_ID: regione in cui si trova il negozio online, ad esempio
us-central1. - PROJECT_ID: il tuo ID progetto.
- FEATUREONLINESTORE_NAME: il nome del negozio online che vuoi aggiornare.
- LABELS_JSON: le etichette da allegare al negozio online come coppie chiave-valore in formato JSON.
Ad esempio:
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
Metodo 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 della richiesta:
{
"labels": LABELS_JSON
}
Per inviare la richiesta, scegli una di queste opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
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
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
$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
Dovresti ricevere una risposta JSON simile alla seguente:
{
"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"
}
}
Aggiornare le etichette per una visualizzazione caratteristiche
Utilizza il seguente esempio per aggiornare le etichette di una visualizzazione caratteristiche esistente.
REST
Per aggiornare le etichette di una risorsa FeatureView esistente, invia una richiesta
PATCH utilizzando il metodo
featureViews.patch.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- LOCATION_ID: regione in cui si trova il negozio online, ad esempio
us-central1. - PROJECT_ID: il tuo ID progetto.
- FEATUREONLINESTORE_NAME: il nome del negozio online contenente la visualizzazione caratteristiche.
- FEATUREVIEW_NAME: il nome della visualizzazione caratteristiche che vuoi aggiornare.
- LABELS_JSON: le etichette da allegare alla visualizzazione caratteristiche come coppie chiave-valore in formato JSON.
Ad esempio:
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
Metodo 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 della richiesta:
{
"labels": LABELS_JSON
}
Per inviare la richiesta, scegli una di queste opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
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
Salva il corpo della richiesta in un file denominato request.json,
quindi esegui il comando seguente:
$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
Dovresti ricevere una risposta JSON simile alla seguente:
{
"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"
}
}
Passaggi successivi
Scopri come aggiornare un gruppo di caratteristiche.
Scopri come aggiornare una caratteristica.
Scopri come aggiornare un'istanza del negozio online.
Scopri come aggiornare una visualizzazione caratteristiche.