La entrega push de S3 es un método que los estudios, los proveedores de logística y otros proveedores de contenido pueden utilizar para entregar archivos a Prime Video.
Amazon Simple Storage Service (S3) es un servicio de almacenamiento de objetos de Amazon Web Services (AWS). S3 Push Delivery permite a los socios copiar archivos de forma segura desde su propio depósito de Amazon S3 directamente a Prime Video.
S3 Push Delivery ofrece varios beneficios, entre los que se incluyen:
- Menor costo: las transferencias desde un segmento de S3 de un proveedor de contenido a Prime Video mediante S3 Push Delivery implicarán una reducción en las tarifas de salida de AWS para los proveedores de contenido cuyos paquetes de S3 estén alojados en las regiones de AWS de Norteamérica y EMEA.
- Velocidades de entrega más rápidas: los archivos enviados mediante S3 Push Delivery se transfieren hasta 3 veces más rápido que los que se envían mediante otros métodos de entrega masiva.
El siguiente diagrama del sistema ilustra cómo los archivos de dos cuentas de AWS asociadas diferentes se mueven a través del método de transferencia de archivos elegido (S3 Copy o AWS DataSync) hasta un punto de acceso de una cuenta de Amazon Prime Video y, a continuación, se incorporan a Prime Video.
Empezar
Para recibir y probar un punto de acceso S3 donde pueda entregar sus archivos:
- Cree un ticket de soporte de contacto para solicitar la incorporación a S3, o póngase en contacto con su POM o CAM para tramitarlo en su nombre. Proporcione la siguiente información en la solicitud:
- Funciones de administración de identidades y cuentas (IAM) de AWS a las que es necesario acceder.
Por ejemplo: arn:aws:iam: ::role/this-is-a-test-role - Nombres de las cuentas de Prime Video Delivery que realizarán entregas en tu nombre.
Por ejemplo: test_account - Región de AWS en la que está alojado su bucket de S3.
A continuación, su contacto de Amazon se pondrá en contacto con usted para informarle sobre los próximos pasos y compartir el punto de acceso S3 como referencia para sus entregas.
Por ejemplo: arn:aws:s3: ::test-s3-accesspoint-agsen8dehko1eyjxo3myhtui4cgs4use1b-s3alias - Funciones de administración de identidades y cuentas (IAM) de AWS a las que es necesario acceder.
- Actualiza tus funciones de IAM con las políticas necesarias para copiar tus archivos al bucket S3 de Prime Video a través de tu punto de acceso. En el siguiente ejemplo, se muestran los permisos esperados. En este código:
- Sustituya el nombre source_bucket por el nombre de su propio bucket de S3.
- Sustituya el nombre destination_bucket, destination_bucket_access_point_alias, prime_video_provided_prefix y access_point_name por la información proporcionada por su 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/*" ] } ] }
Una vez que haya recibido su punto de acceso y actualizado sus permisos de rol de IAM, puede entregar archivos mediante uno de los métodos de transferencia de archivos que se describen en la siguiente sección.
- Mediante el método que elijas, envía primero un archivo de prueba inicial (como test.txt) y confirma que el archivo esté visible en la pestaña Entregas de Slate.
Tras la confirmación, estarás listo para empezar a entregar tu contenido con S3 Push Delivery.
Métodos de transferencia de archivos
Le recomendamos que utilice uno de los siguientes métodos de transferencia de archivos para entregar archivos desde su cuenta de S3.
S3 Copy (interfaz de línea de comandos de AWS, SDK, API REST, consola)
Para obtener información sobre cómo copiar objetos mediante la interfaz de línea de comandos (CLI) de AWS, los SDK, la API REST o la consola S3, consulte Para copiar un objeto en la Guía del usuario de AWS S3. La referencia de comandos de la CLI de AWS contiene detalles sobre cómo ejecutar varios comandos de copia en la CLI de AWS. Para ver un ejemplo de código e instrucciones de configuración para AWS Lambda y la CLI de AWS, consulte la sección sobre métodos de copia de S3 que aparece a continuación.
AWS DataSync
AWS DataSync es un servicio de movimiento y descubrimiento de datos en línea que simplifica la migración de datos y le ayuda a transferir de forma rápida, fácil y segura los datos de sus archivos u objetos hacia, desde y entre los servicios de almacenamiento de AWS. Para aprender a usar AWS DataSync, consulte este tutorial.
El siguiente diagrama ilustra un escenario en el que se transfieren datos de un bucket de S3 a otro bucket de S3 que se encuentra en una cuenta de AWS diferente, pero dentro de la misma región de AWS.
El siguiente diagrama ilustra un escenario en el que se transfieren datos de un bucket de S3 a otro bucket de S3 que se encuentra en una cuenta y región de AWS diferentes.
Métodos de copia S3
En esta sección se proporcionan dos ejemplos de métodos de copia que puede utilizar con la CLI de AWS.
Copie objetos con AWS Lambda
- Crear una función lambda de Python en AWS. (Este ejemplo se creó en Python 3.12).
- Utilice el rol de IAM que creó y actualizó con la información del punto de acceso de su POM.
- Utilice el siguiente código de ejemplo para copiar un archivo del depósito S3 de origen al depósito de S3 de destino.
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) } - Valide la entrega consultando la pestaña Entregas de Slate para ver el archivo copiado.
Copie objetos con la CLI de AWS
- Asegúrese de que el rol de IAM que creó tenga la declaración2 con el ID de cuenta agregado en AWS.
- Asuma el rol de IAM que creó mediante el siguiente 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" } } - Copie las credenciales y configúrelas como variables de entorno.
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 - Valide si el shell asume la función ejecutando el siguiente código.
[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 ~]$ - Copie el archivo en el destino mediante el siguiente comando.
[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" } } - Valide la entrega consultando la pestaña Entregas de Slate para ver el archivo copiado.
