偏好設定 API

使用喜好設定 API 來處理 Amazon 受管 Grafana 工作區中的使用者偏好設定。

按鍵：

• theme — 有效值為lightdark、或空字串，以使用預設主題。

• homeDashboardId— 收藏儀:id表板的數字。預設值為 0。

• 時區 — 有效值為utcbrowser、或空字串以使用預設值。

省略索引鍵會導致目前的值被系統預設值取代。

注意

若要將 Grafana API 與您的 Amazon 受管理工作區搭配使用，您必須擁有有效的 Grafana API 權杖。您可以在 API 要求的Authorization欄位中包含此項目。如需如何建立權杖以驗證 API 呼叫的相關資訊，請參閱使用令牌進行身。

取得目前使用者偏好

GET /api/user/preferences

範例請求

GET /api/user/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

回應範例

HTTP/1.1 200
Content-Type: application/json

{"theme":"","homeDashboardId":0,"timezone":""}

更新目前使用者偏好

PUT /api/user/preferences

範例請求

PUT /api/user/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "theme": "",
  "homeDashboardId":0,
  "timezone":"utc"
}

回應範例

HTTP/1.1 200
Content-Type: text/plain; charset=utf-8

{"message":"Preferences updated"}

取得目前的組織偏好

GET /api/org/preferences

範例請求

GET /api/org/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

回應範例

HTTP/1.1 200
Content-Type: application/json

{"theme":"","homeDashboardId":0,"timezone":""}

更新目前的組織偏好

PUT /api/org/preferences

範例請求

PUT /api/org/preferences HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "theme": "",
  "homeDashboardId":0,
  "timezone":"utc"
}

回應範例

HTTP/1.1 200
Content-Type: text/plain; charset=utf-8

{"message":"Preferences updated"}