Flow Service APIを使用してAzure Data Lake Storage Gen2 ベース接続を作成します

最終更新日： 2025年10月14日

トピック：
Sources

作成対象：

Developer

ベース接続は、ソースと Adobe Experience Platform 間の認証済み接続を表します。

このチュートリアルでは、Flow Service APIを使用してAzure Data Lake Storage Gen2 （以下「ADLS Gen2」と呼ぶ）のベース接続を作成する手順について説明します。

はじめに

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

ソース：Experience Platform を使用すると、データを様々なソースから取得しながら、Experience Platform サービスを使用して受信データの構造化、ラベル付け、拡張を行うことができます。
サンドボックス : Experience Platformは、1つのExperience Platform インスタンスを個別のバーチャル環境に分割して、デジタルエクスペリエンスアプリケーションの開発と進化に役立つバーチャルサンドボックスを提供します。

次の節では、Flow Service APIを使用してADLS Gen2 ソース接続を正常に作成するために知っておく必要がある追加情報を示します。

必要な資格情報の収集

Flow ServiceがADLS Gen2に接続するには、次の接続プロパティの値を指定する必要があります。

資格情報

説明

url

ADLS Gen2のエンドポイント。エンドポイントパターンは https://<accountname>.dfs.core.windows.net です。

servicePrincipalId

アプリケーションのクライアント ID。

servicePrincipalKey

アプリケーションのキー。

tenant

アプリケーションを含むテナント情報。

connectionSpec.id

接続仕様は、ベース接続とソース接続の作成に関連する認証仕様などの、ソースのコネクタプロパティを返します。 ADLS Gen2の接続仕様IDはb3ba5556-48be-44b7-8b85-ff2b69b46dc4です。

これらの値について詳しくは、このADLS Gen2 ドキュメントを参照してください。

Experience Platform APIの使用

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

ベース接続の作成

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

ベース接続IDを作成するには、リクエストパラメーターの一部としてADLS Gen2認証資格情報を提供しながら、/connections エンドポイントにPOST リクエストを行います。

API 形式

POST /connections

リクエスト

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

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": "adls-gen2",
        "description": "Connection for adls-gen2",
        "auth": {
            "specName": "Basic Authentication for adls-gen2",
            "params": {
                "url": "{URL}",
                "servicePrincipalId": "{SERVICE_PRINCIPAL_ID}",
                "servicePrincipalKey": "{SERVICE_PRINCIPAL_KEY}",
                "tenant": "{TENANT}"
            }
        },
        "connectionSpec": {
            "id": "b3ba5556-48be-44b7-8b85-ff2b69b46dc4",
            "version": "1.0"
        }
    }'

プロパティ

説明

auth.params.url

ADLS Gen2 アカウントのURL エンドポイント。

auth.params.servicePrincipalId

ADLS Gen2 アカウントのサービスプリンシパル ID。

auth.params.servicePrincipalKey

ADLS Gen2 アカウントのサービスプリンシパルキー。

auth.params.tenant

ADLS Gen2 アカウントのテナント情報。

connectionSpec.id

ADLS Gen2接続仕様ID: b3ba5556-48be-44b7-8b85-ff2b69b46dc41。

応答

リクエストが成功した場合は、一意の ID（id）を含め、新しく作成されたベース接続の詳細が返されます。この ID は、次の手順でソース接続を作成する際に必要になります。

{
    "id": "7497ad71-6d32-4973-97ad-716d32797304",
    "etag": "\"23005f80-0000-0200-0000-5e1d00a20000\""
}

次の手順

このチュートリアルでは、APIを使用してADLS Gen2接続を作成し、応答本文の一部として一意のIDを取得しました。この接続IDを使用して、Flow Service API🔗を使用してクラウドストレージを探索できます。

recommendation-more-help

experience-platform-help-sources