会话生命周期管理

核心流程概览

1. 创建函数并开启会话亲和功能；

2. 调用 CreateSession API 创建会话，如需为会话挂载持久化存储，可以在请求中继续添加 nas_config参数进行配置；

3. 在调用 InvokeFunction 时携带 sessionId，将请求路由到已绑定存储的会话实例；

4. 根据需要调用 UpdateSession 或 DeleteSession 管理会话生命周期。

步骤一：开启会话亲和功能

在创建函数或更新函数配置时，开启会话亲和配置。以 HeaderField 亲和为例，需指定一个 Header Key（例如：x-affinity-header-v1）用于传递 SessionID。下面以更新已有函数配置为例：

1. 登录函数计算控制台，点击函数管理>函数列表

2. 在函数列表页，点击需要配置的函数名称，进入函数详情页

3. 在配置页，找到高级配置，点击

4. 打开会话亲和开关，选择HeaderField 亲和并配置Header Name，例如：x-affinity-header-v1

   说明

   不能以 x-fc- 前缀开头，以字母开头，非首字符可包含数字、中划线、下划线、字母，长度大于等于5个字符并且不超过40个字符。

5. 点击部署完成配置更新。

步骤二：创建会话资源

本文以Python SDK为例，调用API CreateSession - 创建会话资源，创建会话。

1. 安装SDK依赖包

   macOS / Linux

   # 使用 pip3 安装
   pip3 install alibabacloud_fc20230330 alibabacloud_credentials alibabacloud_tea_openapi alibabacloud_tea_util
   
   # 如遇权限问题，使用 --user 参数
   pip3 install --user alibabacloud_fc20230330 alibabacloud_credentials alibabacloud_tea_openapi alibabacloud_tea_util
   
   # macOS Homebrew Python 环境需使用 --break-system-packages
   pip3 install --break-system-packages alibabacloud_fc20230330 alibabacloud_credentials alibabacloud_tea_openapi alibabacloud_tea_util

   Windows

   # 使用 pip 安装
   pip install alibabacloud_fc20230330 alibabacloud_credentials alibabacloud_tea_openapi alibabacloud_tea_util
   
   # 或使用 Python 3 指定
   py -3 -m pip install alibabacloud_fc20230330 alibabacloud_credentials alibabacloud_tea_openapi alibabacloud_tea_util

2. 编写创建会话核心代码

   创建python代码文件（如：creatSession.py），将下列代码复制到文件中并替换核心参数。

   核心方法及核心参数说明：

   • config.endpoint：

     • <账号ID>：替换为阿里云账号ID；

     • <Endpoint>：请参考函数计算3.0 服务区域列表，规则为fcv3.[region_id].aliyuns.com；

   • CreateSessionInput：

     • session_ttlin_seconds：会话总生命周期（单位：秒）；

     • session_idle_timeout_in_seconds：会话闲置过期时间（单位：秒）；

   • client.create_session_with_options：将<函数名称>替换为创建Session的函数名称；

   # -*- coding: utf-8 -*-
   from alibabacloud_fc20230330.client import Client as FC20230330Client
   from alibabacloud_credentials.client import Client as CredentialClient
   from alibabacloud_tea_openapi import models as open_api_models
   from alibabacloud_fc20230330 import models as fc20230330_models
   from alibabacloud_tea_util import models as util_models
   
   # 1. 创建账号Client
   credential = CredentialClient()
   config = open_api_models.Config(credential=credential)
   config.endpoint = f'<账号ID>.<Endpoint>'
   client = FC20230330Client(config)
   
   # 2. 构造 CreateSession 请求
   create_session_input = fc20230330_models.CreateSessionInput(
       session_ttlin_seconds=3600,
       session_idle_timeout_in_seconds=600
   )
   create_session_request = fc20230330_models.CreateSessionRequest(
       body=create_session_input
   )
   
   # 3. 发起请求
   runtime = util_models.RuntimeOptions()
   response = client.create_session_with_options('<函数名称>', create_session_request, {}, runtime)
   
   # 4. 从响应中获取 sessionId
   print(response.body.to_map())
   session_id = response.body.session_id
   print(f"Session created successfully. Session ID: {session_id}")
   

步骤三：（可选）配置动态存储

1. 配置函数：如需对会话配置动态存储，函数需要进行如下配置：

   1. 实例隔离：开启配置>高级配置>实例隔离，并选择会话隔离；

   2. 允许访问 VPC：

      • 开启配置>高级配置>网络>允许访问 VPC；

      • 配置方式选择自定义配置；

      • 专有网络选择挂载点所在的 VPC。

2. 添加nas_config配置：在步骤二：创建会话资源的代码中，参考如下代码加入配置 nas_config 对象来指定挂载信息和用户身份。

   核心方法及参数说明：

   重要

   会话动态挂载NAS和在函数配置>高级配置>存储中挂载NAS可以同时配置，但是需要注意：

   • 下文NASConfig 中定义的 User ID/Group ID必须与函数挂载配置中使用的用户（User ID）/用户组（Group ID）保持一致

   • 同一个挂载路径 (mount_dir) 不能同时用于会话动态挂载和函数挂载

   • NASConfig：配置 NAS 和用户身份（为租户A分配独立UID/GID）

     • NASMountConfig：NAS 挂载配置

       • mount_dir：实例内的挂载路径，如：/home/test

       • server_addr：NAS 文件系统地址及租户专属子目录

     • user_id：为此会话指定独立的 POSIX User ID

     • group_id：为此会话指定独立的 POSIX Group ID

