Paramètres S3

Cette rubrique contient des détails sur les paramètres de codage liés aux paramètres S3.

public

public:Boolean

Versions de l'API : V2

Parents : sorties ou miniatures

Valeur par défaut : false

Valeurs valides : vrai ou faux

Types de tâches compatibles : VOD

Description :

Par défaut, les fichiers placés dans un compartiment S3 ne sont pas lisibles publiquement. Au lieu de cela, nous utilisons la politique d'accès standard de bucket-owner-full-control. Cela est vrai même si le compartiment lui-même est lisible publiquement - une stratégie de compartiment S3 n'est pas automatiquement héritée par les nouveaux fichiers ajoutés au compartiment.

Utilisez le Publique Paramètre d'API pour marquer une sortie de fichier vers S3 comme étant publiquement lisible. Cela se fait en accordant l'autorisation READ au groupe AllUsers.

Ce paramètre s'applique à la fois aux fichiers vidéo de sortie et aux vignettes de sortie. Par défaut, les autorisations définies sur un fichier de sortie s'appliquent également aux vignettes. Réglage contrôle d'accès remplacera ce paramètre.

Une alternative aux autorisations manuelles serait d'utiliser un politique de seau.

Plus d'informations sur les documents Amazon S3.

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

Voir aussi : access_control et miniatures

rrs

rrs:Boolean

Versions de l'API : V2

Parent : sorties

Valeur par défaut : false

Valeurs valides : vrai ou faux

Types de tâches compatibles : VOD

Exemple : vrai

Description :

Si vous utilisez le stockage à redondance réduite d'Amazon S3, vous pouvez définir cet indicateur et Zencoder transmettra les en-têtes nécessaires pour indiquer à S3 d'utiliser RRS.

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

access_control

access_control:Array

Versions de l'API : V2

Parents : sorties ou miniatures

Valeurs valides : Un tableau de hachages contenant deux paramètres : le bénéficiaire et les autorisations.

Types de tâches compatibles : VOD

Description :

Les Publique L'option accorde l'accès S3 READ à tous les utilisateurs pour une vidéo ou une vignette donnée. Si vous voulez un contrôle plus fin, utilisez contrôle d'accès. L'utilisation de ce paramètre entraînera la Publique option à ignorer. Ce paramètre s'applique à la fois aux fichiers vidéo de sortie et aux vignettes de sortie. Par défaut, les autorisations définies sur un fichier de sortie s'appliquent également aux vignettes.

access_control prend un tableau de subventions de contrôle d'accès, chacune ayant deux paramètres : le bénéficiaire et l'autorisation.

Une alternative aux autorisations manuelles serait d'utiliser un politique de seau.

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

Voir également: Publique , bénéficiaire , et autorisation

bénéficiaire

grantee:String

Versions de l'API : V2

Parents : sorties/ access_control OR sorties/ miniatures/ access_control

Valeurs valides : Un bénéficiaire S3 valide (e-mail, ID ou URI)

Types de tâches compatibles : VOD

Description :

Un bénéficiaire d'autorisations S3 : utilisateur par adresse e-mail, utilisateur par CanonicalUser ID ou un groupe d'accès AWS (http://acs.amazonaws.com/groups/global/AuthenticatedUsers ou http://acs.amazonaws.com/groups/global/AllUsers). Voir le Documentation de l'ACL S3 pour plus de détails.

Utilisé dans le cadre du contrôle d'accès réglage des autorisations S3 à granularité fine.

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

Voir aussi : access_control et permission

autorisation

permission:String

Versions de l'API : V2

Parents : sorties/ access_control OR sorties/ miniatures/ access_control

Valeurs valides : Une chaîne ou un tableau de chaînes contenant : READ, READ_ACP, WRITE_ACP ou FULL_CONTROL

Types de tâches compatibles : VOD

Description :

Une autorisation de donner à un bénéficiaire de l'autorisation S3. Voir le Documentation de l'ACL S3 pour plus de détails.

  • LECTURE - accès en lecture à un fichier.
  • READ_ACP - autorisation de lire la stratégie de contrôle d'accès pour le fichier donné.
  • WRITE_ACP - autorisation d'écrire la stratégie de contrôle d'accès pour le fichier donné. Équivalent à FULL_CONTROL, puisqu'un utilisateur avec WRITE_ACP peut changer l'ACP d'un fichier.
  • FULL_CONTROL - accorde des autorisations READ, READ_ACP et WRITE_ACP à un fichier.

Utilisé dans le cadre du contrôle d'accès réglage des autorisations S3 à granularité fine.

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

Voir aussi : access_control and grantee