Digitale Master-Lösch-API

Einleitung

Die CMS-API verfügt über eine Funktion zum Löschen des digitalen Masters (Quelldatei für ein Video) im Video Cloud-Katalog. Auf diese Weise können Sie einmalige Bereinigungsaufgaben ausführen, um die Größe Ihres verwalteten Inhalts zu verringern.

Um zu verstehen, wie Master archiviert werden und wie Sie deren Archivierung überhaupt verhindern können - wenn Sie das möchten - siehe Archivierung von Mastern.

Voraussetzungen

Das Löschen von digitalen Mastern kann mit dem erfolgen CMS API nur - Diese Option ist in Studio nicht verfügbar.

Auswirkungen des Löschens von Mastern

Bevor Sie fortfahren, sollten Sie sich mit den folgenden Auswirkungen des Löschens digitaler Master vertraut machen:

Sie können ein Video nicht mehr neu transcodieren, nachdem sein Master gelöscht wurde. Wenn Sie neue Wiedergaben benötigen, müssen Sie das Video durch ersetzen Studio oder der Dynamische Aufnahme-API.
Die Verwaltung von Videos über die Batch-Bereitstellung (eingestellt) funktioniert nicht mehr. Verwenden Sie die CMS und Dynamische Aufnahme Stattdessen APIs.
Das Löschen eines digitalen Masters ist a dauerhaft Betrieb. Wir kann nicht gelöschte digitale Master wiederherstellen.

Schritte: Löschen eines digitalen Masters

Führen Sie die folgenden Schritte aus, um einen digitalen Master zu löschen.

Sicher sein Sie haben Ihre eigene Kopie des Masters falls Sie es jemals brauchen.
Wenn Sie Videos neu transcodieren müssen, tun Sie dies, bevor Sie den Master löschen. Nachdem der Master gelöscht wurde Sie können das Video nicht mehr neu transcodieren.

Rufen Sie die erforderlichen Client-Anmeldeinformationen für den Vorgang ab. Die Client-Anmeldeinformationen müssen Berechtigungen für die folgenden Vorgänge enthalten:

      [
          "video-cloud/asset/delete",
          "video-cloud/video/read"
      ]

Diese Berechtigungen sind nicht in der Studio-Benutzeroberfläche verfügbar, Sie müssen also die OAuth-API sie zu erhalten. Unten ist ein cURL-Befehl, der die Aufgabe erledigt, wenn Sie die hervorgehobenen Elemente durch Ihre eigenen Informationen ersetzen:

      curl --request POST \
        --url https://oauth.brightcove.com/v4/client_credentials \
        --header 'authorization: BC_TOKEN YOUR_BC_TOKEN' \
        --header 'content-type: application/json' \
        --data '{
        "type": "credential",
        "maximum_scope": [
          {
            "identity": {
              "type": "video-cloud-account",
              "account-id": YOUR_ACCOUNT_ID
            },
            "operations": [
          "video-cloud/asset/delete",
          "video-cloud/video/read"
      ]
          }
        ],
        "name": "Delete-Masters"
      }'

Um Ihr BC_TOKEN zu erhalten, öffnen Sie eine beliebige Studio-Seite (Sie müssen ein Administrator des Kontos sein), öffnen Sie die JavaScript-Konsole in Ihrem Browser, fügen Sie den unten stehenden Javascript-Code ein und drücken Sie die Eingabetaste (Eingabe):

      var cookiesArray = document.cookie.split(";"), cookiesObj = {}, i, tmpArray = [];
      for (i = 0; i < cookiesArray.length; i++) {
          tmpArray = cookiesArray[i].split("=");
          if (tmpArray[0].indexOf('BC_TOKEN') > -1) {
              cookiesObj.BC_TOKEN = tmpArray[1];
          }
      }
      window.prompt("BC_TOKEN:", cookiesObj.BC_TOKEN);

Verwenden Sie die Client-Anmeldeinformationen, um ein Zugriffstoken generieren

Löschen Sie digitale Master mithilfe dieser Endpunkte.

Master löschen
Basis-URL	`https://cms.api.brightcove.com/v1`
Methode	`DELETE`
Endpunkt	`/accounts/accountID/videos/videoID/digital_master`
Kopfzeile	`Authorization: Bearer Authorization: Bearer {access_token}`
Antwort	204 NO_CONTENT (204 ist eine Standardantwort für Löschvorgänge, die angibt, dass der Vorgang erfolgreich war oder das Asset bereits gelöscht wurde.)