Show Menu
主題×

使用 Azure Blob API建立連 Flow Service 接器

Flow Service 用於收集和集中Adobe Experience Platform內不同來源的客戶資料。 該服務提供用戶介面和REST風格的API,所有支援的源都可從中連接。
本教學課程使 Flow Service 用API來引導您完成連線至 Azure Blob (以下稱為「Blob」)儲存空間的步驟。
如果您希望使用中的用戶介面 Experience Platform, 在UI中 Azure Blob 建立 Amazon 或S3來源連接器 Azure Blob或Amazon S3源連接器UI教程提供了執行類似操作的逐步說明。

快速入門

本指南需要有效瞭解Adobe Experience Platform的下列元件:
  • 來源 : Experience Platform 允許從各種來源接收資料,同時提供使用服務構建、標籤和增強傳入資料的 Platform 能力。
  • 沙盒 : Experience Platform 提供虛擬沙盒,可將單一執行個體分 Platform 割為不同的虛擬環境,以協助開發和發展數位體驗應用程式。
以下各節提供您需要知道的其他資訊,以便使用 Flow Service API成功連線至Blob儲存。

收集必要的認證

要連接 Flow Service 到您的Blob儲存,必須為以下連接屬性提供值:
憑證
說明
connectionString
訪問Blob儲存中的資料所需的連接字串。 Blob連接字串模式是: DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY} .
connectionSpec.id
建立連線所需的唯一識別碼。 Blob的連接規範ID是: 4c10e202-c428-4796-9208-5f1f5732b1cf
如需有關取得連線字串的詳細資訊,請參 閱此Azure Blob檔案

讀取範例API呼叫

本教學課程提供範例API呼叫,以示範如何設定請求的格式。 這些包括路徑、必要標題和正確格式化的請求負載。 也提供API回應中傳回的範例JSON。 如需範例API呼叫檔案中所用慣例的詳細資訊,請參閱疑難排解指 南中有關如何讀取範例API呼叫的 Experience Platform 章節。

收集必要標題的值

若要呼叫API,您必 Platform 須先完成驗證教 學課程 。 完成驗證教學課程後,將提供所有 Experience Platform API呼叫中每個必要標題的值,如下所示:
  • 授權: 生產者 {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}
中的所有資 Experience Platform源(包括屬於的資源)都 Flow Service被隔離到特定的虛擬沙盒中。 對API的所 Platform 有請求都需要一個標題,該標題會指定要在中執行的操作的沙盒名稱:
  • x-sandbox-name: {SANDBOX_NAME}
所有包含裝載(POST、PUT、PATCH)的請求都需要額外的媒體類型標題:
  • 內容類型: application/json

建立連線

連接指定源,並包含該源的憑據。 每個Blob帳戶只需要一個連接,因為它可用於建立多個源連接器以導入不同的資料。
API格式
POST /connections

請求
要建立Blob連接,其唯一連接規範ID必須作為POST請求的一部分提供。 Blob的連接規範ID為 4c10e202-c428-4796-9208-5f1f5732b1cf
curl -X POST \
    'http://platform.adobe.io/data/foundation/flowservice/connections' \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {IMS_ORG}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}' \
    -H 'Content-Type: application/json' \
    -d '{
        "name": "Blob Connection",
        "description": "Cnnection for an Azure Blob account",
        "auth": {
            "specName": "ConnectionString",
            "params": {
                "connectionString": "DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}"
            }
        },
        "connectionSpec": {
            "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
            "version": "1.0"
        }
    }'

屬性
說明
auth.params.connectionString
訪問Blob儲存中的資料所需的連接字串。 Blob連接字串模式是: DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY} .
connectionSpec.id
點滴儲存連接規範ID是: 4c10e202-c428-4796-9208-5f1f5732b1cf
回應
成功的回應會傳回新建立連線的詳細資料,包括其唯一識別碼( id )。 在下一個教學課程中探索您的儲存空間時,需要此ID。
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700c57b-0000-0200-0000-5e3b3f440000\""
}

後續步驟

在本教學課程中,您已使用API建立Blob連線,並且已取得唯一ID作為回應內文的一部分。 您可以使用此連線ID來 探索使用Flow Service API的雲端儲存空間 ,或 使用Flow Service API內嵌鑲木地板資料