使用Flow Service API建立Azure Blob基本連線
基礎連線代表來源和Adobe Experience Platform之間的已驗證連線。
本教學課程提供使用Flow Service API為Azure Blob (以下稱為「Blob」)建立基礎連線的步驟。
快速入門
本指南需要您深入了解下列 Adobe Experience Platform 元件:
下列章節提供您需瞭解的其他資訊,才能使用Flow Service API成功建立Blob來源連線。
收集必要的認證
為了讓Flow Service與您的Blob儲存裝置連線,您必須提供下列連線屬性的值:
table 0-row-2 1-row-2 2-row-2 | |
---|---|
認證 | 說明 |
connectionString |
包含驗證Blob以Experience Platform所需的授權資訊的字串。 Blob連線字串模式為: DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY} 。 如需有關連線字串的詳細資訊,請參閱設定連線字串上的此Blob檔案。 |
connectionSpec.id |
連線規格會傳回來源的聯結器屬性,包括與建立基礎連線和來源連線相關的驗證規格。 Blob的連線規格識別碼為: d771e9c1-4f26-40dc-8617-ce58c4b53702 。 |
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
---|---|
認證 | 說明 |
sasUri |
共用存取簽章URI,可做為連線您的Blob帳戶的替代驗證型別。 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}> 如需詳細資訊,請參閱共用存取簽章URI上的此Blob檔案。 |
container |
您要指定存取權的容器名稱。 使用Blob來源建立新帳戶時,您可以提供容器名稱,以指定使用者對您所選子資料夾的存取權。 |
folderPath |
您要提供存取權的資料夾路徑。 |
connectionSpec.id |
連線規格會傳回來源的聯結器屬性,包括與建立基礎連線和來源連線相關的驗證規格。 Blob的連線規格識別碼為: d771e9c1-4f26-40dc-8617-ce58c4b53702 。 |
使用平台API
如需如何成功呼叫Platform API的詳細資訊,請參閱Platform API快速入門的指南。
建立基礎連線
基礎連線會保留您的來源和平台之間的資訊,包括來源的驗證認證、連線的目前狀態,以及您唯一的基本連線ID。 基礎連線ID可讓您從來源內部探索及導覽檔案,並識別您要擷取的特定專案,包括其資料型別和格式的資訊。
Blob來源同時支援連線字串和共用存取簽章(SAS)驗證。 共用存取簽章(SAS) URI允許將安全授權委派給您的Blob帳戶。 您可以使用SAS建立具有不同存取許可權的驗證認證,因為以SAS為基礎的驗證可讓您設定許可權、開始和到期日期,以及配置給特定資源。
在此步驟中,您還可以透過定義容器名稱和子資料夾的路徑,指定您的帳戶將可以存取的子資料夾。
若要建立基底連線ID,請在提供Blob驗證認證作為要求引數的一部分時,向/connections
端點提出POST要求。
API格式
POST /connections
要求
下列要求會使用連線字串式驗證來建立Blob的基礎連線:
accordion | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
要求 | ||||||||||
|
accordion | ||
---|---|---|
回應 | ||
成功的回應會傳回新建立的基礎連線的詳細資料,包括其唯一識別碼(
|
若要使用共用存取簽章URI來建立Blob連線,請在提供您的Blob sasUri
的值時向Flow Service API提出POST要求。
accordion | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
要求 | ||||||||||
|
accordion | ||
---|---|---|
回應 | ||
成功的回應會傳回新建立的基礎連線的詳細資料,包括其唯一識別碼(
|
後續步驟
依照本教學課程,您已使用API建立Blob連線,且已取得唯一ID作為回應本文的一部分。 您可以使用此連線ID來使用Flow Service API🔗 探索雲端儲存空間。