创建目标服务器配置
创建目标服务器是使用Destination SDK创建自己的目标的第一步。 目标服务器包括服务器和模板规范、消息格式以及文件格式选项(用于基于文件的目标)的配置选项。
此页面展示了可用于使用/authoring/destination-servers
API端点创建自己的目标服务器的API请求和有效负荷。
有关可通过此端点配置的功能的详细说明,请参阅以下文章:
目标服务器API操作快速入门 get-started
在继续之前,请查看入门指南以了解成功调用API所需了解的重要信息,包括如何获取所需的目标创作权限和所需的标头。
创建目标服务器配置 create
您可以通过向/authoring/destination-servers
端点发出POST
请求来创建新的目标服务器配置。
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端点创建新的目标服务器。
要了解有关可使用此端点执行的操作的更多信息,请参阅以下文章:
要了解此端点在目标创作过程中的位置,请参阅以下文章: