IRPCObjectOperations.FindFileDuplicates

View as Markdown

Vault API / core write session or assertion returns metadata structure version

Finds files in the vault with the same content as the given file version.

ServiceObjects, versions, properties and files MFiles.IRPCObjectOperations
gRPC method/MFiles.IRPCObjectOperations/FindFileDuplicates
HTTP (mf-http-grpc)POST /grpc/v1/find-file-duplicates
RequestFindFileDuplicatesRequest
ResponseFindFileDuplicatesResponse
Book and levelVault API, core
Kindwrite
SessionRequired: a session (mfiles-session-id-bin metadata) or a session assertion (x-mf-session-assertion metadata).
Idempotentno
Returns metadata structure versionyes (in the mfiles-metadata-version-bin trailer)
Streamingnone (unary)

Request: FindFileDuplicatesRequest

Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

FieldTypeDescription
obj_file_verObjFileVerThe obj file version.
obj_file_ver.obj_idObjIDThe object that owns the file.
obj_file_ver.obj_id.typeint32The object type ID, for example 0 for documents. In a lookup value, the value list ID (for a lookup to objects, the object type ID).
obj_file_ver.obj_id.item_idItemIDThe ID of the object within its type, in item_id.internal_id.
obj_file_ver.file_verFileVerThe specific file version, as in File.file_ver.
obj_file_ver.file_ver.file_idFileIDThe file.
obj_file_ver.file_ver.typeFileVerTypeFILE_VER_TYPE_SPECIFIC for a file version number.Values: FILE_VER_TYPE_UNINITIALIZED (0), FILE_VER_TYPE_LATEST (1), FILE_VER_TYPE_ANY (2), FILE_VER_TYPE_SPECIFIC (3).
obj_file_ver.file_ver.internal_versionint32The file version number.
obj_file_ver.file_ver.external_repository_versionstringUsed only for files in external repositories. Leave empty.
obj_file_ver.file_ver.external_repository_sort_keyint64Used only for files in external repositories. Leave 0.
include_versions_of_this_fileboolTrue if the results should include duplicates which are other versions of the same file.
exclude_files_from_deleted_objectsboolTrue if the results should exclude duplicates which belong to deleted objects.

Response: FindFileDuplicatesResponse

Nested message fields are expanded to depth 3; follow a type link for deeper levels and for the type's own page.

FieldTypeDescription
obj_ids[]repeated ObjIDResults.
obj_ids[].typeint32The object type ID, for example 0 for documents. In a lookup value, the value list ID (for a lookup to objects, the object type ID).
obj_ids[].item_idItemIDThe ID of the object within its type, in item_id.internal_id.
obj_ids[].item_id.internal_idint32The ID of the object or value list item.
obj_ids[].item_id.external_repository_idExternalRepositoryIDUsed only for objects in external repositories (external connectors). Leave it unset for objects stored in the vault.