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.

# API de búsqueda de carpetas o paneles
<a name="Grafana-API-FolderDashboard-Search"></a>

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

**nota**  
Para usar una API de Grafana con su espacio de trabajo de Amazon Managed Grafana, debe tener un token de API de Grafana que sea válido. Lo incluye en el campo `Authorization` de la solicitud de API. Para obtener información sobre cómo crear un token para autenticar sus llamadas a la API, consulte [Autenticación con tokens](authenticating-grafana-apis.md).

## Búsqueda de carpetas y paneles
<a name="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
  }
]
```