As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# API de pesquisa de pastas e dashboards
<a name="Grafana-API-FolderDashboard-Search"></a>

Use a API FolderDashboard -Search para pesquisar pastas e painéis em um espaço de trabalho do Amazon Managed Grafana. 

**nota**  
Para usar uma API do Grafana com o espaço de trabalho do Amazon Managed Grafana, você deve ter um token válido da API do Grafana. Você inclui isso no campo `Authorization` na solicitação da API. Para obter informações sobre como criar um token para autenticar as chamadas de API, consulte [Autenticação com tokens](authenticating-grafana-apis.md).

## Pesquisar pastas e dashboards
<a name="Grafana-API-FolderDashboard-Search-create"></a>

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

Parâmetros de consulta:
+ **consulta**: consulta de pesquisa
+ **tag**: lista as tags a serem pesquisadas. Essas são tags Grafana, não AWS tags.
+ **tipo**: o tipo a ser pesquisado, `dash-folder` ou `dash-db`.
+ **dashboardIds**: lista de IDs de dashboard a serem pesquisados.
+ **folderIds**: lista de IDs de dashboard a serem pesquisados nos dashboards.
+ **com estrela**: sinalize para especificar que somente dashboards com estrela devem ser retornados.
+ **limite**: limita o número de resultados retornados (o máximo é 5 mil).
+ **página**: use este parâmetro para acessar ocorrências além do limite. A numeração começa em 1. O parâmetro `limit` atua como tamanho da página. 

**Exemplo de solicitação para recuperar pastas e dashboards da pasta geral**

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

**Exemplo de resposta para recuperar pastas e dashboards da pasta geral**

```
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
  }
]
```

**Exemplo de solicitação para pesquisar dashboards com estrela**

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

**Exemplo de resposta para pesquisar dashboards com estrela**

```
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
  }
]
```