S3 Push Delivery ist eine Methode, mit der Studios, Fulfillment-Anbieter und andere Inhaltsanbieter Dateien an Prime Video liefern können.
Amazon Simple Storage Service (S3) ist ein Objektspeicherservice von Amazon Web Services (AWS). Mit S3 Push Delivery können Partner Dateien sicher aus ihrem eigenen Amazon S3-Bucket direkt nach Prime Video kopieren.
S3 Push Delivery bietet mehrere Vorteile, darunter:
- Niedrigere Kosten: Für Übertragungen vom S3-Bucket eines Inhaltsanbieters zu Prime Video mithilfe von S3 Push Delivery fallen reduzierte AWS-Ausgangsgebühren für Inhaltsanbieter an, deren S3-Buckets in Nordamerika und den AWS-Regionen EMEA gehostet werden.
- Schnellere Liefergeschwindigkeiten: Dateien, die über S3 Push Delivery geliefert werden, werden bis zu dreimal schneller übertragen als Dateien, die über andere Massenversandmethoden geliefert werden.
Das folgende Systemdiagramm zeigt, wie Dateien von zwei verschiedenen AWS-Partnerkonten über eine gewählte Dateiübertragungsmethode (S3 Copy oder AWS DataSync) zu einem Access Point in einem Prime Video AWS-Konto übertragen und dann in Prime Video aufgenommen werden.
Fangen Sie an
Um einen S3-Zugangspunkt zu empfangen und zu testen, an dem Sie Ihre Dateien bereitstellen können:
- Stellen Sie ein Support-Ticket „Kontakt“, um das Onboarding in S3 zu beantragen, oder wenden Sie sich an Ihren POM oder CAM, um dies in Ihrem Namen zu beantragen. Bitte geben Sie in der Anfrage die folgenden Informationen an:
- Rollen in AWS Identity and Account Management (IAM), die Zugriff benötigen.
Zum Beispiel: arn:aws:iam: :role/this-is-a-test-role - Namen der Prime Video-Lieferkonten, die in Ihrem Namen liefern.
Zum Beispiel: test_account - AWS-Region, in der Ihr S3-Bucket gehostet wird.
Ihr Amazon-Ansprechpartner wird sich dann mit Ihnen in Verbindung setzen, um Sie über die nächsten Schritte zu informieren und Ihnen den S3-Zugangspunkt als Referenz für Ihre Lieferungen mitzuteilen.
Zum Beispiel: arn:aws:s3: ::test-s3-accesspoint-agsen8dehko1eyjxo3myhtui4cgs4use1b-s3alias - Rollen in AWS Identity and Account Management (IAM), die Zugriff benötigen.
- Aktualisieren Sie Ihre IAM-Rollen mit den Richtlinien, die erforderlich sind, um Ihre Dateien über Ihren Access Point in den S3-Bucket von Prime Video zu kopieren. Das folgende Beispiel zeigt die erwarteten Berechtigungen. In diesem Code:
- Ersetzen Sie den Namen source_bucket durch Ihren eigenen S3-Bucket-Namen.
- Ersetzen Sie den Namen destination_bucket, destination_bucket_access_point_alias, prime_video_provided_prefix und access_point_name durch die von Ihrem POM bereitgestellten Informationen.
{ "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/*" ] } ] }
Nachdem Sie Ihren Access Point erhalten und Ihre IAM-Rollenberechtigungen aktualisiert haben, können Sie Dateien mit einer der im nächsten Abschnitt beschriebenen Dateiübertragungsmethoden bereitstellen.
- Stellen Sie über die von Ihnen gewählte Methode zunächst eine erste Testdatei (z. B. test.txt) bereit und stellen Sie sicher, dass die Datei auf der Registerkarte Lieferungen in Slate sichtbar ist.
Nach der Bestätigung können Sie mit der Bereitstellung Ihrer Inhalte mit S3 Push Delivery beginnen.
Methoden zur Dateiübertragung
Wir empfehlen, eine der folgenden Dateiübertragungsmethoden zu verwenden, um Dateien von Ihrem S3-Konto aus zu übertragen.
S3 Copy (AWS-Befehlszeilenschnittstelle, SDKs, REST-API, Konsole) Informationen
zum Kopieren von Objekten mithilfe der AWS-Befehlszeilenschnittstelle (CLI), SDKs, der REST-API oder der S3-Konsole finden Sie unter So kopieren Sie ein Objekt im AWS S3-Benutzerhandbuch. Die AWS CLI Command Reference enthält Einzelheiten zur Ausführung verschiedener Kopierbefehle in der AWS-CLI. Beispielcode und Anweisungen zur Einrichtung von AWS Lambda und AWS CLI finden Sie im Abschnitt S3-Kopiermethoden weiter unten.
AWS DataSync
AWS DataSync ist ein Service zur Online-Übertragung und Erkennung von Daten, der die Datenmigration vereinfacht und Ihnen hilft, Ihre Datei- oder Objektdaten schnell, einfach und sicher zu, von und zwischen AWS-Speicherservices zu übertragen. In diesem Tutorial erfahren Sie, wie Sie AWS DataSync verwenden.
Das folgende Diagramm zeigt ein Szenario, in dem Sie Daten von einem S3-Bucket in einen anderen S3-Bucket übertragen, der sich in einem anderen AWS-Konto, aber in derselben AWS-Region befindet.
Das folgende Diagramm zeigt ein Szenario, in dem Sie Daten von einem S3-Bucket in einen anderen S3-Bucket übertragen, der sich in einem anderen AWS-Konto und einer anderen Region befindet.
S3-Kopiermethoden
Dieser Abschnitt enthält zwei Beispielkopiermethoden, die Sie mit der AWS-CLI verwenden können.
Objekte mit AWS Lambda kopieren
- Erstellen Sie eine Python-Lambda-Funktion in AWS. (Dieses Beispiel wurde in Python 3.12 erstellt.)
- Verwenden Sie die IAM-Rolle, die Sie erstellt und mit den Access Point-Informationen aus Ihrem POM aktualisiert haben.
- Verwenden Sie den folgenden Beispielcode, um eine Datei vom Quell- in den Ziel-S3-Bucket zu kopieren.
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) } - Überprüfen Sie die Lieferung, indem Sie auf der Registerkarte Lieferungen in Slate nach der kopierten Datei suchen.
Kopieren Sie Objekte mit AWS CLI
- Stellen Sie sicher, dass der von Ihnen erstellten IAM-Rolle die Anweisung 2 mit der Account-ID für AWS hinzugefügt wurde.
- Gehen Sie mit dem folgenden Befehl von der IAM-Rolle aus, die Sie erstellt haben.
[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" } } - Kopieren Sie die Anmeldeinformationen und legen Sie sie als Umgebungsvariablen fest.
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 - Überprüfen Sie, ob die Rolle von der Shell übernommen wird, indem Sie den folgenden Code ausführen.
[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 ~]$ - Kopieren Sie die Datei mit dem folgenden Befehl in das Ziel.
[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" } } - Überprüfen Sie die Lieferung, indem Sie auf der Registerkarte Lieferungen in Slate nach der kopierten Datei suchen.
