本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
偏好設定 API
使用喜好設定 API 來處理 Amazon 受管 Grafana 工作區中的使用者偏好設定。
按鍵:
-
theme — 有效值為
light
dark
、或空字串,以使用預設主題。 -
homeDashboardId— 收藏儀
:id
表板的數字。預設值為 0。 -
時區 — 有效值為
utc
browser
、或空字串以使用預設值。
省略索引鍵會導致目前的值被系統預設值取代。
注意
若要將 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"}