Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Playlist-API
<a name="v12-Grafana-API-Playlist"></a>

Verwenden Sie die Playlist-API, um mit Playlisten im Amazon Managed Grafana-Arbeitsbereich zu arbeiten. 

**Anmerkung**  
Um eine Grafana-API mit Ihrem Amazon Managed Grafana-Workspace verwenden zu können, benötigen Sie ein gültiges Dienstkonto-Token. Sie fügen dies in das `Authorization` Feld in der API-Anfrage ein.

## Playlisten auflisten
<a name="v12-Grafana-API-Playlist-list"></a>

```
GET /apis/playlist.grafana.app/v1/namespaces/default/playlists
```

Listet alle Playlisten im Workspace auf.

**Beispielanforderung**

```
GET /apis/playlist.grafana.app/v1/namespaces/default/playlists HTTP/1.1
Accept: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Beispielantwort**

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

{
  "kind": "PlaylistList",
  "apiVersion": "playlist.grafana.app/v1",
  "metadata": {},
  "items": [
    {
      "kind": "Playlist",
      "apiVersion": "playlist.grafana.app/v1",
      "metadata": {
        "name": "my-playlist-uid",
        "namespace": "default"
      },
      "spec": {
        "title": "My Playlist",
        "interval": "5m",
        "items": [
          {"type": "dashboard_by_uid", "value": "dashboard-uid-1"}
        ]
      }
    }
  ]
}
```

## Holen Sie sich eine Playlist
<a name="v12-Grafana-API-Playlist-get"></a>

```
GET /apis/playlist.grafana.app/v1/namespaces/default/playlists/:name
```

Ruft eine bestimmte Playlist nach Namen (UID) ab.

**Beispielanforderung**

```
GET /apis/playlist.grafana.app/v1/namespaces/default/playlists/my-playlist-uid HTTP/1.1
Accept: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Beispielantwort**

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

{
  "kind": "Playlist",
  "apiVersion": "playlist.grafana.app/v1",
  "metadata": {
    "name": "my-playlist-uid",
    "namespace": "default"
  },
  "spec": {
    "title": "My Playlist",
    "interval": "5m",
    "items": [
      {"type": "dashboard_by_uid", "value": "dashboard-uid-1"}
    ]
  }
}
```

## Erstellen Sie eine Playlist
<a name="v12-Grafana-API-Playlist-create"></a>

```
POST /apis/playlist.grafana.app/v1/namespaces/default/playlists
```

Erzeugt eine neue Playlist.

**Beispielanforderung**

```
POST /apis/playlist.grafana.app/v1/namespaces/default/playlists HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "metadata": {"name": "my-new-playlist-uid"},
  "spec": {
    "title": "My New Playlist",
    "interval": "5m",
    "items": [
      {"type": "dashboard_by_uid", "value": "dashboard-uid-1"}
    ]
  }
}
```

## Aktualisiere eine Playlist
<a name="v12-Grafana-API-Playlist-update"></a>

```
PUT /apis/playlist.grafana.app/v1/namespaces/default/playlists/:name
```

Aktualisiert eine bestehende Playlist. Die gesamte Playlist-Spezifikation muss angegeben werden.

**Beispielanforderung**

```
PUT /apis/playlist.grafana.app/v1/namespaces/default/playlists/my-playlist-uid HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk

{
  "metadata": {
    "name": "my-playlist-uid",
    "resourceVersion": "1234567890"
  },
  "spec": {
    "title": "Updated Playlist",
    "interval": "10m",
    "items": [
      {"type": "dashboard_by_uid", "value": "dashboard-uid-1"},
      {"type": "dashboard_by_tag", "value": "monitoring"}
    ]
  }
}
```

## Lösche eine Playlist
<a name="v12-Grafana-API-Playlist-delete"></a>

```
DELETE /apis/playlist.grafana.app/v1/namespaces/default/playlists/:name
```

Löscht eine Playlist nach Namen (UID).

**Beispielanforderung**

```
DELETE /apis/playlist.grafana.app/v1/namespaces/default/playlists/my-playlist-uid HTTP/1.1
Accept: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Beispielantwort**

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

{
  "kind": "Status",
  "apiVersion": "v1",
  "status": "Success",
  "code": 200
}
```

## Playlist durchsuchen (veraltet)
<a name="v12-Grafana-API-Playlist-search"></a>

