Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# API di ricerca in cartelle/dashboard
<a name="Grafana-API-FolderDashboard-Search"></a>

Usa l'API FolderDashboard -Search per cercare cartelle e dashboard in un'area di lavoro Amazon Managed Grafana. 

**Nota**  
Per utilizzare un'API Grafana con il tuo spazio di lavoro Amazon Managed Grafana, devi disporre di un token API Grafana valido. Lo includi nel `Authorization` campo della richiesta API. Per informazioni su come creare un token per autenticare le chiamate API, consulta[Autenticazione con token](authenticating-grafana-apis.md).

## Cerca nelle cartelle e nei dashboard
<a name="Grafana-API-FolderDashboard-Search-create"></a>

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

Parametri di interrogazione:
+ **query — Interrogazione** di ricerca
+ **tag** — Elenco di tag da cercare. Questi sono tag Grafana, non AWS tag.
+ **tipo**: il tipo da cercare, `dash-folder` o`dash-db`.
+ **DashboardID**: elenco degli ID della dashboard da cercare.
+ **FolderID**: elenco di ID della dashboard da cercare nei dashboard.
+ **contrassegnato con un asterisco**: contrassegno per specificare che devono essere restituite solo le dashboard contrassegnate con asterisco.
+ **limite: limita** il numero di risultati restituiti (il massimo è 5000).
+ **pagina**: utilizza questo parametro per accedere agli accessi oltre il limite. La numerazione inizia da 1. Il `limit` parametro funge da dimensione della pagina. 

**Esempio di richiesta per il recupero di cartelle e dashboard della cartella generale**

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

**Esempio di risposta per il recupero di cartelle e dashboard della cartella generale**

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

**Esempio di richiesta per la ricerca di dashboard contrassegnati con stelle**

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

**Esempio di risposta per la ricerca di dashboard con stelle**

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