S3 Push Delivery est une méthode que les studios, les fournisseurs de distribution et les autres fournisseurs de contenu peuvent utiliser pour envoyer des fichiers vers Prime Video.
Amazon Simple Storage Service (S3) est un service de stockage d’objets d’Amazon Web Services (AWS). S3 Push Delivery permet aux partenaires de copier en toute sécurité des fichiers depuis leur propre compartiment Amazon S3 directement vers Prime Video.
S3 Push Delivery offre plusieurs avantages, notamment :
- Réduction des coûts : les transferts du compartiment S3 d’un fournisseur de contenu vers Prime Video à l’aide de S3 Push Delivery entraînent une réduction des frais de sortie AWS pour les fournisseurs de contenu dont les compartiments S3 sont hébergés en Amérique du Nord et dans les régions AWS EMEA.
- Vitesses de livraison plus rapides : les fichiers livrés via S3 Push Delivery sont transférés jusqu’à 3 fois plus rapidement que ceux livrés via d’autres méthodes de livraison groupée.
Le schéma système suivant montre comment les fichiers de deux comptes AWS partenaires différents sont transférés via une méthode de transfert de fichiers choisie (S3 Copy ou AWS DataSync) vers un point d’accès d’un compte AWS Prime Video, puis sont ingérés dans Prime Video.
Commencez
Pour recevoir et tester un point d’accès S3 où vous pouvez livrer vos fichiers :
- Créez un ticket d’assistance Nous contacter pour demander l’intégration à S3, ou contactez votre POM ou CAM pour effectuer cette demande en votre nom. Veuillez fournir les informations suivantes dans la demande :
- Rôles AWS Identity and Account Management (IAM) nécessitant un accès.
Par exemple : arn:aws:iam : :role/this-is-a-test-role - Noms des comptes de diffusion vidéo Prime qui effectueront des diffusions en votre nom.
Par exemple : test_account - Région AWS dans laquelle votre compartiment S3 est hébergé.
Votre contact Amazon vous contactera ensuite pour vous informer des prochaines étapes et vous faire part du point d’accès S3 à utiliser pour vos livraisons.
Par exemple : arn:aws:s3 : ::test-s3-accesspoint-agsen8dehko1eyjxo3myhtui4cgs4use1b-s3alias - Rôles AWS Identity and Account Management (IAM) nécessitant un accès.
- Mettez à jour vos rôles IAM avec les politiques nécessaires pour copier vos fichiers dans le compartiment S3 de Prime Video via votre point d’accès. L’exemple suivant montre les autorisations attendues. Dans ce code :
- Remplacez le nom source_bucket par votre propre nom de bucket S3.
- Remplacez le nom destination_bucket, destination_bucket_access_point_alias, prime_video_provided_prefix et access_point_name par les informations fournies par votre POM.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "Statement1", "Effect": "Allow", "Action": [ "s3:GetObject", "s3:PutObject", "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::source_bucket", "arn:aws:s3:::source_bucket/*", "arn:aws:s3:::destination_bucket", "arn:aws:s3:::destination_bucket/*", "arn:aws:s3:::destination_bucket_access_point_alias", "arn:aws:s3:::destination_bucket_access_point_alias/prime_video_provided_prefix/*", "arn:aws:s3:us-east-1:1231231231:accesspoint/access_point_name", "arn:aws:s3:us-east-1:1231231231:accesspoint/access_point_name/object/prime_video_provided_prefix/*" ] } ] }
Après avoir reçu votre point d’accès et mis à jour les autorisations de votre rôle IAM, vous pouvez livrer des fichiers en utilisant l’une des méthodes de transfert de fichiers décrites dans la section suivante.
- En utilisant la méthode que vous avez choisie, envoyez d’abord un fichier de test initial (tel que test.txt) et vérifiez que le fichier est visible dans l’onglet Livraisons de Slate.
Après confirmation, vous êtes prêt à commencer à diffuser votre contenu avec S3 Push Delivery.
Méthodes de transfert de fichiers
Nous vous recommandons d’utiliser l’une des méthodes de transfert de fichiers suivantes pour envoyer des fichiers depuis votre compte S3.
S3 Copy (interface de ligne de commande AWS, kits SDK, API REST, console)
Pour plus d’informations sur la façon de copier des objets à l’aide de l’interface de ligne de commande (CLI) AWS, des kits SDK, de l’API REST ou de la console S3, consultez Pour copier un objet dans le guide de l’utilisateur d’AWS S3. Le manuel de référence des commandes de l’AWS CLI contient des informations sur la façon d’exécuter différentes commandes de copie dans l’interface de ligne de commande AWS. Pour obtenir des exemples de code et des instructions de configuration pour AWS Lambda et AWS CLI, consultez la section sur les méthodes de copie S3 ci-dessous.
AWS DataSync
AWS DataSync est un service de transfert et de découverte de données en ligne qui simplifie la migration des données et vous aide à transférer rapidement, facilement et en toute sécurité les données de vos fichiers ou objets vers, depuis et entre les services de stockage AWS. Pour savoir comment utiliser AWS DataSync, consultez ce didacticiel.
Le schéma suivant illustre un scénario dans lequel vous transférez des données d’un compartiment S3 vers un autre compartiment S3 situé dans un autre compte AWS, mais au sein de la même région AWS.
Le schéma suivant illustre un scénario dans lequel vous transférez des données d’un compartiment S3 vers un autre compartiment S3 situé dans un compte et une région AWS différents.
Méthodes de copie S3
Cette section fournit deux exemples de méthodes de copie que vous pouvez utiliser avec l’interface de ligne de commande AWS.
Copier des objets avec AWS Lambda
- Créer une fonction Lambda Python dans AWS. (Cet exemple a été créé dans Python 3.12.)
- Utilisez le rôle IAM que vous avez créé et mis à jour avec les informations de point d’accès de votre POM.
- Utilisez l’exemple de code suivant pour copier un fichier de la source vers le compartiment S3 de destination.
import boto3 def lambda_handler(event, context): # Define your S3 bucket name and file key source_bucket_name = 'source_bucket' source_file_key = 'source_prefix/sample_source_file.txt' copy_source = {'Bucket': source_bucket_name, 'Key': source_file_key} # Create an S3 client s3 = boto3.client('s3') # Define your destination S3 access point ARN and file key destination_bucket_name = 'destination_bucket_alias ' destination_file_key = 'prime_video_provided_prefix/sample_destination_file.txt' try: # Copy the object from the source S3 bucket to the destination S3 access point s3.copy_object( CopySource=copy_source, Bucket=destination_bucket_name, Key=destination_file_key ) return { 'statusCode': 200, 'body': 'File copied successfully to destination S3.' } except Exception as e: # Print any errors that occur print(f"Error: {e}") return { 'statusCode': 500, 'body': str(e) } - Validez la livraison en vérifiant l’onglet Livraisons de Slate pour le fichier copié.
Copier des objets avec l’AWS CLI
- Assurez-vous que le rôle IAM que vous avez créé possède l’instruction 2 avec AccountID ajoutée à AWS.
- Assumez le rôle IAM que vous avez créé à l’aide de la commande suivante.
[cloudshell-user@ip-192-168-1-1 ~]$ aws sts assume-role --role-arn "arn:aws:iam::XXXXXXXXXXX:role/PrimeVideoDeliveryIAMRole" --role-session-name AWSCLI-Session { "Credentials": { "AccessKeyId": "XXXXXXXX", "SecretAccessKey": "XXXXXXXX", "SessionToken": "XXXXXXXX", "Expiration": "2024-09-03T23:37:43+00:00" }, "AssumedRoleUser": { "AssumedRoleId": "XXXXXXXX:AWSCLI-Session", "Arn": "arn:aws:sts::XXXXXXXXXXX:assumed-role/PrimeVideoDeliveryIAMRole/AWSCLI-Session" } } - Copiez les informations d’identification et définissez-les comme variables d’environnement.
export AWS_ACCESS_KEY_ID=AccessKeyId_From_Above_Response export AWS_SECRET_ACCESS_KEY=SecretAccessKey_From_Above_Response export AWS_SESSION_TOKEN=SessionToken_From_Above_Response - Vérifiez si le rôle est assumé par le shell en exécutant le code suivant.
[cloudshell-user@ip-192-168-1-1 ~]$ aws sts get-caller-identity { "UserId": "XXXXXXXX:AWSCLI-Session", "Account": "XXXXXXXXXXX", "Arn": "arn:aws:sts::XXXXXXXXXXX:assumed-role/PrimeVideoDeliveryIAMRole/AWSCLI-Session" } [cloudshell-user@ip-192-168-1-1 ~]$ - Copiez le fichier vers la destination à l’aide de la commande suivante.
[cloudshell-user@ip-192-168-1-1 ~]$ aws s3api copy-object --copy-source source_bucket/source_prefix/sample_source_file.txt --key prime_video_provided_prefix/sample_destination_file.txt --bucket destination_bucket_alias { "CopySourceVersionId": "5IsrJMy42TJEa7wXSValghbqQZjfAdnW", "VersionId": "A6sYhr9q4iDJy7VtWv9iscJdRWF4xE8S", "ServerSideEncryption": "AES256", "CopyObjectResult": { "ETag": "\"ae2b1fca515949e5d54fb22b8ed95575\"", "LastModified": "2024-09-03T22:40:01+00:00" } } - Validez la livraison en vérifiant l’onglet Livraisons de Slate pour le fichier copié.
