使用ModifyFlowControlTask修改流量控制任务-智能推荐 AIRec-阿里云-智能推荐 AIRec(AIRec)-阿里云帮助中心

流调任务修改接口。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

airec:ModifyFlowControlTask

update

*Instance

acs:airec:{#regionId}:{#accountId}:instance/{#InstanceId}

无

请求语法

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

路径参数

名称	类型	必填	描述	示例值
instanceId	string	否	实例 ID。	airec-cn-****
taskId	string	否	流量调控任务 ID。	1667297014460

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求 Body 参数。
TaskName	string	否	流量调控任务名称。	testname
description	string	否	流量调控描述信息。	描述
endTime	integer	否	结束时间秒级时间戳。	1639519200
metaType	string	否	流量调控 Meta 类型，固定值 FlowControlTask。	FlowControlTask
sceneIds	string	否	场景 ID，支持多个，英文,分割即可。	all,sy101
selectionParams	array<object>	否	选品规则参数列表。
	object	否	选品规则参数。
selectType	string	否	选品规则过滤条件类型。	invalidItem
selectValue	string	否	选品规则过滤条件具体数值。	20
selectionOperation	string	否	选品规则过滤条件操作。	OPERATOR_HIGHER
startTime	integer	否	开始时间（秒级时间戳）。	1638460800
target	object	否	物品曝光配置。
type	string	否	曝光类型。取值： EXPOSE_PERCENT：每日曝光百分比。 EXPOSE_COUNT：曝光总量。	EXPOSE_PERCENT
value	integer	否	曝光值。	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	integer	结束时间秒级时间戳。	1656518399
metaType	string	流量调控 Meta 类型，固定值 FlowControlTask。	FlowControlTask
sceneIds	string	场景 ID，支持多个，英文,分割即可。	1,2,3
selectionParams	array<object>	选品规则参数列表。
	object	选品规则参数。
selectType	string	选品规则过滤条件类型。	QUERY_PUB_TIME
selectValue	string	选品规则过滤条件具体数值。	10000
selectionOperation	string	选品规则过滤条件操作。	OPERATOR_HIGHER
startTime	integer	开始时间（秒级时间戳）。	1640739600
target	object	曝光配置。
type	string	曝光类型。取值： EXPOSE_PERCENT：每日曝光百分比。 EXPOSE_COUNT：曝光总量。	EXPOSE_PERCENT
value	integer	曝光值。	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"
  }
}

错误码

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

变更历史

更多信息，参考变更详情。