创建目标服务器配置
创建目标服务器是使用Destination SDK创建自己的目标的第一步。 目标服务器包括 服务器 和 模板 规格, 消息格式,和 文件格式 选项(适用于基于文件的目标)。
本页举例说明了API请求和有效负荷,您可以使用这些请求和有效负荷创建自己的目标服务器。 /authoring/destination-servers
API端点。
有关可通过此端点配置的功能的详细说明,请参阅以下文章:
目标服务器API操作快速入门 get-started
在继续之前,请查看 快速入门指南 获取成功调用API所需了解的重要信息,包括如何获取所需的目标创作权限和所需的标头。
创建目标服务器配置 create
您可以通过创建 POST
请求 /authoring/destination-servers
端点。
platform.adobe.io/data/core/activation/authoring/destination-servers
API格式
POST /authoring/destination-servers
根据您创建的目标类型,您需要配置一个稍有不同的目标服务器类型。
创建静态架构目标服务器 static-destination-servers
请参阅下面选项卡中目标服务器的使用示例 静态架构.
以下示例负载包括每种目标服务器类型支持的所有参数。 您不需要在请求中包含所有参数。 负载可根据您的需求进行自定义。
选择下面的每个选项卡以查看相应的API请求。
创建实时(流)目标服务器
您需要创建类似于以下所示的实时(流)目标服务器,以便配置基于实时(流)API的集成。
accordion | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
请求 | ||||||||||||||||||||||||||||||||
|
accordion |
---|
响应 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。 |
创建Amazon S3目标服务器
您需要创建 Amazon S3 目标服务器,类似于配置基于文件的服务器时所显示的服务器 Amazon S3 目标。
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
请求 | |||||||||||||||||||||||||||||
|
accordion |
---|
响应 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。 |
创建 SFTP 目标服务器
您需要创建 SFTP 目标服务器,类似于配置基于文件的服务器时所显示的服务器 SFTP 目标。
accordion | |||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
请求 | |||||||||||||||||||||||||||||||||||
|
accordion |
---|
响应 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。 |
创建 Azure Data Lake Storage 目标服务器
您需要创建 Azure Data Lake Storage 目标服务器,类似于配置基于文件的服务器时所显示的服务器 Azure Data Lake Storage 目标。
accordion | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
请求 | |||||||||||||||||||||||
|
accordion |
---|
响应 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。 |
创建 Azure Blob Storage 目标服务器
您需要创建 Azure Blob Storage 目标服务器,类似于配置基于文件的服务器时所显示的服务器 Azure Blob Storage 目标。
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
请求 | |||||||||||||||||||||||||||||
|
accordion |
---|
响应 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。 |
创建 Data Landing Zone (DLZ) 目标服务器
您需要创建 Data Landing Zone (DLZ) 目标服务器,类似于配置基于文件的服务器时所显示的服务器 Data Landing Zone (DLZ) 目标。
accordion | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
请求 | |||||||||||||||||||||||
|
accordion |
---|
响应 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。 |
创建 Google Cloud Storage 目标服务器
您需要创建 Google Cloud Storage 目标服务器,类似于配置基于文件的服务器时所显示的服务器 Google Cloud Storage 目标。
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
请求 | |||||||||||||||||||||||||||||
|
accordion |
---|
响应 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。 |
创建动态架构目标服务器 dynamic-schema-servers
动态架构允许您动态检索支持的目标属性,并根据自己的API生成架构。 您需要先为动态架构配置目标服务器,然后才能配置架构。
在选项卡的下方查看目标服务器的示例,这些目标使用 动态架构.
以下有效负载示例包含动态架构服务器所需的所有参数。
创建动态模式服务器
您需要创建类似于以下所示的动态架构服务器,以便配置从您自己的API端点检索其配置文件架构的目标。 与静态架构不同,动态架构不使用 profileFields
数组。 动态架构会改用动态架构服务器,该服务器会连接到您自己的API,并在其中检索架构配置。
accordion | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
请求 | |||||||||||||||||||||||||||||
|
accordion |
---|
响应 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。 |
创建动态下拉目标服务器 dynamic-dropdown-servers
使用 动态下拉菜单 以根据您自己的API动态检索和填充下拉客户数据字段。 例如,您可以检索要用于目标连接的现有用户帐户列表。
您需要先为动态下拉列表配置目标服务器,然后才能配置动态下拉列表客户数据字段。
请参阅以下选项卡中的目标服务器示例,该示例用于从API动态检索要在下拉选择器中显示的值。
以下有效负载示例包含动态架构服务器所需的所有参数。
创建动态下拉服务器
您需要创建一个动态下拉服务器,类似于当您配置从您自己的API端点检索下拉客户数据字段值的目标时,下面显示的服务器。
accordion | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
请求 | ||||||||||||||||||||||||||||||||
|
accordion |
---|
响应 |
成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。 |
API错误处理 error-handling
Destination SDKAPI端点遵循常规Experience PlatformAPI错误消息原则。 请参阅 API状态代码 和 请求标头错误 ,位于平台疑难解答指南中。
后续步骤 next-steps
阅读本文档后,您现在知道如何通过Destination SDK创建新的目标服务器 /authoring/destination-servers
API端点。
要了解有关可使用此端点执行的操作的更多信息,请参阅以下文章:
要了解此端点在目标创作过程中的位置,请参阅以下文章: