CreateSession - 创建会话资源_函数计算(FC)-阿里云帮助中心

创建一个显式会话资源。系统自动生成唯一 SessionID，预分配函数实例并绑定会话，支持指定 TTL 和 IdleTimeout。适用于 HEADER_FIELD 或 GENERATED_COOKIE 亲和类型，实现会话预热与配置初始化，调用后即可在 InvokeFunction 请求携带，用于路由请求。

调试

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

调试

授权信息

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

请求语法

POST /2023-03-30/functions/{functionName}/sessions HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
functionName	string	否	创建 Session 的函数名称	my-func
qualifier	string	否	用于指定 Sesion 所属的版本或别名	aliasName1
body	CreateSessionInput	否	创建会话配置

返回参数

名称	类型	描述	示例值
	Session	会话资源信息

示例

正常返回示例

JSON格式

{
  "sessionId": "81f70ae156904eb9b7d43e12f511fe58",
  "functionName": "functionName1",
  "sessionAffinityType": "HEADER_FIELD",
  "sessionTTLInSeconds": 21600,
  "sessionIdleTimeoutInSeconds": 1800,
  "createdTime": "2025-04-01T08:15:27Z",
  "lastModifiedTime": "2025-04-01T18:15:27Z",
  "sessionStatus": "Active",
  "containerId": "c-68999e02-16a1955c-d2a03d1ccs",
  "qualifier": "AliasName1"
}

错误码

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