UpdateDocument update document - Tablestore - Centre de documentation Alibaba Cloud

Utilisez l'opération UpdateDocument pour mettre à jour les métadonnées d'un document spécifié. Le document doit être à l'état completed. La mise à jour écrase les métadonnées existantes : la valeur fournie les remplace intégralement. Pour modifier un seul champ, vous devez inclure tous les champs. Envoyer "metadata": null efface toutes les métadonnées.

Prérequis

Vous avez créé une instance AgentStorage qui est à l'état normal, et vous disposez du endpoint et du nom de l'instance.
Vous avez créé une clé API.
Le document à mettre à jour est à l'état completed.

Paramètres de requête

Paramètre

Type

Description

knowledgeBaseName

string

Nom de la base de connaissances. Obligatoire.

subspace

string

Nom du sous-espace. Obligatoire si le sous-espace est activé.

ossKey

string

Chemin OSS du document. Incompatible avec docId.

docId

string

ID du document. Incompatible avec ossKey.

metadata

map

Nouvelles métadonnées. Facultatif. Si ce champ est omis, la valeur d'origine est conservée et NO_OP est renvoyé. Si vous transmettez explicitement la valeur null, toutes les métadonnées sont effacées. Si vous transmettez un objet, les métadonnées existantes sont entièrement remplacées.

Exemple de requête

Pour l'authentification par clé API, indiquez le nom de l'instance et la clé API dans les en-têtes de requête x-ots-instancename et x-ots-apikey.

curl -X POST https://<endpoint>/UpdateDocument \
  -H "x-ots-instancename: <instance-name>" \
  -H "x-ots-apikey: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "knowledgeBaseName": "product_docs_kb",
  "subspace": "default",
  "ossKey": "oss://example-bucket/docs/manual.pdf",
  "metadata": {"author": "Li Si", "date": "2026-02-01 12:00:00", "score": 80}
}'

Réponse

Champ

Type

Description

docId

string

ID du document.

ossKey

string

Chemin OSS.

updatedAt

long

Horodatage de la mise à jour.

updateStatus

string

NO_OP ou UPDATED.