View a markdown version of this page

Playlist-API - Amazon Managed Grafana
Playlisten auflistenHolen Sie sich eine PlaylistErstellen Sie eine PlaylistAktualisiere eine PlaylistLösche eine PlaylistPlaylist durchsuchen (veraltet)Holen Sie sich eine Playlist (veraltet)Ruft Playlist-Elemente ab (veraltet)Holen Sie sich Playlist-Dashboards (veraltet)Eine Playlist erstellen (veraltet)Eine Playlist aktualisieren (veraltet)Eine Playlist löschen (veraltet)

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

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

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

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

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

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

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
}
Wichtig

Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen Playlisten auflisten.

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)

Wichtig

Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen Holen Sie sich eine Playlist.

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)

Wichtig

Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen Holen Sie sich eine Playlist. 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)

Wichtig

Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen Holen Sie sich eine Playlist.

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)

Wichtig

Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen Erstellen Sie eine Playlist.

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)

Wichtig

Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen Aktualisiere eine Playlist.

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)

Wichtig

Dieser Endpunkt ist veraltet. Verwenden Sie stattdessen Lösche eine Playlist.

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
{}