Индекс файлов
Поиск в сохранённом индексе файлов с разбивкой на страницы и сортировкой или подсчёт совпадений по тому же запросу.
Volume scan scheduling
volumeIdQUEUEDFIFO · deduplicate by volume
RUNNING × 1One scan at a time
Complete / fail / stop → next
pause → PAUSED · resume → QUEUED
Определения типов
type Subscription {
fileIndexScanProgressUpdated: FileIndexScanProgress!
}
type Query {
indexedFileCount(query: String!): Long!
indexedFiles(query: String!, offset: Int!, limit: Int!, sortBy: FileSortBy!): [File!]!
fileIndexDefaults: FileIndexDefaults!
fileIndexScanProgress(volumeId: ID): FileIndexScanProgress!
fileIndexVolumes: [FileIndexVolume!]!
}
type Mutation {
pauseFileIndex(volumeId: ID): Boolean!
rebuildFileIndex(volumeId: ID): Boolean!
resumeFileIndex(volumeId: ID): Boolean!
setFileIndexVolume(volumeId: ID!, input: FileIndexVolumeInput!): Boolean!
stopFileIndex(volumeId: ID): Boolean!
}
type File {
permission: String!
mediaId: ID
name: String!
path: String!
createdAt: Instant
updatedAt: Instant!
size: Long!
isDir: Boolean!
childCount: Int!
url: String!
isSystem: Boolean!
}
type FileIndexDefaults {
excludedDirs: [String!]!
excludedNames: [String!]!
excludedProfileDirs: [FileIndexProfileDir!]!
mediaExcludedDirSuffixes: [String!]!
}
enum FileIndexMode {
UNCONFIGURED
DISABLED
ALLOWLIST
BLOCKLIST
}
type FileIndexProfileDir {
profilesDir: String!
excludedDir: String!
exceptDirs: [String!]!
}
type FileIndexScanProgress {
volumeId: ID
indexed: Int!
pending: Int
total: Int
state: FileIndexScanState!
error: String
}
enum FileIndexScanState {
IDLE
QUEUED
RUNNING
PAUSED
STOPPED
FAILED
}
enum FileIndexScanStatus {
COMPLETED
CANCELED
FAILED
}
type FileIndexVolume {
id: ID!
path: String!
isAvailable: Boolean!
indexMode: FileIndexMode!
includedDirs: [String!]!
excludedDirs: [String!]!
lastScanAt: Instant
lastScanStatus: FileIndexScanStatus
lastScanCount: Long
lastScanTotal: Long
}
input FileIndexVolumeInput {
indexMode: FileIndexMode!
includedDirs: [String!]!
excludedDirs: [String!]!
}
enum FileSortBy {
UPDATED_AT_ASC
UPDATED_AT_DESC
SIZE_ASC
SIZE_DESC
NAME_ASC
NAME_DESC
}
scalar Instant
scalar LongОперации
fileIndexScanProgressUpdated
Получает обновления прогресса сканирования файлового индекса.
subscription fileIndexScanProgressUpdated {
fileIndexScanProgressUpdated { volumeId indexed pending total state error }
}indexedFileCount
Подсчитывает индексированные файлы по запросу.
query indexedFileCount($query: String!) {
indexedFileCount(query: $query)
}indexedFiles
Ищет в сохранённом файловом индексе с разбивкой на страницы и сортировкой.
query indexedFiles($query: String!, $offset: Int!, $limit: Int!, $sortBy: FileSortBy!) {
indexedFiles(query: $query, offset: $offset, limit: $limit, sortBy: $sortBy) { permission mediaId name path createdAt updatedAt size isDir }
}pauseFileIndex
Приостанавливает активное сканирование файлового индекса.
mutation pauseFileIndex($volumeId: ID) {
pauseFileIndex(volumeId: $volumeId)
}rebuildFileIndex
Перестраивает файловый индекс указанного тома; если volumeId не задан или равен null, обрабатывает все настроенные тома.
mutation rebuildFileIndex($volumeId: ID) {
rebuildFileIndex(volumeId: $volumeId)
}resumeFileIndex
Продолжает приостановленное сканирование файлового индекса.
mutation resumeFileIndex($volumeId: ID) {
resumeFileIndex(volumeId: $volumeId)
}setFileIndexVolume
Сохраняет режим индексирования и каталоги тома, затем обновляет его индекс.
mutation setFileIndexVolume($volumeId: ID!, $input: FileIndexVolumeInput!) {
setFileIndexVolume(volumeId: $volumeId, input: $input)
}stopFileIndex
Останавливает активное сканирование файлового индекса.
mutation stopFileIndex($volumeId: ID) {
stopFileIndex(volumeId: $volumeId)
}fileIndexDefaults
Читает конфигурацию файлового индекса по умолчанию.
query fileIndexDefaults {
fileIndexDefaults { excludedDirs excludedNames mediaExcludedDirSuffixes }
}fileIndexScanProgress
Читает текущий прогресс сканирования файлового индекса.
query fileIndexScanProgress($volumeId: ID) {
fileIndexScanProgress(volumeId: $volumeId) { volumeId indexed pending total state error }
}fileIndexVolumes
Читает зарегистрированные тома файлового индекса и их конфигурацию.
query fileIndexVolumes {
fileIndexVolumes { id path isAvailable indexMode includedDirs excludedDirs lastScanAt lastScanStatus }
}