文档Journey OrchestrationJourney Orchestration

使用上限API work

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 中级
  • 用户

上限API可帮助您创建、配置和监控上限配置。

API说明上限

方法
路径
描述
POST
list/endpointConfig
获取端点上限配置的列表
POST
/endpointConfigs
创建端点上限配置
POST
/endpointConfigs/{uid}/deploy
部署端点上限配置
POST
/endpointConfigs/{uid}/undeploy
取消部署端点上限配置
POST
/endpointConfigs/{uid}/canDeploy
检查是否可以部署端点上限配置
PUT
/endpointConfigs/{uid}
更新端点上限配置
GET
/endpointConfigs/{uid}
检索端点上限配置
DELETE
/endpointConfigs/{uid}
删除端点封顶配置

创建或更新配置时，将自动执行检查以确保语法和有效负载的完整性。
如果发生某些问题，该操作将返回警告或错误，以帮助您更正配置。

端点配置

以下是端点配置的基本结构：

{
    "url": "<endpoint URL>",  //wildcards are allowed in the endpoint URL
    "methods": [ "<HTTP method such as GET, POST, >, ...],
    "services": {
        "<service name>": { . //must be "action" or "dataSource"
            "maxHttpConnections": <max connections count to the endpoint (optional)>
            "rating": {
                "maxCallsCount": <max calls to be performed in the period defined by period/timeUnit>,
                "periodInMs": <integer value greater than 0>
            }
        },
        ...
    }
}
IMPORTANT
maxHttpConnections ​参数是可选的。 它允许您限制Journey Optimizer将打开到外部系统的连接数。
可以设置的最大值为400。 如果未指定任何内容，则系统可能会打开数千个连接，具体取决于系统的动态缩放情况。

示例：

`{
  "url": "https://api.example.org/data/2.5/*",
  "methods": [
    "GET"
  ],
  "services": {
    "dataSource": {
      "maxHttpConnections": 50,
      "rating": {
        "maxCallsCount": 500,
        "periodInMs": 1000
      }
    }
  },
  "orgId": "<IMS Org Id>"
}

警告和错误

调用​ canDeploy ​方法时，进程将验证配置并返回由其唯一ID标识的验证状态：

"ok" or "error"

潜在的错误包括：

  • ERR_ENDPOINTCONFIG_100：配置上限：缺少URL或无效的URL
  • ERR_ENDPOINTCONFIG_101：上限配置：错误的url
  • ERR_ENDPOINTCONFIG_102：上限配置：格式错误的url：主机：端口中不允许使用url中的通配符
  • ERR_ENDPOINTCONFIG_103：上限配置：缺少HTTP方法
  • ERR_ENDPOINTCONFIG_104：上限配置：未定义调用等级
  • ERR_ENDPOINTCONFIG_107：上限配置：无效的最大调用计数(maxCallsCount)
  • ERR_ENDPOINTCONFIG_108：上限配置：无效的最大调用计数(periodInMs)
  • ERR_ENDPOINTCONFIG_111：上限配置：无法创建终结点配置：有效负载无效
  • ERR_ENDPOINTCONFIG_112：上限配置：无法创建终结点配置：应为JSON负载
  • ERR_AUTHORING_ENDPOINTCONFIG_1：无效的服务名称<!--<given value>-->：必须为“dataSource”或“action”

潜在的警告是：

ERR_ENDPOINTCONFIG_106：上限配置：未定义最大HTTP连接：默认情况下无限制

用例

在此部分中，您将找到五个主要用例，您可以执行这些用例来管理Journey Orchestration中的上限配置。

为帮助您进行测试和配置，可点击此处获取 Postman 集合。

此“Postman 集合”已设置为通过 Adobe I/O 控制台的集成 > 试用 > 为 Postman 下载 ​共享 Postman 变量集合，它会使用选定的集成值生成 Postman 环境文件。

下载并上传到 Postman 后，您需要添加三个变量：{JO_HOST}、{BASE_PATH} 和 {SANDBOX_NAME}。

  • {JO_HOST}：Journey Orchestration网关 URL
  • {BASE_PATH}：API 的入口点。值为“/authoring”
  • {SANDBOX_NAME}：标头 x-sandbox-name（例如，“prod”），对应将执行 API 操作的沙盒名称。有关更多信息，请参阅沙盒概述。

在以下部分中，您将找到用于执行用例的 Rest API 调用排序列表。

用例n°1： 创建和部署新上限配置

  1. list
  2. create
  3. candeploy
  4. deploy

用例n°2： 更新和部署尚未部署上限配置

  1. list
  2. get
  3. update
  4. candeploy
  5. deploy

用例n°3： 取消部署并删除已部署的上限配置

  1. list
  2. undeploy
  3. delete

用例n°4： 删除已部署的上限配置。

在仅一个 API 调用中，您可以使用 forceDelete 参数取消部署和删除配置。

  1. list
  2. 删除，使用 forceDelete 参数

用例n°5： 更新已部署的上限配置

  1. list
  2. get
  3. update
  4. undeploy
  5. candeploy
  6. deploy
recommendation-more-help
4f4a00c1-77c9-4eee-84df-bbe6206c3ab9