AzureのでZencoderを使用する

Azureの操作

Azure URL は、Azure: //アカウント名:アカウントキー @container /blob 形式を使用する必要があります。次のジョブリクエストは、入力と出力の Azure の場所を参照する方法を示しています。

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

アカウント名とアカウントキーは CGIエスケープする必要があります。Zencoder の他の URL と同様に、エスケープする必要はありません。これらは、Azureの管理インターフェイスで見つけることができます。アカウント名は、ストレージアカウント (リージョンなどにリンク) の名前です。キーは、アカウントの概要画面の下部から利用できます。

各 Azure アカウントは、複数のコンテナーを持つことができます。URL のオブジェクトフィールドを Zencoder ジョブで使用するには、Azure で定義して構成する必要があります。

URL の BLOBフィールドは、ファイルの名前を表します。BLOB は、Azure で事前に構成する必要がない URL の唯一のコンポーネントです。

Azure SAS トークンのサポート

Azure ファイル転送の承認のサポートは Zencoder に含まれています。現在、アカウント SAS トークンのみがサポートされており、トークンの一部として「sv」、「si」、「sr」、および「sig」パラメータが必要です。

SAS トークンの例:

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

SAS トークンと Azure URL を含めるには、次の 2 つの方法があります。

• トークンを URL にクエリ文字列パラメーターとして追加します。
• 「azure_sas」設定でトークンを個別に提供します。

APIリクエストの例

入力 URL

クエリ文字列バージョン

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

別個のパラメータバージョン

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

出力URL

クエリ文字列バージョン

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

別個のパラメータバージョン

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

サムネイル URL

サムネイルの場合、ベース URL には通常、ファイル名は含まれません。出力 URL と同様に、これは SAS トークンを含むクエリ文字列パラメータを保持する方法で更新されます。

クエリ文字列バージョン

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

別個のパラメータバージョン

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