S3 設定

本主題包含有關與S3設置有關的編碼設置的詳細信息。

上市

public:Boolean

API 版本:V2

父母:輸出要么縮圖

默認:

有效值:對或錯

兼容的工作類型:VOD

描述:

默認情況下,放入S3存儲桶的文件是不公開可讀的。相反,我們使用以下的固定訪問策略桶所有者完全控制。即使存儲桶本身是公共可讀的,也是如此-S3存儲桶策略不會被添加到存儲桶的新文件自動繼承。

使用上市 API設置,將輸出到S3的文件標記為公開可讀。這是通過向AllUsers組授予READ權限來完成的。

此設置適用於輸出視頻文件和輸出縮略圖。依預設,在輸出檔案上設定的權限也會套用至縮圖。設置訪問控制將覆蓋此設置。

手動權限的替代方法是使用存儲桶策略

更多信息來自Amazon S3文檔。

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

也可以看看:訪問控制縮圖

RRS

rrs:Boolean

API 版本:V2

上級:輸出

默認:

有效值:對或錯

兼容的工作類型:VOD

例:真正

描述:

如果您使用Amazon S3的精簡冗餘存儲,則可以設置此標誌,並且Zencoder將傳遞必要的標頭以告知S3使用RRS。

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

訪問控制

access_control:Array

API 版本:V2

父母:輸出要么縮圖

有效值:包含兩個設置的哈希數組:被授予者和權限。

兼容的工作類型:VOD

描述:

上市選項將給定視頻或縮略圖的S3 READ訪問權授予所有用戶。如果您想要更細粒度的控制,請使用訪問控制。使用此設置將導致上市選項被忽略。此設置適用於輸出視頻文件和輸出縮略圖。依預設,在輸出檔案上設定的權限也會套用至縮圖。

access_control採用一組訪問控制授權,每個授權都有兩個設置:受贈人允許

手動權限的替代方法是使用存儲桶策略

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

也可以看看:上市受贈人允許

受贈人

grantee:String

API 版本:V2

父母:輸出 / 訪問控制要么輸出 / 縮圖 / 訪問控制

有效值:有效的S3受贈方(電子郵件,ID或URI)

兼容的工作類型:VOD

描述:

S3權限的被授予者:用戶通過電子郵件地址,用戶通過CanonicalUser ID或AWS訪問組(http://acs.amazonaws.com/groups/global/AuthenticatedUsers或http://acs.amazonaws.com/groups/全局/ AllUsers)。見S3 ACL文檔有關更多詳細信息。

用作訪問控制細粒度S3權限的設置。

{
  "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 版本:V2

父母:輸出 / 訪問控制要么輸出 / 縮圖 / 訪問控制

有效值:包含以下內容的字符串或字符串數組:READ,READ_ACP,WRITE_ACP或FULL_CONTROL

兼容的工作類型:VOD

描述:

授予S3許可受讓人的許可。見S3 ACL文檔有關更多詳細信息。

  • READ-讀取文件權限。
  • READ_ACP-讀取給定文件的訪問控制策略的權限。
  • WRITE_ACP-寫入給定文件的訪問控制策略的權限。等效於FULL_CONTROL,因為具有WRITE_ACP的用戶可以更改文件的ACP。
  • FULL_CONTROL-授予對文件的READ,READ_ACP和WRITE_ACP權限。

用作訪問控制細粒度S3權限的設置。

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

也可以看看:訪問控制受贈人