Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Folder/Dashboard API de búsqueda
<a name="v10-Grafana-API-FolderDashboard-Search"></a>

Usa la FolderDashboard-Search API para buscar carpetas y paneles en un espacio de trabajo de Grafana gestionado por Amazon. 

**nota**  
Para usar una API de Grafana con tu espacio de trabajo de Grafana gestionado por Amazon, debes tener un token de cuenta de servicio válido. Lo incluye en el campo `Authorization` de la solicitud de API.

## Búsqueda de carpetas y paneles
<a name="v10-Grafana-API-FolderDashboard-Search-create"></a>

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

Parámetros de consulta:
+ **query**: consulta de búsqueda.
+ **tag**: lista de etiquetas que se deben buscar. Son etiquetas de Grafana, no AWS etiquetas.
+ **type**: tipo que se deben buscar, ya sea `dash-folder` o `dash-db`.
+ **dashboardIds**: lista de los ID de panel que se deben buscar.
+ **folderIds**: lista de los ID de panel que se deben buscar en los paneles.
+ **starred**: marca para especificar que solo se deben mostrar los paneles destacados.
+ **limit**: limite el número de resultados devueltos (el máximo es 5000).
+ **page**: utilice este parámetro para acceder a los aciertos que superen el límite. La numeración empieza en 1. El parámetro `limit` actúa como tamaño de página. 

**Ejemplo de solicitud para recuperar carpetas y paneles de la carpeta general**

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

**Ejemplo de respuesta para recuperar carpetas y paneles de la carpeta general**

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

**Ejemplo de solicitud para buscar paneles destacados**

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

**Ejemplo de respuesta para buscar paneles destacados**

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