创建一个显式会话资源。系统自动生成唯一 SessionID,预分配函数实例并绑定会话,支持指定 TTL 和 IdleTimeout。适用于 HEADER_FIELD 或 GENERATED_COOKIE 亲和类型,实现会话预热与配置初始化,调用后即可在 InvokeFunction 请求携带,用于路由请求。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
fc:CreateSession |
create |
*全部资源
|
无 | 无 |
请求语法
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",
"nasConfig": {
"groupId": 100,
"mountPoints": [
{
"enableTLS": true,
"mountDir": "/home/test",
"serverAddr": "***-uni85.cn-hangzhou.nas.com:/"
}
],
"userId": 100
},
"disableSessionIdReuse": false,
"ossMountConfig": {
"mountPoints": [
{
"bucketName": "my-bucket",
"bucketPath": "/my-dir",
"endpoint": "http://oss-cn-shanghai.aliyuncs.com",
"mountDir": "/mnt/dir",
"readOnly": true
}
]
},
"polarFsConfig": {
"groupId": 0,
"userId": 0,
"mountPoints": [
{
"instanceId": "",
"mountDir": "",
"remoteDir": "",
"readOnly": true
}
]
},
"juiceFsConfig": {
"mountPoints": [
{
"volumeName": "",
"mountDir": "",
"remoteDir": "",
"token": "",
"args": [
""
]
}
],
"envs": {
"key": ""
}
},
"enableAutoPause": true,
"enableAutoResume": true
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。
该文章对您有帮助吗?