Flow Service API を使用した Amazon S3 のExperience Platformへの接続

最終更新日： 2025年4月4日
  • トピック：

作成対象：

  • 開発者

Flow Service API を使用して Amazon S3 ソースアカウントをAdobe Experience Platformに接続する方法については、このガイドを参照してください。

はじめに

このガイドは、Adobe Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

  • ソース:Experience Platformを使用すると、データを様々なソースから取得しながら、Experience Platform サービスを使用して受信データの構造化、ラベル付け、拡張を行うことができます。
  • サンドボックス:Experience Platformには、単一の Experience Platform インスタンスを別々の仮想環境に分割し、デジタルエクスペリエンスアプリケーションの開発と発展に役立つ仮想サンドボックスが用意されています。

Experience Platform API の使用

Experience Platform API を正常に呼び出す方法について詳しくは、Experience Platform API の概要を参照してください。

Amazon S3 を Azure 上のExperience Platformに接続

Amazon S3 ソースを Azure 上のExperience Platformに接続する方法については、以下の手順を参照してください。

必要な資格情報の収集

Flow Service を Amazon S3 ストレージに接続するには、次の接続プロパティの値を指定する必要があります。

資格情報説明
s3AccessKeyAmazon S3 バケットのアクセスキー ID。
s3SecretKeyAmazon S3 バケットの秘密鍵 ID。
serviceUrl（任意）接続先のカスタム Amazon S3 エンドポイント。 Amazon S3 バケットが地域に固有の場合、このフィールドは必須です。 serviceUrl の形式は https://s3.{REGION}.amazonaws.com/) です。
bucketNameAmazon S3 バケットには、データと、それに対応する説明メタデータが含まれています。 Amazon S3 バケット名は、3 ～ 63 文字の長さで、先頭と末尾は文字または数字にする必要があります。 バケット名には小文字、数字、ハイフン （-）のみを使用でき、IP アドレスとしてフォーマットすることはできません。
folderPathデータが格納されている Amazon S3 バケット内のフォルダーへのパス。 この資格情報は、ユーザーがアクセスを制限している場合に必要です。
s3SessionToken（オプション）信頼できない環境のユーザーに Amazon S3 リソースへの一時的なアクセスを提供できる、短期間の一時的なトークン。 詳しくは、Amazon S3 概要を参照してください。
connectionSpec.id接続仕様は、ベース接続とソース接続の作成に関連する認証仕様などの、ソースのコネクタプロパティを返します。Amazon S3 の接続仕様 ID は ecadc60c-7455-4d87-84dc-2a0e293d997b です。

基本について詳しくは、 このドキュメント Amazon Web Services を参照してくだい。

Azure 上のExperience Platformに Amazon S3 のベース接続を作成する

ベース接続は、ソースとExperience Platform間の情報（ソースの認証資格情報、現在の接続状況、一意のベース接続 ID など）を保持します。 ベース接続 ID により、ソース内からファイルを参照および移動し、データタイプやフォーマットに関する情報を含む、取り込みたい特定の項目を識別することができます。

ベース接続 ID を作成するには、/connections エンドポイントに POST リクエストを実行し、S3 認証資格情報をリクエストパラメーターの一部として使用します。

API 形式

POST /connections

リクエスト

次のリクエストは、Amazon S3 のベース接続を作成します。

選択するとリクエストの例が表示されます
curl -X POST \
    'https://platform.adobe.io/data/foundation/flowservice/connections' \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {ORG_ID}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}' \
    -H 'Content-Type: application/json' \
    -d '{
        "name": "Amazon S3 base connection",
        "description": "Amazon S3 base connection with temporary session token",
        "auth": {
            "specName": "Access Key",
            "params": {
                "s3AccessKey": "{S3_ACCESS_KEY}",
                "s3SecretKey": "{S3_SECRET_KEY}",
                "s3SessionToken": "{S3_SESSION_TOKEN}
            }
        },
        "connectionSpec": {
            "id": "ecadc60c-7455-4d87-84dc-2a0e293d997b",
            "version": "1.0"
        }
    }'
プロパティ説明
auth.params.s3AccessKeyS3 バケットに関連付けられたアクセスキー。
auth.params.s3SecretKeyS3 バケットに関連付けられた秘密鍵。
auth.params.s3SessionToken（任意） バケットへのアクセスに使用する短期間の一時的な S3 トークン。
connectionSpec.idS3 接続仕様 ID：ecadc60c-7455-4d87-84dc-2a0e293d997b

応答

リクエストが成功した場合は、一意の ID（id）を含む、新しく作成した接続の詳細が返されます。この ID は、次のチュートリアルでストレージを調査するために必要になります。

選択すると応答の例が表示されます
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700d77b-0000-0200-0000-5e3b41a10000\""
}