API 参考
索引
/indexes
路由允许您创建、管理和删除您的索引。
/indexes
路由允许您创建、管理和删除您的索引。
索引对象
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
uid | 字符串 | 不适用 | 索引的唯一标识符。一旦创建,它不能被更改 |
createdAt | 字符串 | 不适用 | 索引的创建日期,以RFC 3339格式表示。在索引创建时自动生成 |
updatedAt | 字符串 | 不适用 | 索引的最新更新日期,以RFC 3339格式表示。在索引创建或更新时自动生成 |
primaryKey | 字符串 / null | null | 索引的主键。如果未指定,Meilisearch 会根据您添加到索引的第一个文档猜测您的主键 |
列出所有索引
GET
/indexes
列出所有索引。结果可以通过使用 offset
和 limit
查询参数进行分页。
查询参数
查询参数 | 描述 | 默认值 |
---|---|---|
offset | 要跳过的索引数量 | 0 |
limit | 要返回的索引数量 | 20 |
响应
名称 | 类型 | 描述 |
---|---|---|
results | 数组 | 一个包含索引的数组 |
offset | 整数 | 已跳过的索引数量 |
limit | 整数 | 已返回的索引数量 |
total | 整数 | 索引总数 |
示例
响应:200 成功
获取单个索引
GET
/indexes/{index_uid}
获取有关索引的信息。
路径参数
名称 | 类型 | 描述 |
---|---|---|
index_uid * | 字符串 | 所请求索引的uid |
示例
响应:200 成功
创建索引
POST
/indexes
创建一个索引。
请求体
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
uid * | 字符串 | 不适用 | 所请求索引的uid |
primaryKey | 字符串 / null | null | 所请求索引的主键 |
示例
响应:202 已接受
您可以使用响应中的 taskUid
来跟踪请求的状态。
更新索引
PATCH
/indexes/{index_uid}
更新索引的主键。只要索引不包含任何文档,您就可以自由更新其主键。
要更改已包含文档的索引的主键,您必须首先删除该索引中的所有文档。然后,您可以更改主键并重新索引您的数据集。
无法更改索引的 uid
。
路径参数
名称 | 类型 | 描述 |
---|---|---|
index_uid * | 字符串 | 所请求索引的uid |
请求体
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
primaryKey * | 字符串 / null | 不适用 | 所请求索引的主键 |
示例
响应:202 已接受
您可以使用响应中的 taskUid
来跟踪请求的状态。
删除索引
DELETE
/indexes/{index_uid}
删除一个索引。
路径参数
名称 | 类型 | 描述 |
---|---|---|
index_uid * | 字符串 | 所请求索引的uid |
示例
响应:202 已接受
您可以使用响应中的 taskUid
来跟踪请求的状态。
交换索引
POST
/swap-indexes
交换两个或更多索引的文档、设置和任务历史。您只能成对交换索引。但是,单个请求可以交换任意数量的索引对。
交换索引是一个原子事务:要么所有索引都成功交换,要么都不成功。
交换 indexA
和 indexB
也会在任务历史中将所有提到 indexA
的地方替换为 indexB
,反之亦然。enqueued
任务保持不变。
请求体
一个对象数组。每个对象只有一个键:indexes
。
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
indexes * | 字符串数组 | 不适用 | 要交换的两个 indexUid 的数组 |
每个 indexes
数组必须只包含两个元素:要交换的两个索引的 indexUid
。发送空数组 ([]
) 是有效的,但不会执行任何交换操作。
您可以通过单个请求交换多对索引。为此,每对要交换的索引都必须有一个对象。
示例
响应
由于 indexSwap
是一个全局任务,因此 indexUid
始终为 null
。
您可以使用响应中的 taskUid
来跟踪请求的状态。