# -*- coding: utf-8 -*-
from alibabacloud_fc20230330.client import Client as FC20230330Client
from alibabacloud_credentials.client import Client as CredentialClient
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_fc20230330 import models as fc20230330_models
from alibabacloud_tea_util import models as util_models

# 1. 创建账号Client
credential = CredentialClient()
config = open_api_models.Config(credential=credential)
config.endpoint = f'<账号ID>.<Endpoint>'
client = FC20230330Client(config)

# 2. 准备 NAS 挂载配置
nas_mount_config = fc20230330_models.NASMountConfig(
    mount_dir='/mnt/data',  # 实例内的挂载路径
    server_addr='<YOUR-NAS-SERVER-ADDR>:/<tenant-a-path>'  # NAS 文件系统地址及租户专属子目录
)

# 3. 配置 NAS 和用户身份（为租户A分配独立UID/GID）
nas_config = fc20230330_models.NASConfig(
    mount_points=[nas_mount_config],
    user_id=1001,  # 为此会话指定独立的 POSIX User ID
    group_id=1001  # 为此会话指定独立的 POSIX Group ID
)

# 4. 构造 CreateSession 请求
create_session_input = fc20230330_models.CreateSessionInput(
    nas_config=nas_config,
    session_ttlin_seconds=3600,
    session_idle_timeout_in_seconds=600
)
create_session_request = fc20230330_models.CreateSessionRequest(
    body=create_session_input
)

# 5. 发起请求
runtime = util_models.RuntimeOptions()
response = client.create_session_with_options('<函数名称>', create_session_request, {}, runtime)

# 6. 从响应中获取 sessionId
print(response.body.to_map())
session_id = response.body.session_id
print(f"Session created successfully. Session ID: {session_id}")

步骤四：运行代码创建会话

1. 执行如下命令，运行代码

   export ALIBABA_CLOUD_ACCESS_KEY_ID=LTAI****************
   export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<yourAccessKeySecret>
   python3 creatSession.py

   参数说明：

   • ALIBABA_CLOUD_ACCESS_KEY_ID：阿里云账号或 RAM 用户的AccessKey ID；

   • ALIBABA_CLOUD_ACCESS_KEY_SECRET：阿里云账号或 RAM 用户的AccessKey Secret。

2. 查看返回结果

   • 控制台打印结果：

     {
       'containerId': 'c-********-********-************', 
       'createdTime': '2025-10-30T06:38:10Z', 
       'functionName': '****', 
       'lastModifiedTime': '2025-10-30T06:38:10Z', 
       'nasConfig': 
         {
           'groupId': 0, 
           'mountPoints': [
             {
               'enableTLS': False, 
               'mountDir': '/home/test', 
               'serverAddr': '*-*.*.nas.aliyuncs.com:/test'
                }
                  ], 
                  'userId': 0
                  }, 
        'qualifier': 'LATEST', 
        'sessionAffinityType': 'HEADER_FIELD', 
        'sessionId': '******************', 
        'sessionIdleTimeoutInSeconds': 600, 
        'sessionStatus': 'Active', 
        'sessionTTLInSeconds': 3600
        }
     Session created successfully. Session ID: ************

步骤五：使用会话调用函数

调用API InvokeFunction- 调用函数，使用会话调用函数。

核心代码示例及说明：

InvokeFunctionHeaders：构造请求头，在请求Header中携带上一步返回的sessionId，Header Key的值与步骤一：开启会话亲和功能设置的值（如：x-affinity-header-v1）保持一致，实现会话绑定路由。

# -*- coding: utf-8 -*-
from alibabacloud_fc20230330.client import Client as FC20230330Client
from alibabacloud_credentials.client import Client as CredentialClient
from alibabacloud_tea_openapi import models as open_api_models
from alibabacloud_fc20230330 import models as fc20230330_models
from alibabacloud_tea_util import models as util_models


# 1. 创建账号Client
credential = CredentialClient()
config = open_api_models.Config(credential=credential)
config.endpoint = f'<账号ID>.<Endpoint>'
client = FC20230330Client(config)

# 2. 构造请求头。Header Key ("x-affinity-header-v1") 必须与函数配置的会话亲和 Key 一致。
headers = fc20230330_models.InvokeFunctionHeaders(
    common_headers={
        "x-affinity-header-v1": 'session_id'
    }
)

# 3. 构造调用请求（可根据需要传入 body）
invoke_request = fc20230330_models.InvokeFunctionRequest(
    body='your_request_payload'.encode('utf-8')  # 示例 payload
)

runtime = util_models.RuntimeOptions()

try:
    # 4. 发起调用
    invoke_response = client.invoke_function_with_options(
        'your_function_name',
        invoke_request,
        headers,
        runtime
    )
    # 4. 处理响应
    print(f"Status Code: {invoke_response.status_code}")
    print(f"Response Body: {invoke_response.body.decode('utf-8')}")
except Exception as error:
    print(error.message)

后续步骤：更新与删除会话

1. 根据业务需要，可调用 UpdateSession - 更新会话配置 延长会话有效期等

   说明

   在 CreateSession 传入 nas_config 后，不可通过 UpdateSession 进行更新

2. 调用 GetSession - 获取会话配置信息，获取当前会话的最新配置信息，确认更新结果。

3. 在任务完成后调用 DeleteSession - 删除会话资源，释放会话资源。