S3-Einstellungen

Dieses Thema enthält Details zu den Kodierungseinstellungen im Zusammenhang mit den S3-Einstellungen.

Öffentlichkeit

public:Boolean

API-Versionen: V2

Eltern: Ausgänge ODER Thumbnails

Standard: falsch

Gültige Werte: richtig oder falsch

Kompatible Auftragstypen: VOD

Beschreibung:

Standardmäßig sind Dateien, die in einen S3-Bucket gestellt werden, nicht öffentlich lesbar. Stattdessen verwenden wir die Richtlinie für den vordefinierten Zugriff von Eimer-Besitzer-volle Kontrolle. Dies gilt auch dann, wenn der Bucket selbst öffentlich lesbar ist. Eine S3-Bucket-Richtlinie wird nicht automatisch von neuen Dateien geerbt, die dem Bucket hinzugefügt wurden.

Verwenden Sie die Öffentlichkeit API-Einstellung zum Kennzeichnen einer Dateiausgabe an S3 als öffentlich lesbar. Dies erfolgt durch Erteilen der READ-Berechtigung an die AllUsers-Gruppe.

Diese Einstellung gilt sowohl für Ausgabevideodateien als auch für Ausgabe-Miniaturansichten. Standardmäßig gelten die für eine Ausgabedatei festgelegten Berechtigungen auch für Miniaturansichten. Rahmen Zugangskontrolle überschreibt diese Einstellung.

Eine Alternative zu manuellen Berechtigungen wäre die Verwendung von a Bucket-Richtlinie.

Weitere Informationen aus den Amazon S3-Dokumenten.

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

Siehe auch: Zugangskontrolle und Thumbnails

rrs

rrs:Boolean

API-Versionen: V2

Elternteil: Ausgänge

Standard: falsch

Gültige Werte: richtig oder falsch

Kompatible Auftragstypen: VOD

Beispiel: wahr

Beschreibung:

Wenn Sie den reduzierten Redundanzspeicher von Amazon S3 verwenden, können Sie dieses Flag setzen, und Zencoder übergibt die erforderlichen Header, um S3 anzuweisen, RRS zu verwenden.

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

access_control

access_control:Array

API-Versionen: V2

Eltern: Ausgänge ODER Thumbnails

Gültige Werte: Eine Reihe von Hashes mit zwei Einstellungen: Berechtigter und Berechtigungen.

Kompatible Auftragstypen: VOD

Beschreibung:

Das Öffentlichkeit Mit dieser Option erhalten alle Benutzer für ein bestimmtes Video oder eine bestimmte Miniaturansicht Zugriff auf S3 READ. Wenn Sie eine feinkörnigere Steuerung wünschen, verwenden Sie Zugangskontrolle. Wenn Sie diese Einstellung verwenden, wird die Öffentlichkeit Option ignoriert werden. Diese Einstellung gilt sowohl für Ausgabevideodateien als auch für Ausgabe-Miniaturansichten. Standardmäßig gelten die für eine Ausgabedatei festgelegten Berechtigungen auch für Miniaturansichten.

access_control verwendet eine Reihe von Zugriffssteuerungszuschüssen, die jeweils zwei Einstellungen haben: Stipendiat und Genehmigung.

Eine Alternative zu manuellen Berechtigungen wäre die Verwendung von a Bucket-Richtlinie.

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

Siehe auch: Öffentlichkeit, Stipendiat und Erlaubnis

Erwerber

grantee:String

API-Versionen: V2

Eltern: Ausgänge /. Zugangskontrolle ODER Ausgänge /. Thumbnails /. Zugangskontrolle

Gültige Werte: Ein gültiger S3-Berechtigter (E-Mail, ID oder URI)

Kompatible Auftragstypen: VOD

Beschreibung:

Ein Berechtigter für S3-Berechtigungen: Benutzer nach E-Mail-Adresse, Benutzer nach CanonicalUser ID oder AWS-Zugriffsgruppe (http://acs.amazonaws.com/groups/global/AuthenticatedUsers oder http://acs.amazonaws.com/groups/). global / AllUsers). Siehe die S3 ACL-Dokumente für mehr Details.

Wird als Teil der access_control Einstellung für feinkörnige S3-Berechtigungen verwendet.

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

Siehe auch: Zugangskontrolle und Genehmigung

Genehmigung

permission:String

API-Versionen: V2

Eltern: Ausgänge /. Zugangskontrolle ODER Ausgänge /. Thumbnails /. Zugangskontrolle

Gültige Werte: Eine Zeichenfolge oder ein Array von Zeichenfolgen, die Folgendes enthalten: READ, READ_ACP, WRITE_ACP oder FULL_CONTROL

Kompatible Auftragstypen: VOD

Beschreibung:

Eine Erlaubnis, einem S3-Berechtigungsempfänger zu erteilen. Siehe die S3 ACL-Dokumente für mehr Details.

  • READ - Lesezugriff auf eine Datei.
  • READ_ACP - Berechtigung zum Lesen der Zugriffssteuerungsrichtlinie für die angegebene Datei.
  • WRITE_ACP - Berechtigung zum Schreiben der Zugriffssteuerungsrichtlinie für die angegebene Datei. Entspricht FULL_CONTROL, da ein Benutzer mit WRITE_ACP das ACP für eine Datei ändern kann.
  • FULL_CONTROL - Erteilt einer Datei die Berechtigungen READ, READ_ACP und WRITE_ACP.

Wird als Teil der access_control Einstellung für feinkörnige S3-Berechtigungen verwendet.

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

Siehe auch: Zugangskontrolle und Stipendiat