本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
文件夹/控制面板搜索 API
使用 FolderDashboard-Search API 在亚马逊托管 Grafana 工作空间中搜索文件夹和控制面板。
注意
要在亚马逊托管 Grafana 工作空间中使用 Grafana API,您必须拥有有效的 Grafana API 令牌。您可以将其包含在 API 请求的Authorization
字段中。有关如何创建令牌来验证您的 API 调用的信息,请参阅使用令牌进行身份验证。
搜索文件夹和仪表板
GET /api/search/
查询参数:
-
查询-搜索查询
-
tag-要搜索的标签列表。这些是 Grafana 标签,而不是标签。 AWS
-
t ype-要搜索的类型,可以是
dash-folder
或dash-db
。 -
DashboardIds — 要搜索的仪表板 ID 列表。
-
FolderIds — 要在仪表板中搜索的仪表板 ID 列表。
-
已加星标 — 标记以指定仅返回已加星标的仪表板。
-
限制-限制返回结果的数量(最大值为 5000)。
-
p@@ ag e — 使用此参数访问超出限制的命中次数。编号从 1 开始。该
limit
参数充当页面大小。
检索常规文件夹的文件夹和仪表板的请求示例
GET /api/search?folderIds=0&query=&starred=false HTTP/1.1 Accept: application/json Content-Type: application/json Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
检索常规文件夹的文件夹和仪表板的响应示例
HTTP/1.1 200 Content-Type: application/json [ { "id": 163, "uid": "000000163", "title": "Folder", "url": "/dashboards/f/000000163/folder", "type": "dash-folder", "tags": [], "isStarred": false, "uri":"db/folder" // deprecated in Grafana v5.0 }, { "id":1, "uid": "cIBgcSjkk", "title":"Production Overview", "url": "/d/cIBgcSjkk/production-overview", "type":"dash-db", "tags":[prod], "isStarred":true, "uri":"db/production-overview" // deprecated in Grafana v5.0 } ]
搜索已加星标的仪表板的请求示例
GET /api/search?query=Production%20Overview&starred=true&tag=prod HTTP/1.1 Accept: application/json Content-Type: application/json Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
搜索已加星标的仪表板的响应示例
HTTP/1.1 200 Content-Type: application/json [HTTP/1.1 200 Content-Type: application/json [ { "id":1, "uid": "cIBgcSjkk", "title":"Production Overview", "url": "/d/cIBgcSjkk/production-overview", "type":"dash-db", "tags":[prod], "isStarred":true, "folderId": 2, "folderUid": "000000163", "folderTitle": "Folder", "folderUrl": "/dashboards/f/000000163/folder", "uri":"db/production-overview" // deprecated in Grafana v5.0 } ]