View a markdown version of this page

短网址 API - Amazon Managed Grafana

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

短网址 API

使用短网址 API 创建缩短的网址。短 URL 表示较长的 URL,其中包含格式更小、更简单的复杂查询参数。

注意

要在您的亚马逊托管 Grafana 工作空间中使用 Grafana API,您必须拥有有效的服务账户令牌。您可以将其包含在 API 请求的 Authorization 字段中。

创建短网址

POST /api/short-urls

创建一个简短的网址。

示例请求

POST /api/short-urls HTTP/1.1 Accept: application/json Content-Type: application/json Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk { "path": "d/TxKARsmGz/new-dashboard?orgId=1&from=1599389322894&to=1599410922894" }

JSON 正文架构:

  • 路径 — 相对于 Grafana 根网址的缩短路径。

响应示例

HTTP/1.1 200 Content-Type: application/json { "uid": "AT76wBvGk", "url": "/goto/AT76wBvGk?orgId=1" }

状态码:

  • 200 — 已创建

  • 400-错误(JSON 无效、字段缺失或无效)

获取简短网址

GET /api/short-urls/:uid

按其 UID 检索短网址。

示例请求

GET /api/short-urls/AT76wBvGk HTTP/1.1 Accept: application/json Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

响应示例

HTTP/1.1 200 Content-Type: application/json { "uid": "AT76wBvGk", "path": "d/TxKARsmGz/new-dashboard?orgId=1&from=1599389322894&to=1599410922894" }