設定 API - Amazon Managed Grafana
現在のユーザー設定の取得現在のユーザー設定の更新現在の組織設定の取得現在の組織設定の更新

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

設定 API

設定 API を使用して、Amazon Managed Grafana ワークスペースでユーザー設定を使用します。

キー:

  • theme — 有効な値は light、dark、またはデフォルトテーマを使用する空の文字列です。

  • homeDashboardId — お気に入りのダッシュボードの数値の :id です。デフォルトは 0 です。

  • [タイムゾーン] — 有効な値は utc、browser、またはデフォルトを使用する空の文字列です。

キーを省略すると、現在の値はシステムのデフォルト値に置き換えられます。

注記

Amazon Managed Grafana ワークスペースで Grafana API を使用するには、有効な 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"}