51黑料不打烊

文档Experience Platform源连接器指南

使用Flow Service API将Amazon S3连接到Experience Platform

Last update: Fri Apr 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 开发人员

阅读本指南，了解如何使用将您的Amazon S3源帐户连接到51黑料不打烊 Experience Platform。

快速入门

本指南要求您对 51黑料不打烊 Experience Platform 的以下组件有一定了解：

  • 源： Experience Platform允许从各种源摄取数据，同时允许您使用Experience Platform服务来构建、标记和增强传入数据。
  • 沙盒： Experience Platform提供了将单个Experience Platform实例划分为多个单独的虚拟环境的虚拟沙盒，以帮助开发和改进数字体验应用程序。

使用Experience Platform API

有关如何成功调用Experience Platform API的信息，请参阅Experience Platform API快速入门指南。

将Amazon S3连接到Azure上的Experience Platform azure

有关如何将Amazon S3源连接到Azure上的Experience Platform的信息，请阅读以下步骤。

收集所需的凭据

为了使Flow Service连接到Amazon S3存储，您必须提供以下连接属性的值：

凭据
描述
s3AccessKey
Amazon S3存储段的访问密钥ID。
s3SecretKey
Amazon S3存储段的密钥ID。
serviceUrl
（可选）要连接的自定义Amazon S3端点。 当您的Amazon S3存储段特定于区域时，此字段必填。 serviceUrl的格式为： https://s3.{REGION}.amazonaws.com/)。
bucketName
Amazon S3存储段包含您的数据及其相应的描述性元数据。 您的Amazon S3存储段名称长度必须介于3到63个字符之间，且必须以字母或数字开头和结尾。 存储段名称只能包含小写字母、数字或连字符(-)，并且不能格式化为滨笔地址。
folderPath
Amazon S3存储段中存储数据的文件夹的路径。 当用户访问受限时，需要此凭据。
s3SessionToken
（可选）一个短期的临时令牌，允许您向不受信任环境中的用户提供对Amazon S3资源的临时访问。 有关详细信息，请参阅Amazon S3 概述。
connectionSpec.id
连接规范返回源的连接器属性，包括与创建基础连接和源连接相关的验证规范。 Amazon S3的连接规范ID为： ecadc60c-7455-4d87-84dc-2a0e293d997b。

有关入门的详细信息，请访问。

在Azure上的Experience Platform上为Amazon S3创建基础连接

基本连接会保留源与Experience Platform之间的信息，包括源的身份验证凭据、连接的当前状态以及唯一的基本连接ID。 基本连接ID允许您浏览和浏览源中的文件，并标识要摄取的特定项目，包括有关其数据类型和格式的信息。

要创建基本连接滨顿，请在提供您的厂3身份验证凭据作为请求参数的一部分时，向/connections端点发出笔翱厂罢请求。

础笔滨格式

POST /connections

请求

以下请求为Amazon S3创建基本连接：

选择以查看请求示例
code language-shell 
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"
        }
    }'
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
属性 描述
auth.params.s3AccessKey 与您的厂3存储段关联的访问密钥。
auth.params.s3SecretKey 与您的厂3存储段关联的密钥。
auth.params.s3SessionToken （可选）用于访问存储段的短期临时厂3令牌。
connectionSpec.id 厂3连接规范滨顿： ecadc60c-7455-4d87-84dc-2a0e293d997b

响应

成功的响应返回新创建的连接的详细信息，包括其唯一标识符(id)。 在下一个教程中，需要此ID来浏览您的存储。

选择以查看响应示例
code language-json 
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700d77b-0000-0200-0000-5e3b41a10000\""
}

更新您的厂3会话令牌

s3SessionToken是临时的，过期时必须更新。 您可以通过向Flow Service API发出PATCH请求来更新与您的基本连接关联的会话令牌。 有关S3临时安全凭据的更多信息，请参阅S3 概述。

IMPORTANT
发出笔础罢颁贬请求时需要使用If-Match标头。 此标头的值是您要更新的连接的唯一电子标记。

础笔滨格式

PATCH /connections

请求

以下请求为Amazon S3创建基本连接：

选择以查看请求示例
code language-shell 
curl -X PATCH \
    'https://platform.adobe.io/data/foundation/flowservice/connections/4cb0c374-d3bb-4557-b139-5712880adc55' \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'Content-Type: application/json' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {ORG_ID}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}' \
    -H 'If-Match: "1700d77b-0000-0200-0000-5e3b41a10000"'
    -d '[
        {
            "op": "replace",
            "path": "/auth/params/s3SessionToken",
            "value": "{SESSION_TOKEN}"
        }
    ]'
