の作成 Azure Blob を使用したベース接続 Flow Service API
ベース接続は、ソースと Adobe Experience Platform 間の認証済み接続を表します。
このチュートリアルでは、のベース接続を作成する手順を説明します。 Azure Blob (以下「」という。)Blob」) を Flow Service API.
はじめに
このガイドでは、Adobe Experience Platform の次のコンポーネントに関する十分な知識が必要です。
以下の節では、 Blob を使用したソース接続 Flow Service API.
必要な資格情報の収集
次の条件を満たすため Flow Service を Blob ストレージの場合は、次の接続プロパティの値を指定する必要があります。
table 0-row-2 1-row-2 2-row-2 | |
---|---|
資格情報 | 説明 |
connectionString |
認証に必要な認証情報を含む文字列 Blob をExperience Platformに追加します。 The Blob 接続文字列のパターンは次のとおりです。 DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY} . 接続文字列について詳しくは、 Blob ~に関する文書 接続文字列の設定. |
connectionSpec.id |
接続仕様は、ベース接続とソース接続の作成に関連する認証仕様などの、ソースのコネクタプロパティを返します。Blob の接続仕様 ID は d771e9c1-4f26-40dc-8617-ce58c4b53702 です。 |
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
---|---|
資格情報 | 説明 |
sasUri |
代替の認証タイプとして使用して、 Blob アカウント。 The Blob SAS URI パターンは次のとおりです。 https://{ACCOUNT_NAME}.blob.core.windows.net/?sv=<storage version>&st={START_TIME}&se={EXPIRE_TIME}&sr={RESOURCE}&sp={PERMISSIONS}>&sip=<{IP_RANGE}>&spr={PROTOCOL}&sig={SIGNATURE}> 詳しくは、 Blob ~に関する文書 共有アクセス署名 URI. |
container |
アクセスを指定するコンテナの名前です。 を使用して新しいアカウントを作成する場合、 Blob ソースとして指定する場合、選択したサブフォルダーへのユーザーアクセスを指定するコンテナ名を指定できます。 |
folderPath |
アクセス権を付与するフォルダーのパスです。 |
connectionSpec.id |
接続仕様は、ベース接続とソース接続の作成に関連する認証仕様などの、ソースのコネクタプロパティを返します。Blob の接続仕様 ID は d771e9c1-4f26-40dc-8617-ce58c4b53702 です。 |
Platform API の使用
Platform API への呼び出しを正常に実行する方法について詳しくは、Platform API の概要を参照してください。
ベース接続の作成
ベース接続は、ソースと Platform 間の情報(ソースの認証資格情報、現在の接続状態、固有のベース接続 ID など)を保持します。ベース接続 ID により、ソース内からファイルを参照および移動し、データタイプやフォーマットに関する情報を含む、取り込みたい特定の項目を識別することができます。
The Blob ソースは、接続文字列と共有アクセス署名 (SAS) 認証の両方をサポートしています。 共有アクセス署名 (SAS)URI を使用すると、 Blob アカウント。 SAS ベースの認証では、権限設定、開始日、有効期限日、および特定のリソースに対するプロビジョニングを設定できるので、SAS を使用して、様々なアクセス度の認証資格情報を作成できます。
この手順では、コンテナの名前とサブフォルダーのパスを定義して、アカウントがアクセスできるサブフォルダーを指定することもできます。
ベース接続 ID を作成するには、/connections
エンドポイントに POST リクエストを実行し、Blob 認証資格情報をリクエストパラメーターの一部として使用します。
API 形式
POST /connections
リクエスト
次のリクエストは、のベース接続を作成します。 Blob 接続文字列ベースの認証を使用する場合:
accordion | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
リクエスト | ||||||||||
|
accordion | ||
---|---|---|
応答 | ||
リクエストが成功した場合は、一意の ID(
|
を作成するには、以下を実行します。 Blob 共有アクセス署名 URI を使用した接続で、 Flow Service API を使用して Blob sasUri
.
accordion | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
リクエスト | ||||||||||
|
accordion | ||
---|---|---|
応答 | ||
リクエストが成功した場合は、一意の ID(
|
次の手順
このチュートリアルに従って、 Blob 応答本文の一部として、API と一意の ID を使用した接続を取得しました。 この接続 ID を フローサービス API を使用したクラウドストレージの調査.