S3 Push Delivery è un metodo che studi, fornitori di servizi logistici e altri fornitori di contenuti possono utilizzare per inviare file a Prime Video.
Amazon Simple Storage Service (S3) è un servizio di storage di oggetti di Amazon Web Services (AWS). S3 Push Delivery consente ai partner di copiare in modo sicuro i file dal proprio bucket Amazon S3 direttamente su Prime Video.
S3 Push Delivery offre diversi vantaggi, tra cui:
- Costo inferiore: i trasferimenti dal bucket S3 di un provider di contenuti a Prime Video tramite S3 Push Delivery comporteranno tariffe di uscita AWS ridotte per i provider di contenuti i cui bucket S3 sono ospitati nelle regioni AWS del Nord America e EMEA.
- Velocità di consegna più elevate: i file consegnati tramite S3 Push Delivery vengono trasferiti fino a 3 volte più velocemente rispetto a quelli distribuiti tramite altri metodi di distribuzione in blocco.
Il seguente diagramma di sistema illustra come i file di due diversi account AWS partner passano attraverso un metodo di trasferimento file scelto (S3 Copy o AWS DataSync) verso un punto di accesso in un account AWS Prime Video e vengono quindi inseriti in Prime Video.
Inizia
Per ricevere e testare un punto di accesso S3 in cui distribuire i file:
- Invia un ticket di assistenza Contattaci per richiedere l’onboarding su S3 oppure contatta il tuo POM o CAM per segnalarlo per tuo conto. Fornisci le seguenti informazioni nella richiesta:
- Ruoli AWS Identity and Account Management (IAM) che richiedono l’accesso.
Ad esempio: arn:aws:iam: ::role/this-is-a-test-role - Nomi degli account Prime Video Delivery che effettueranno le consegne per tuo conto.
Ad esempio: test_account - Regione AWS in cui è ospitato il tuo bucket S3.
Il tuo contatto Amazon ti contatterà quindi per informarti sui passaggi successivi e condividere il punto di accesso S3 come riferimento per le tue consegne.
Ad esempio: arn:aws:s3: :test-s3-accesspoint-agsen8dehko1eyjxo3myhtui4cgs4use1b-s3alias - Ruoli AWS Identity and Account Management (IAM) che richiedono l’accesso.
- Aggiorna i tuoi ruoli IAM con le politiche necessarie per copiare i tuoi file nel bucket S3 di Prime Video tramite il tuo punto di accesso. L’esempio seguente mostra le autorizzazioni previste. In questo codice:
- Sostituisci il nome source_bucket con il tuo nome di bucket S3.
- Sostituisci il nome destination_bucket, destination_bucket_access_point_alias, prime_video_provided_prefix e access_point_name con le informazioni fornite dal tuo 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/*" ] } ] }
Dopo aver ricevuto il punto di accesso e aggiornato le autorizzazioni del ruolo IAM, puoi consegnare i file utilizzando uno dei metodi di trasferimento dei file descritti nella sezione successiva.
- Utilizzando il metodo scelto, invia innanzitutto un file di test iniziale (come test.txt) e conferma che il file sia visibile nella scheda Consegne di Slate.
Dopo la conferma, sei pronto per iniziare a distribuire i tuoi contenuti con S3 Push Delivery.
Metodi di trasferimento dei file
Ti consigliamo di utilizzare uno dei seguenti metodi di trasferimento file per inviare file dal tuo account S3.
S3 Copy (interfaccia a riga di comando AWS, SDK, API REST, console)
Per informazioni su come copiare oggetti utilizzando l’interfaccia a riga di comando (CLI) di AWS, gli SDK, l’API REST o la console S3, consulta To copy an object nella AWS S3 User Guide. L’AWS CLI Command Reference contiene dettagli su come eseguire vari comandi di copia nell’interfaccia a riga di comando di AWS. Per esempi di codice e istruzioni di configurazione per AWS Lambda e AWS CLI, consulta la sezione sui metodi di copia S3 di seguito.AWS DataSync
AWS DataSync è un servizio online di spostamento e scoperta dei dati che semplifica la migrazione dei dati e ti aiuta a trasferire in modo rapido, semplice e sicuro i dati di file o oggetti da, e tra i servizi di storage AWS. Per imparare a usare AWS DataSync, consulta questo tutorial.
Il diagramma seguente illustra uno scenario in cui si trasferiscono dati da un bucket S3 a un altro bucket S3 che si trova in un account AWS diverso, ma all’interno della stessa regione AWS.
Il diagramma seguente illustra uno scenario in cui si trasferiscono dati da un bucket S3 a un altro bucket S3 che si trova in un account e in una regione AWS diversi.
Metodi di copia S3
Questa sezione fornisce due metodi di copia di esempio che puoi utilizzare con l’interfaccia a riga di comando di AWS.
Copia oggetti con AWS Lambda
- Crea una funzione lambda Python in AWS. (Questo esempio è stato creato in Python 3.12.)
- Usa il ruolo IAM che hai creato e aggiornato con le informazioni sui punti di accesso del tuo POM.
- Utilizza il seguente codice di esempio per copiare un file dal bucket S3 di origine a quello di destinazione.
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) } - Convalida la consegna selezionando la scheda Consegne in Slate per il file copiato.
Copia oggetti con l’interfaccia a riga di comando di AWS
- Assicurati che il ruolo IAM che hai creato contenga lo statement2 con accountID aggiunto ad AWS.
- Assumi il ruolo IAM che hai creato, usando il seguente comando.
[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" } } - Copia le credenziali e impostale come variabili di ambiente.
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 - Verifica se il ruolo è assunto dalla shell eseguendo il codice seguente.
[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 ~]$ - Copiare il file nella destinazione utilizzando il comando seguente.
[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" } } - Convalida la consegna selezionando la scheda Consegne in Slate per il file copiato.