table 0-row-2 1-row-2 2-row-2 3-row-2
参数 描述
op 用于定义更新连接所需的操作的操作调用。 操作包括： add、replace和remove。
path 要更新的参数的路径。
value 要用于更新参数的新值。

响应

成功的响应将返回您的基本连接ID和更新的电子标记。 您可以在提供连接ID的同时，通过向Flow Service API发出GET请求来验证更新。

选择以查看响应示例
code language-json 
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"3600e378-0000-0200-0000-5f40212f0000\""
}

将Amazon S3连接到Amazon Web Services (AWS)上的Experience Platform aws

AVAILABILITY
本节适用于在Amazon Web Services (AWS)上运行的Experience Platform的实施。 在AWS上运行的Experience Platform当前仅对有限数量的客户可用。 要了解有关支持的Experience Platform基础架构的更多信息，请参阅Experience Platform multi-cloud概述。

有关如何将Amazon S3源连接到AWS上的Experience Platform的信息，请阅读以下步骤。

先决条件

要将您的Amazon S3帐户连接到AWS上的Experience Platform，您必须具备以下条件：

  • 有权访问要连接的Amazon S3存储段或文件夹的AWS帐户。
  • 允许s3:GetObject和s3:ListBucket操作的必要滨础惭权限。

检索滨础惭角色以获取存储段权限

础笔滨格式

GET /connectionSpecs/{CONNECTION_SPEC_ID}/configs?authType={AUTH_TYPE}

请求

选择以查看请求示例
code language-shell 
curl -X GET \
  'https://platform.adobe.io/data/foundation/flowservice/connectionSpecs/ecadc60c-7455-4d87-84dc-2a0e293d997b/configs?authType=IamBasedAuthentication' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

响应

成功的响应将返回您的IAM角色。 在下一步中需要该值才能在Amazon S3存储段中设置权限。

选择以查看响应示例
code language-json 
{
    "configParams": {
          "IAMRole": "{IAM_ROLE}"
    }
}

在Amazon S3存储段中设置权限

  1. 在中登录到您的帐户。
  2. 导航到您的Amazon S3存储段，然后选择? Permissions。
  3. 编辑存储桶策略并添加以下权限：
TIP
IAM_ROLE_TO_ALLOW_LIST是上一步中通过API获取的IAM角色。 您必须将{YOUR_BUCKET_NAME}替换为Amazon S3存储段的实际名称。 如果要授予特定文件夹的访问权限，则还必须将{YOUR_FOLDER_NAME}替换为要授予访问权限的文件夹的实际名称。
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AEP Get Object Related Policy Prod",
            "Effect": "Allow",
            "Principal": {
                "AWS": "{IAM_ROLE_TO_ALLOW_LIST}"
            },
            "Action": "s3:Get*",
            "Resource": "arn:aws:s3:::{YOUR_BUCKET_NAME}/{YOUR_FOLDER_NAME}"
        },
        {
            "Sid": "AEP List Bucket Prod",
            "Effect": "Allow",
            "Principal": {
                "AWS": "{IAM_ROLE_TO_ALLOW_LIST}"
            },
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::{YOUR_BUCKET_NAME}"
        }
    ]
}

在AWS的Experience Platform上为Amazon S3创建基本连接

础笔滨格式

POST /connections

请求

以下请求为Amazon S3创建基本连接：

选择以查看示例
code language-shell 
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 for Experience Platform on AWS",
      "description": "Amazon S3 base connection for Experience Platform on AWS",
      "auth": {
          "specName": "IAMRole Based",
          "params": {
              "bucketName": "{YOUR_BUCKET_NAME}"
          }
      },
      "connectionSpec": {
          "id": "ecadc60c-7455-4d87-84dc-2a0e293d997b",
          "version": "1.0"
      }
  }'
table 0-row-2 1-row-2
属性 描述
auth.params.bucketName Amazon S3存储段的名称。 该值与上一步中添加到权限中的值相同。

响应

成功的响应返回新创建的连接的详细信息，包括其唯一标识符(id)。 在下一个教程中，需要此ID来浏览您的存储。

选择以查看示例
code language-json 
{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700d77b-0000-0200-0000-5e3b41a10000\""
}

后续步骤

通过学习本教程，您已使用API创建了S3连接，并获取了唯一ID作为响应正文的一部分。 您可以使用此连接ID以使用流服务API?来浏览云存储。

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089