Method: projects.locations.collections.dataStores.branches.documents.purge

Supprime définitivement tous les Document sélectionnés dans une branche.

Ce processus est asynchrone. Selon le nombre de Document à supprimer, cette opération peut prendre plusieurs heures. Avant la fin de l'opération de suppression, il est possible que DocumentService.GetDocument ou DocumentService.ListDocuments renvoient encore certains Document.

Pour obtenir la liste des Document à supprimer, définissez PurgeDocumentsRequest.force sur "false".

Requête HTTP

POST https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*/branches/*}/documents:purge

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de la ressource parente, par exemple projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "filter": string,
  "errorConfig": {
    object (PurgeErrorConfig)
  },
  "force": boolean,

  // Union field source can be only one of the following:
  "gcsSource": {
    object (GcsSource)
  },
  "inlineSource": {
    object (InlineSource)
  }
  // End of list of possible types for union field source.
}
Champs
filter

string

Obligatoire. Filtrez les documents correspondants à supprimer. La seule valeur actuellement acceptée est * (tous les articles).
errorConfig

object (PurgeErrorConfig)

Emplacement souhaité des erreurs rencontrées lors de la suppression.
force

boolean

Exécute réellement la purge. Si force est défini sur "false", renvoyez le nombre de suppressions attendu sans supprimer de documents.
Champ d'union source. Source d'entrée souhaitée pour la suppression des documents en fonction de leurs ID. source ne peut être qu'un des éléments suivants :
gcsSource

object (GcsSource)

Emplacement Cloud Storage pour le contenu d'entrée. dataSchema acceptés : * documentId : un Document.id valide par ligne.
inlineSource

object (InlineSource)

Source intégrée pour le contenu à supprimer.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite

Pour plus d'informations, consultez la Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource parent :

  • discoveryengine.documents.purge

Pour en savoir plus, consultez la documentation IAM.