调用PutFunctionAsyncInvokeConfig接口创建或更新函数的异步调用配置。

使用说明

  • 如果函数的异步调用配置不存在,调用PutFunctionAsyncInvokeConfig接口则会创建相应配置。
  • 如果函数的异步调用配置已存在,调用PutFunctionAsyncInvokeConfig接口则会更新本次调用时新传递的内容,未指定的内容将保持不变。

请求方式

PUT /services/{serviceName}.{qualifier}/functions/{functionName}/async-invoke-config

请求参数

参数位置 名称 类型 是否必选 示例值 描述
Path serviceName String demo3 异步调用配置所属的服务的名称。
Path qualifier String alias 异步调用配置所属的服务的别名或版本。
Path functionName String testHelloWorld 异步调用配置所属的函数的名称。
Body destinationConfig Object - 异步调用目标的配置结构体。
Body onSuccess Object - 异步调用成功的目标服务。
Body destination String acs:mns:cn-shanghai:1986***743:/queues/queue_name/messages 目标服务的ARN。
Body onFailure Object - 异步调用失败的目标服务。
Body destination String acs:fc:cn-hangzhou:1986***743:services/demo3.alias/functions/testHelloWorld 目标服务的ARN。
Body maxAsyncEventAgeInSeconds Integer (Int64) 1 消息最大存活时长,取值范围[1,2592000]。单位:秒。
Body maxAsyncRetryAttempts Integer (Int64) 1 异步调用失败后的最大重试次数,默认值为3。取值范围[0,8]。

返回参数

参数位置 参数 类型 示例值 描述
Body service String demo3 异步调用配置所属的服务的名称。
Body function String testHelloWorld 异步调用配置所属的函数的名称。
Body createdTime String 2020-08-20T02:28:21Z 异步调用配置的创建时间。
Body qualifier String alias 异步调用配置所属的服务的别名或版本。
Body lastModifiedTime String 2020-09-10T02:45:02Z 异步调用配置的最后更改时间。
Body destinationConfig Object - 异步调用目标的配置结构体。
Body onSuccess Object - 异步调用成功的目标服务。
Body destination String acs:mns:cn-shanghai:1986***743:/queues/queue_name/messages 目标服务的ARN。
Body onFailure Object - 异步调用失败的目标服务。
Body destination String acs:fc:cn-hangzhou:1986***743:services/demo3.alias/functions/testHelloWorld 目标服务的ARN。
Body maxAsyncEventAgeInSeconds Integer (Int64) 1 消息最大存活时长,取值范围[1,2592000]。单位:秒。
Body maxAsyncRetryAttempts Integer (Int64) 1 异步调用失败后的最大重试次数,默认值为3。取值范围[0,8]。

示例

请求示例

PUT /2016-08-15/services/demo3.alias/functions/testHelloWorld/async-invoke-config HTTP/1.1
Accept: */*
Accept-Encoding: gzip, deflate
Authorization: FC LTAIPLtP0uxMPtgk:XmdS1hkALgJuBPn034Z5FKIdU****
Content-Length: 111
Content-Type: application/json
Date: Mon, 27 Jul 2020 06:02:55 GMT
Host: 1986***743.cn-hangzhou.fc.aliyuncs.com
Connection: keep-alive
{
  "destinationConfig": {
    "onSuccess": {
      "destination": "acs:mns:cn-shanghai:1986***743:/queues/queue_name/messages"
    },
    "onFailure": {
      "destination": "acs:fc:cn-hangzhou:1986***743:services/demo3.alias/functions/testHelloWorld"
    }
  },
  "maxAsyncEventAgeInSeconds": 1,
  "maxAsyncRetryAttempts": 1
}

返回示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-Fc-Request-Id: 2c76a63d-bc79-40f1-90d3-ecb1**
Date: Mon, 27 Jul 2020 06:02:55 GMT
Content-Length: 111
body:
{
  "service": "demo3",
  "function": "testHelloWorld",
  "createdTime": "2020-08-20T02:28:21Z",
  "qualifier": "alias",
  "lastModifiedTime": "2020-09-10T02:45:02Z",
  "destinationConfig": {
    "onSuccess": {
      "destination": "acs:mns:cn-shanghai:1986***743:/queues/queue_name/messages"
    },
    "onFailure": {
      "destination": "acs:fc:cn-hangzhou:1986***743:services/demo3.alias/functions/testHelloWorld"
    }
  },
  "maxAsyncEventAgeInSeconds": 1,
  "maxAsyncRetryAttempts": 1
}
说明 错误响应格式请参见Error。错误码详情请参见错误码列表