S3 プッシュ納品は、スタジオ、フルフィルメントベンダー、その他のコンテンツプロバイダーが Prime Video にファイルを納品するために使用できる方法です。
Amazon Simple Storage Service (S3) は、アマゾンウェブサービス (AWS) が提供するオブジェクトストレージサービスです。 S3 プッシュ納品により、パートナーは自社の Amazon S3 バケットからプライムビデオに直接安全にファイルをコピーできます。
S3 プッシュ納品には以下のようないくつかの利点があります。
- 低コスト:S3 プッシュ納品を使用してコンテンツプロバイダーの S3 バケットから Prime Video に転送すると、S3 バケットが北米と EMEA の AWS リージョンでホストされているコンテンツプロバイダーの AWS エグレス料金が削減されます。
- より速い納品速度:S3 プッシュ納品で納品されたファイルは、他の一括納品方法で納品されるファイルよりも最大 3 倍速く転送されます。
次のシステム図は、2 つの異なるパートナー AWS アカウントからのファイルが、選択したファイル転送方法 (S3 Copy または AWS DataSync) を介してプライムビデオ AWS アカウントのアクセスポイントに移動し、プライムビデオに取り込まれる様子を示しています。
始めましょう
ファイルを納品できる S3 アクセスポイントを受信してテストするには:
- お問い合わせサポートチケットを作成して S3 へのオンボーディングをリクエストするか、POM または CAM に連絡してお客様に代わってリクエストしてください。 リクエストには以下の情報を入力してください。
- アクセスが必要な AWS ID およびアカウント管理 (IAM) ロール。
例:arn: aws: iam:: role/this-is-a-test-role - お客様に代わって納品するプライム・ビデオ納品アカウントの名前。
例:test_account - S3 バケットがホストされている AWS リージョン。
その後、お客様の Amazon 担当者がお客様に連絡し、次のステップについてお知らせします。また、納品の参照用に S3 アクセスポイントを共有します。
例:arn: aws: s3:: test-s3-accesspoint-agsen8dehko1eyjxo3myhtui4cgs4use1b-s3alias - アクセスが必要な AWS ID およびアカウント管理 (IAM) ロール。
- アクセスポイント経由でプライム・ビデオの S3 バケットにファイルをコピーするのに必要なポリシーで IAM ロールを更新してください。 次の例は、想定される権限を示しています。 このコードでは:
- source_bucket の名前を独自の S3 バケット名に置き換えてください。
- 宛先_バケット名、宛先_bucket_access_point_alias 、prime_video_provided_prefix、access_point_nameを、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/*" ] } ] }
アクセスポイントを受け取り、IAM ロールの権限を更新したら、次のセクションで説明するファイル転送方法のいずれかを使用してファイルを納品できます。
- 選択した方法で、最初に初期テストファイル (test.txt など) を納品し、そのファイルが Slate の「納品」タブに表示されていることを確認します。
確認後、S3 プッシュ納品によるコンテンツの納品を開始する準備が整いました。
ファイル転送方法
S3 アカウントからファイルを納品するには、以下のファイル転送方法のいずれかを使用することをお勧めします。
S3 Copy (AWS コマンドラインインターフェイス、SDK、REST API、コンソール) AWS コマンドラインインターフェイス (CLI)、SDK、REST API、または S3
コンソールを使用してオブジェクトをコピーする方法については、『AWS S3 ユーザーガイド』の「オブジェクトをコピーするには」を参照してください。 AWS CLI でさまざまな copy コマンドを実行する方法の詳細については、AWS CLI コマンドリファレンスに記載されています。 AWS Lambda と AWS CLI のサンプルコードとセットアップ手順については、以下の S3 コピー方法のセクションを参照してください。
AWS DataSync
AWS DataSync は、データ移行を簡素化し、ファイルまたはオブジェクトデータを AWS ストレージサービスとの間で、すばやく、簡単かつ安全に転送できるようにするオンラインデータ移動および検出サービスです。 AWS DataSync の使用方法については、このチュートリアルを参照してください。
次の図は、S3 バケットから、別の AWS アカウントにあるが同じ AWS リージョン内にある別の S3 バケットにデータを転送するシナリオを示しています。
次の図は、S3 バケットから別の AWS アカウントとリージョンにある別の S3 バケットにデータを転送するシナリオを示しています。
S3 コピー方法
このセクションでは、AWS CLI で使用できる 2 つのサンプルコピー方法を紹介します。
AWS Lambda を使用してオブジェクトをコピーする
- AWS で Python ラムダ関数作成。 (この例は Python 3.12 で作成されたものです)。
- POM のアクセスポイント情報を使用して作成および更新した IAM ロールを使用してください。
- 次のサンプルコードを使用して、ソースから宛先の S3 バケットにファイルをコピーします。
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) } - Slate の [納品] タブでコピーしたファイルを確認して、納品を確認します。
AWS CLI を使用してオブジェクトをコピーする
- 作成した IAM ロールに、AWS に対してアカウント ID が追加されたステートメント 2 があることを確認します。
- 次のコマンドを使用して、作成した IAM ロールを引き受けます。
[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" } } - 認証情報をコピーし、環境変数として設定します。
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 - 次のコードを実行して、ロールがシェルによって引き継がれているかどうかを確認します。
[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 ~]$ - 次のコマンドを使用して、ファイルを宛先にコピーします。
[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" } } - Slate の [納品] タブでコピーしたファイルを確認して、納品を確認します。