**Wichtig**  
Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen [Playlisten auflisten](#v12-Grafana-API-Playlist-list).

```
GET /api/playlists
```

Gibt alle Playlisten für den aktuellen Amazon Managed Grafana-Arbeitsbereich mithilfe von Paginierung zurück.

**Beispielanforderung**

```
GET /api/playlists HTTP/1.1
Accept: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

Querystring-Parameter:
+ **query** — Beschränkt die Antworten auf Playlisten, die einen Namen wie diesen Wert haben.
+ **Limit** — Beschränkt die Antwort auf die X-Anzahl von Playlisten.

**Beispielantwort**

```
HTTP/1.1 200
Content-Type: application/json
[
  {
    "id": 1,
    "name": "my playlist",
    "interval": "5m"
  }
]
```

## Holen Sie sich eine Playlist (veraltet)
<a name="v12-Grafana-API-Playlist-getone"></a>

**Wichtig**  
Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen [Holen Sie sich eine Playlist](#v12-Grafana-API-Playlist-get).

```
GET /api/playlists/:id
```

**Beispielanforderung**

```
GET /api/playlists/1 HTTP/1.1
Accept: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Beispielantwort**

```
HTTP/1.1 200
Content-Type: application/json
{
  "id" : 1,
  "name": "my playlist",
  "interval": "5m",
  "orgId": "my org",
  "items": [
    {
      "id": 1,
      "playlistId": 1,
      "type": "dashboard_by_id",
      "value": "3",
      "order": 1,
      "title":"my third dashboard"
    },
    {
      "id": 2,
      "playlistId": 1,
      "type": "dashboard_by_tag",
      "value": "myTag",
      "order": 2,
      "title":"my other dashboard"
    }
  ]
}
```

## Ruft Playlist-Elemente ab (veraltet)
<a name="v12-Grafana-API-Playlist-get-items"></a>

**Wichtig**  
Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen [Holen Sie sich eine Playlist](#v12-Grafana-API-Playlist-get). Playlist-Elemente sind in der Playlist-Antwort enthalten.

```
GET /api/playlists/:id/items
```

**Beispielanforderung**

```
GET /api/playlists/1/items HTTP/1.1
Accept: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Beispielantwort**

```
HTTP/1.1 200
Content-Type: application/json
[
  {
    "id": 1,
    "playlistId": 1,
    "type": "dashboard_by_id",
    "value": "3",
    "order": 1,
    "title":"my third dashboard"
  },
  {
    "id": 2,
    "playlistId": 1,
    "type": "dashboard_by_tag",
    "value": "myTag",
    "order": 2,
    "title":"my other dashboard"
  }
]
```

## Holen Sie sich Playlist-Dashboards (veraltet)
<a name="v12-Grafana-API-Playlist-get-dashboards"></a>

**Wichtig**  
Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen [Holen Sie sich eine Playlist](#v12-Grafana-API-Playlist-get).

```
GET /api/playlists/:id/dashboards
```

**Beispielanforderung**

```
GET /api/playlists/1/dashboards HTTP/1.1
Accept: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Beispielantwort**

```
HTTP/1.1 200
Content-Type: application/json
[
  {
    "id": 3,
    "title": "my third dashboard",
    "order": 1,
  },
  {
    "id": 5,
    "title":"my other dashboard"
    "order": 2,

  }
]
```

## Eine Playlist erstellen (veraltet)
<a name="v12-Grafana-API-Playlist-create-legacy"></a>

**Wichtig**  
Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen [Erstellen Sie eine Playlist](#v12-Grafana-API-Playlist-create).

```
POST /api/playlists/
```

**Beispielanforderung**

```
PUT /api/playlists/1 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
  {
    "name": "my playlist",
    "interval": "5m",
    "items": [
      {
        "type": "dashboard_by_id",
        "value": "3",
        "order": 1,
        "title":"my third dashboard"
      },
      {
        "type": "dashboard_by_tag",
        "value": "myTag",
        "order": 2,
        "title":"my other dashboard"
      }
    ]
  }
```

**Beispielantwort**

```
HTTP/1.1 200
Content-Type: application/json
  {
    "id": 1,
    "name": "my playlist",
    "interval": "5m"
  }
```

## Eine Playlist aktualisieren (veraltet)
<a name="v12-Grafana-API-Playlist-update-legacy"></a>

**Wichtig**  
Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen [Aktualisiere eine Playlist](#v12-Grafana-API-Playlist-update).

```
PUT /api/playlists/:id
```

**Beispielanforderung**

```
PUT /api/playlists/1 HTTP/1.1
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
  {
    "name": "my playlist",
    "interval": "5m",
    "items": [
      {
        "playlistId": 1,
        "type": "dashboard_by_id",
        "value": "3",
        "order": 1,
        "title":"my third dashboard"
      },
      {
        "playlistId": 1,
        "type": "dashboard_by_tag",
        "value": "myTag",
        "order": 2,
        "title":"my other dashboard"
      }
    ]
  }
```

**Beispielantwort**

```
HTTP/1.1 200
Content-Type: application/json
{
  "id" : 1,
  "name": "my playlist",
  "interval": "5m",
  "orgId": "my org",
  "items": [
    {
      "id": 1,
      "playlistId": 1,
      "type": "dashboard_by_id",
      "value": "3",
      "order": 1,
      "title":"my third dashboard"
    },
    {
      "id": 2,
      "playlistId": 1,
      "type": "dashboard_by_tag",
      "value": "myTag",
      "order": 2,
      "title":"my other dashboard"
    }
  ]
}
```

## Eine Playlist löschen (veraltet)
<a name="v12-Grafana-API-Playlist-delete-legacy"></a>

**Wichtig**  
Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen [Lösche eine Playlist](#v12-Grafana-API-Playlist-delete).

```
DELETE /api/playlists/:id
```

**Beispielanforderung**

```
DELETE /api/playlists/1 HTTP/1.1
Accept: application/json
Authorization: Bearer eyJrIjoiT0tTcG1pUlY2RnVKZTFVaDFsNFZXdE9ZWmNrMkZYbk
```

**Beispielantwort**

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