View a markdown version of this page

短 URL API - Amazon Managed Grafana

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

短 URL API

使用短 URL API 建立縮短URLs。短 URL 代表較長的 URL,其中包含較小且更簡單的複雜查詢參數。

注意

若要搭配 Amazon Managed Grafana 工作區使用 Grafana API,您必須擁有有效的服務帳戶字符。您可以在 API 請求的 Authorization 欄位中包含此項目。

建立短 URL

POST /api/short-urls

建立短 URL。

範例請求

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 內文結構描述:

  • path – 相對於 Grafana 根 URL 的縮短路徑。

回應範例

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

狀態碼:

  • 200 – 已建立

  • 400 – 錯誤 (無效的 JSON、遺失或無效的欄位)

取得短 URL

GET /api/short-urls/:uid

依其 UID 擷取短 URL。

範例請求

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" }