Verwenden von Zencoder mit Azure

Zencoder kann Dateien (Blobs) von Ihren Azure-Containern hochladen und herunterladen. Die Angaben zu Konto, Container und Blob müssen in die URL der Auftragseingaben & eingebettet werden.

Arbeiten mit Azure

 

Azure-URLs müssen das Format azure: // Kontoname: Kontoschlüssel @ Container / Blob verwenden. Die folgende Jobanforderung zeigt, wie auf Azure-Speicherorte für Ein- und Ausgaben verwiesen wird:

{
    "api_key": "93h630j1dsyshjef620qlkavnmzui3",
    "input": "azure://account-name:account-key@container/file-name.avi",
    "outputs": [
    {
        "url": "azure://account-name:account-key@container/output-file-name.mp4",
        "width": "1280",
        "height": "720"
    }
    ]
}

Das Kontobezeichnung und Konto-Schlüssel sollte CGI entkommen sein. Es sollte nichts anderes als bei anderen URLs in Zencoder maskiert werden müssen. Sie finden sie in der Azure-Verwaltungsoberfläche. Der Kontoname ist der Name des Speicherkontos (verknüpft mit der Region usw.). Schlüssel sind am unteren Rand des Übersichtsbildschirms für das Konto verfügbar.

Jedes Azure-Konto kann mehrere Container haben. Das Container Das Feld in der URL muss in Azure definiert und konfiguriert werden, bevor es in einem Zencoder-Job verwendet werden kann.

Das Klecks Das Feld in der URL repräsentiert den Namen der Datei. Der Blob ist die einzige Komponente der URL, die in Azure nicht im Voraus konfiguriert werden muss.

Azure SAS-Token-Unterstützung

Die Unterstützung für die Autorisierung von Azure-Dateiübertragungen ist in Zencoder enthalten. Derzeit werden nur Account SAS-Token unterstützt, und mindestens die Parameter "sv", "si", "sr" und "sig" sind als Teil des Tokens erforderlich.

Beispiel für ein SAS-Token:

sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D

Es gibt zwei Möglichkeiten, das SAS-Token zusammen mit einer Azure-URL einzuschließen:

  • Hängen Sie das Token als Abfragezeichenfolgenparameter an die URL an.
  • Stellen Sie das Token separat mit der Einstellung "azure_sas" bereit.

API-Anforderungsbeispiele

Geben Sie URLs ein

Abfragezeichenfolgenversion
{  "input": "azure://account-name@container/path/to/input.mp4?sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D"}
Separate Parameterversion
{  "input": "azure://account-name@container/path/to/input.mp4",  "azure_sas": "sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D"}

Ausgabe-URLs

Abfragezeichenfolgenversion
{
  "outputs": [
    {
      "url": "azure://account-name@container/path/to/output.mp4?sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D"
    }
  ]
}
Separate Parameterversion
{
  "outputs": [
    {
      "url": "azure://account-name@container/path/to/output.mp4",  "azure_sas": "sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D"
    }
  ]
}

Miniaturansichten

Bei Miniaturansichten enthält die Basis-URL normalerweise keinen Dateinamen. Wie bei Ausgabe-URLs wird diese so aktualisiert, dass Abfragezeichenfolgenparameter erhalten bleiben, die ein SAS-Token enthalten.

Abfragezeichenfolgenversion

{
  "outputs": [
    {
      "thumbnails": [
        {
          "label": "my-thumbs",
          "number": 10,
          "base_url": "azure://account-name@container/path/to/thumbs/?sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D"
        }
      ]
    }
  ]
}

Separate Parameterversion

{
  "outputs": [
    {
      "thumbnails": [
        {
          "label": "my-thumbs",
          "number": 10,
          "base_url": "azure://account-name@container/path/to/thumbs/",
          "azure_sas": "sv=2019-10-10&si=sas-account&sr=c&sig=as87LKJHab87afjlghKJH654kjmasfRas02fabf34x8%3D"
        }
      ]
    }
  ]
}