搜索工件

版本 4.0.23.6（最新）

搜索命名空间中的所有键值对，以寻找匹配的条件。

返回与指定搜索条件匹配的工件数组。

密钥搜索模式使用不区分大小写的匹配，并且可以包含 % 和 _ 作为 SQL LIKE 模式匹配通配符表达式。

参数 min_size 和 max_size 可以单独使用，也可以结合使用。

  • min_size 查找大小不小于该值的工件
  • max_size 查找大小小于或等于其值的工件
  • 同时使用两个参数会限制工件的最小和最大大小范围

注意：工件始终按键以字母顺序返回。

使用 artifact 按命名空间和键获取单个工件

注意：Artifact Storage API 只能由 Looker 构建的扩展程序使用。

请求

GET /artifact/{namespace}/search
数据类型
说明
请求
HTTP 请求
路径
HTTP 路径
展开 HTTPPath 定义...
命名空间
字符串
工件存储空间命名空间
查询
HTTPQuery
展开 HTTPQuery 定义...
字段
字符串
要在响应中返回的字段的名称（以英文逗号分隔）。省略所有字段
密钥
字符串
要匹配的关键模式
user_ids
字符串
创建或更新工件的用户 ID（逗号分隔列表）
最小尺寸
整数
工件的最小存储空间
最大尺寸
整数
工件的存储大小上限
限制
整数
要返回的结果数。（与偏移一起使用）
offset
整数
在返回任何结果之前要跳过的结果数。（有使用限制）

响应

200：工件

数据类型
说明
（数组）
密钥
字符串
要存储的键值对。命名空间 + 键必须是唯一的。
值
字符串
要存储的值。
content_type
字符串
内容的 MIME 类型。此属性只能用于替换检测到的文本/纯文本内容。需要设置 application/json 内容类型（分析为纯文本）。
version
整数
所存储值的版本号。对于现有工件的任何更新，必须提供此版本。
命名空间
字符串
工件存储命名空间。
创建时间
字符串
此工件创建时的时间戳。
更新时间
字符串
此工件更新时的时间戳。
value_size
整数
存储值的大小（以字节为单位）。
创建用户 ID
字符串
工件创建者的用户 ID。
更新的用户 ID
字符串
工件更新程序的用户 ID。

400：错误请求

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

404：未找到

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

422：验证错误

数据类型
说明
（对象）
消息
字符串
错误详情
展开 ValidationErrorDetail 定义...
字段
字符串
出错的字段
代码
字符串
错误代码
消息
字符串
错误信息消息
文档网址
字符串
文档链接
文档网址
字符串
文档链接

429：请求数过多

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接