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

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

请求头

该接口使用公共请求头，无特殊请求头。请参见公共请求参数文档。

请求语法

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

请求参数

名称 类型 位置 是否必选 示例值 描述
serviceName String Path 是 service_name

异步调用配置所属的服务的名称。
functionName String Path 是 testHelloWorld

异步调用配置所属的函数的名称。
qualifier String Path 否 alias

异步调用配置所属的服务的别名或版本。
Object Body 否

异步调用配置。
destinationConfig DestinationConfig Body 否

异步调用目标的配置结构体。
maxAsyncEventAgeInSeconds Long Body 否 300

消息最大存活时长，取值范围[1,2592000]。单位：秒。
maxAsyncRetryAttempts Long Body 否 3

异步调用失败后的最大重试次数，默认值为3。取值范围[0,8]。

返回数据

名称 类型 示例值 描述
createdTime String 2020-08-20T02:28:21Z

服务的创建时间。
destinationConfig DestinationConfig

异步调用目标的配置结构体。
functionName String testHelloWorld

异步调用配置所属的函数的名称。
lastModifiedTime String 2020-09-10T02:45:02Z

异步调用配置的最后更改时间。
maxAsyncEventAgeInSeconds Long 1

消息最大存活时长，取值范围[1,2592000]。单位：秒。
maxAsyncRetryAttempts Long 1

异步调用失败后的最大重试次数，默认值为3。取值范围[0,8]。
qualifier String alias

异步调用配置所属的服务的别名或版本。
serviceName String service_name

异步调用配置所属的服务的名称。

示例

请求示例

PUT /2016-08-15/services/service_name.alias/functions/testHelloWorld/async-invoke-config HTTP/1.1
公共请求头
{
    "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
}

正常返回示例

JSON 格式 

HTTP/1.1 200 OK
公共响应头
{
    "serviceName":"service_name",
    "functionName":"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/service_name.alias/functions/testHelloWorld"
        }
    },
    "maxAsyncEventAgeInSeconds":1,
    "maxAsyncRetryAttempts":1
}