Vertex AI Feature Store vous permet d'ajouter ou de mettre à jour des étiquettes sur les types de ressources suivants:
- Groupe de caractéristiques (
FeatureGroup
) - Caractéristique (
Feature
) - Instance de magasin en ligne (
FeatureOnlineStore
) - Instance de vue des caractéristiques (
FeatureView
)
Vous pouvez ajouter des libellés lors de la création de la ressource ou ajouter des libellés à une ressource existante. Notez que l'ajout de libellés à ces ressources est facultatif.
Avant de commencer
Authentifiez-vous auprès de Vertex AI, sauf si vous l'avez déjà fait.
Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Mettre à jour les libellés d'un groupe de caractéristiques
Utilisez l'exemple suivant pour mettre à jour les libellés d'un groupe de caractéristiques existant.
REST
Pour mettre à jour les libellés d'une ressource FeatureGroup
existante, envoyez une requête PATCH
à l'aide de la méthode featureGroups.patch.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- LOCATION_ID : région où se trouve le groupe de caractéristiques, par exemple
us-central1
. - PROJECT_ID : ID de votre projet
- FEATUREGROUP_NAME: nom du groupe de caractéristiques que vous souhaitez mettre à jour.
- LABELS_JSON: libellés à associer au groupe de caractéristiques sous forme de paires clé/valeur au format JSON.
Par exemple :
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
Méthode HTTP et URL :
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups?feature_group_id=FEATUREGROUP_NAME
Corps JSON de la requête :
{ "labels": LABELS_JSON }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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
Vous devriez recevoir une réponse JSON de ce type :
{ "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" } }
Mettre à jour les libellés d'une caractéristique
Utilisez l'exemple suivant pour mettre à jour les libellés d'une caractéristique existante.
REST
Pour mettre à jour les libellés d'une ressource Feature
existante, envoyez une requête PATCH
à l'aide de la méthode features.patch.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- LOCATION_ID : région où se trouve le groupe de caractéristiques, par exemple
us-central1
. - PROJECT_ID : ID de votre projet
- FEATUREGROUP_NAME : nom du groupe de caractéristiques contenant la caractéristique.
- FEATURE_NAME: nom de la caractéristique que vous souhaitez mettre à jour.
- LABELS_JSON: libellés à associer à la caractéristique sous forme de paires clé/valeur au format JSON.
Par exemple :
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
Méthode HTTP et URL :
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureGroups/FEATUREGROUP_NAME/features?feature_id=FEATURE_NAME
Corps JSON de la requête :
{ "labels": LABELS_JSON }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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
Vous devriez recevoir une réponse JSON de ce type :
{ "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" } }
Mettre à jour les libellés d'une boutique en ligne
Utilisez l'exemple suivant pour mettre à jour les libellés d'une instance de magasin en ligne existante.
REST
Pour mettre à jour les libellés d'une ressource FeatureOnlineStore
existante, envoyez une requête PATCH
à l'aide de la méthode featureOnlineStores.patch.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- REGION_ID : région où se trouve la boutique en ligne, par exemple
us-central1
. - PROJECT_ID : ID de votre projet
- FEATUREONLINESTORE_NAME: nom de la boutique en ligne que vous souhaitez mettre à jour.
- LABELS_JSON: libellés à associer au magasin en ligne sous forme de paires clé/valeur au format JSON.
Par exemple :
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
Méthode HTTP et URL :
PATCH https://REGION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME
Corps JSON de la requête :
{ "labels": LABELS_JSON }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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
Vous devriez recevoir une réponse JSON de ce type :
{ "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" } }
Mettre à jour les libellés d'une vue de caractéristique
Utilisez l'exemple suivant pour mettre à jour les libellés d'une vue de caractéristique existante.
REST
Pour mettre à jour les libellés d'une ressource FeatureView
existante, envoyez une requête PATCH
à l'aide de la méthode featureViews.patch.
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- LOCATION_ID : région où se trouve la boutique en ligne, par exemple
us-central1
. - PROJECT_ID : ID de votre projet
- FEATUREONLINESTORE_NAME : nom de la boutique en ligne contenant la vue de caractéristiques.
- FEATUREVIEW_NAME: nom de la vue de la caractéristique que vous souhaitez mettre à jour.
- LABELS_JSON: libellés à associer à la vue des caractéristiques sous forme de paires clé/valeur au format JSON.
Par exemple :
{"label1_key": "label1_value", "label2_key": "label2_value", ...}
Méthode HTTP et URL :
PATCH https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/featureViews/FEATUREVIEW_NAME
Corps JSON de la requête :
{ "labels": LABELS_JSON }
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
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
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$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
Vous devriez recevoir une réponse JSON de ce type :
{ "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" } }
Étapes suivantes
Découvrez comment mettre à jour un groupe de caractéristiques.
Découvrez comment mettre à jour une caractéristique.
Apprenez à mettre à jour une instance de magasin en ligne.
Découvrez comment mettre à jour une vue de caractéristiques.