S3設定

このトピックでは、S3 設定に関連するエンコーディング設定の詳細について説明します。

公開

public:Boolean

API バージョン:V1、V2

親:出力またはサムネイル

デフォルト:偽

有効な値:真または偽

互換性のあるジョブタイプ:すべて

説明:

デフォルトでは、S3 バケットに格納されたファイルはパブリックに読み取り可能ではありません。代わりに、バケットオーナーフルコントロールの定型アクセスポリシーを使用します。これは、バケット自体がパブリックに読み取り可能な場合でも当てはまります。S3 バケットポリシーは、バケットに追加された新しいファイルによって自動的に継承されません。

パブリック API 設定を使用して、S3 へのファイル出力にパブリックに読み取り可能なフラグを立てます。これは、AllUsers グループに READ アクセス許可を付与することによって行われます。

この設定は、出力ビデオファイルと出力サムネイルの両方に適用されます。デフォルトでは、出力ファイルに設定された権限はサムネイルにも適用されます。access_controlを設定すると、この設定が上書きされます

手動アクセス権限の代わりに、バケットポリシーを使用することもできます。

詳細については、Amazon S3 ドキュメントを参照してください。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "public": true,
      "thumbnails": {
        "number": 6,
        "public": false
      }
    }
  ]
}

参照:access_control とサムネイル

rrs

rrs:Boolean

API バージョン:V1、V2

親:出力

デフォルト:偽

有効な値:真または偽

互換性のあるジョブタイプ:すべて

例:真

説明:

Amazon S3 の低冗長化ストレージを使用する場合は、このフラグを設定できます。Zencoder は、RRS を使用するように S3 に指示するために必要なヘッダーを渡します。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "rrs": true
    }
  ]
}

access

access_control:Array

API バージョン:V1、V2

親:出力またはサムネイル

有効な値:権限付与者と権限の 2 つの設定を含むハッシュの配列。

互換性のあるジョブタイプ:すべて

説明:

publicオプションは、特定のビデオまたはサムネイルのすべてのユーザーに S3 READ アクセス権を付与します。よりきめ細かい制御が必要な場合は、 access_control を使用してください。この設定を使用すると、 publicオプションは無視されます。この設定は、出力ビデオファイルと出力サムネイルの両方に適用されます。デフォルトでは、出力ファイルに設定された権限はサムネイルにも適用されます。

access_control は、アクセス許可とアクセス許可の 2 つの設定を持つアクセス制御許可の配列を取ります。

手動アクセス権限の代わりに、バケットポリシーを使用することもできます。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "access_control": [
        {
          "permission": "READ",
          "grantee": "someone@example.com"
        }
      ]
    }
  ]
}

参照:パブリック、被付与者、パーミッション

譲受人

grantee:String

API バージョン:V1、V2

親:出力 / access_control OR 出力 / サムネイル / access_contrl

有効な値:有効な S3 被付与者 (電子メール、ID、または URI)

互換性のあるジョブタイプ:すべて

説明:

S3 アクセス権限の被付与者:電子メールアドレスによるユーザー、CanonicalUser ID によるユーザー、または AWS アクセスグループ (http://acs.amazonaws.com/groups/global/AuthenticatedUsers または http://acs.amazonaws.com/groups/global/AllUsers)。詳細については、 S3 ACLのドキュメントを参照してください。

詳細な S3 アクセス許可の access_control設定の一部として使用されます。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "access_control": [
        {
          "permission": [
            "READ",
            "READ_ACP"
          ],
          "grantee": "someone@example.com"
        },
        {
          "permission": "FULL_CONTROL",
          "grantee": "cdc7931a9574b1055d5b76112021d0e9"
        },
        {
          "permission": "READ",
          "grantee": "http://acs.amazonaws.com/groups/global/AllUsers"
        },
        {
          "permission": "WRITE_ACP",
          "grantee": "http://acs.amazonaws.com/groups/global/AuthenticatedUsers"
        }
      ]
    }
  ]
}

参照:アクセスコントロールとパーミッション

許可

permission:String

API バージョン:V1、V2

親:出力 / access_control OR 出力 / サムネイル / access_contrl

有効な値:次のものを含む文字列または文字列の配列。読み取り、読み取り_ACP、書き込み_ACP、またはフルコントロール

互換性のあるジョブタイプ:すべて

説明:

S3 アクセス許可被付与者に与えるアクセス許可。詳細については、 S3 ACLのドキュメントを参照してください。

READ-ファイルへの読み取りアクセス。
READ_ACP-指定されたファイルのアクセス制御ポリシーを読み取る権限。
WRITE_ACP-指定されたファイルのアクセス制御ポリシーを書き込むアクセス許可。WRITE_ACP を持つユーザーがファイルの ACP を変更できるため、FULL_CONTROL に相当します。
FULL_CONTROL-ファイルへの読み取り、READ_ACP、WRITE_ACP のアクセス許可を付与します。

詳細な S3 アクセス許可の access_control設定の一部として使用されます。

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "access_control": [
        {
          "permission": [
            "READ",
            "READ_ACP"
          ],
          "grantee": "someone@example.com"
        },
        {
          "permission": "FULL_CONTROL",
          "grantee": "cdc7931a9574b1055d5b76112021d0e9"
        },
        {
          "permission": "READ_ACP",
          "grantee": "http://acs.amazonaws.com/groups/global/AllUsers"
        },
        {
          "permission": "WRITE_ACP",
          "grantee": "http://acs.amazonaws.com/groups/global/AuthenticatedUsers"
        }
      ]
    }
  ]
}

参照:アクセスコントロールと被付与者

ページコンテンツ

S3設定

公開

rrs

access

譲受人

許可