调用ModifyFlowControlTask修改流量控制任务,目前只支持草稿态和发布失败状态的任务修改配置信息

流调任务修改接口。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

PUT /v2/openapi/instances/{instanceId}/flowControlTasks/{taskId}

请求参数

名称	类型	必填	描述	示例值
instanceId	string	否	实例 ID。	airec-cn-****
taskId	string	否	流量调控任务 ID。	1667297014460
body	object	否	请求 Body 参数。
TaskName	string	否	流量调控任务名称。	testname
description	string	否	流量调控描述信息。	描述
endTime	long	否	结束时间秒级时间戳。	1639519200
metaType	string	否	流量调控 Meta 类型，固定值 FlowControlTask。	FlowControlTask
sceneIds	string	否	场景 ID，支持多个，英文,分割即可。	all,sy101
selectionParams	object []	否	选品规则参数列表。
selectType	string	否	选品规则过滤条件类型。	invalidItem
selectValue	string	否	选品规则过滤条件具体数值。	20
selectionOperation	string	否	选品规则过滤条件操作。	OPERATOR_HIGHER
startTime	long	否	开始时间（秒级时间戳）。	1638460800
target	object	否	物品曝光配置。
type	string	否	曝光类型。取值： EXPOSE_PERCENT：每日曝光百分比。 EXPOSE_COUNT：曝光总量。	EXPOSE_PERCENT
value	long	否	曝光值。	50

返回参数

名称	类型	描述	示例值
	object	返回参数。
requestId	string	请求 ID。	8F81A922-6C81-46D6-B78C-CC35E16B1691
result	object	返回参数。
gmtCreate	string	创建时间的 UTC 时间。	2018-12-07T02:24:26.000Z
gmtModified	string	最后修改数据源的 UTC 时间。	2020-11-11T09:47:43.000Z
meta	object	流量调控 Meta。
description	string	流量调控描述信息。	tst
endTime	long	结束时间秒级时间戳。	1656518399
metaType	string	流量调控 Meta 类型，固定值 FlowControlTask。	FlowControlTask
sceneIds	string	场景 ID，支持多个，英文,分割即可。	1,2,3
selectionParams	object []	选品规则参数列表。
selectType	string	选品规则过滤条件类型。	QUERY_PUB_TIME
selectValue	string	选品规则过滤条件具体数值。	10000
selectionOperation	string	选品规则过滤条件操作。	OPERATOR_HIGHER
startTime	long	开始时间（秒级时间戳）。	1640739600
target	object	曝光配置。
type	string	曝光类型。取值： EXPOSE_PERCENT：每日曝光百分比。 EXPOSE_COUNT：曝光总量。	EXPOSE_PERCENT
value	long	曝光值。	20
taskName	string	流量调侃任务名称。	活动用户测试
status	string	任务状态。取值： DRAFT：草稿。 READY：待生效。 RUNNING：运行中。 ENDED：结束。	DRAFT
TaskId	string	流量调侃任务 ID。	1661506482

示例

正常返回示例

JSON格式

{
  "requestId": "8F81A922-6C81-46D6-B78C-CC35E16B1691",
  "result": {
    "gmtCreate": "2018-12-07T02:24:26.000Z",
    "gmtModified": "2020-11-11T09:47:43.000Z",
    "meta": {
      "description": "tst",
      "endTime": 1656518399,
      "metaType": "FlowControlTask",
      "sceneIds": "1,2,3",
      "selectionParams": [
        {
          "selectType": "QUERY_PUB_TIME",
          "selectValue": "10000",
          "selectionOperation": "OPERATOR_HIGHER"
        }
      ],
      "startTime": 1640739600,
      "target": {
        "type": "EXPOSE_PERCENT",
        "value": 20
      },
      "taskName": "活动用户测试"
    },
    "status": "DRAFT",
    "TaskId": "1661506482"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作

暂无变更历史