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

# フォルダ/ダッシュボード検索 API
<a name="Grafana-API-FolderDashboard-Search"></a>

フォルダ/ダッシュボード検索 API を使用して、Amazon Managed Grafana ワークスペース内のフォルダとダッシュボードを検索します。

**注記**  
Amazon Managed Grafana ワークスペースで Grafana API を使用するには、有効な Grafana API トークンが必要です。このトークンは API リクエストの `Authorization` フィールドに含めます。API コールを認証するトークンの作成方法については、「[トークンを使用した認証](authenticating-grafana-apis.md)」を参照してください。

## フォルダとダッシュボードの検索
<a name="Grafana-API-FolderDashboard-Search-create"></a>

```
GET /api/search/
```

クエリパラメータ:
+ **query** — クエリの検索
+ **tag** — 検索するタグのリストです。これらは Grafana タグであり、 AWS タグではありません。
+ **[タイプ]** — 検索する、`dash-folder` または `dash-db` のいずれかのタイプです。
+ **dashboardIds** — 検索するダッシュボード Id のリストです。
+ **folderIds** — ダッシュボード内で検索するダッシュボード Id のリストです。
+ **starred** — スター付きダッシュボードのみを返すように指定するフラグです。
+ **[制限]** — 返される結果の数の制限 (最大は 5000 です)。
+ **[ページ]** — このパラメータを使用して制限を超えるヒットにアクセスします。1 から番号が始まります。`limit` パラメータはページサイズの役目を果たします。

**全般フォルダのフォルダとダッシュボードを取得するためのリクエスト例**

```
GET /api/search?folderIds=0&query=&starred=false HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**全般フォルダのフォルダとダッシュボードを取得するためのレスポンス例**

```
HTTP/1.1 200
Content-Type: application/json

[
  {
    "id": 163,
    "uid": "000000163",
    "title": "Folder",
    "url": "/dashboards/f/000000163/folder",
    "type": "dash-folder",
    "tags": [],
    "isStarred": false,
    "uri":"db/folder" // deprecated in Grafana v5.0
  },
  {
    "id":1,
    "uid": "cIBgcSjkk",
    "title":"Production Overview",
    "url": "/d/cIBgcSjkk/production-overview",
    "type":"dash-db",
    "tags":[prod],
    "isStarred":true,
    "uri":"db/production-overview" // deprecated in Grafana v5.0
  }
]
```

**スター付きダッシュボードの検索のリクエスト例**

```
GET /api/search?query=Production%20Overview&starred=true&tag=prod HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**スター付きダッシュボードの検索のレスポンス例**

```
HTTP/1.1 200
Content-Type: application/json

[HTTP/1.1 200
Content-Type: application/json

[
  {
    "id":1,
    "uid": "cIBgcSjkk",
    "title":"Production Overview",
    "url": "/d/cIBgcSjkk/production-overview",
    "type":"dash-db",
    "tags":[prod],
    "isStarred":true,
    "folderId": 2,
    "folderUid": "000000163",
    "folderTitle": "Folder",
    "folderUrl": "/dashboards/f/000000163/folder",
    "uri":"db/production-overview" // deprecated in Grafana v5.0
  }
]
```