文件夹/控制面板搜索 API - Amazon Managed Grafana

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

文件夹/控制面板搜索 API

使用 FolderDashboard-Search API 在亚马逊托管 Grafana 工作空间中搜索文件夹和控制面板。

注意

要在亚马逊托管 Grafana 工作空间中使用 Grafana API,您必须拥有有效的 Grafana API 令牌。您可以将其包含在 API 请求的Authorization字段中。有关如何创建令牌来验证您的 API 调用的信息,请参阅使用令牌进行身份验证

搜索文件夹和仪表板

GET /api/search/

查询参数:

  • 查询-搜索查询

  • tag-要搜索的标签列表。这些是 Grafana 标签,而不是标签。 AWS

  • t ype-要搜索的类型,可以是dash-folderdash-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 } ]