Function Compute:セッションのライフサイクル管理

コアフローの概要

1. 関数を作成し、セッション保持機能を有効にします。

2. CreateSession API を呼び出してセッションを作成します。セッションに永続ストレージをマウントするには、リクエストに nas_config パラメーターを追加します。

3. InvokeFunction を呼び出す際に、sessionId を含めて、リクエストをバインドされたストレージを持つセッションインスタンスにルーティングします。

4. 必要に応じて、UpdateSession または DeleteSession を呼び出してセッションのライフサイクルを管理します。

ステップ 1： セッション保持の有効化

関数を作成するか、関数の設定を更新する際に、セッション保持の設定を有効にします。HeaderField アフィニティの場合、SessionID を渡すために、x-affinity-header-v1 のようなヘッダーキーを指定する必要があります。以下の例では、既存の関数設定を更新する方法を説明します：

1. Function Compute コンソールにログオンし、[関数管理] > [関数一覧] を選択します。

2. [関数リスト] ページで、設定する関数の名前をクリックします。 関数の詳細ページが表示されます。

3. [設定] ページの [詳細設定] で、 をクリックします。

4. [セッションアフィニティ] を有効にして、[ヘッダーフィールドアフィニティ] を選択し、[ヘッダー名] を x-affinity-header-v1 などに設定します。

   説明

   ヘッダー名は x-fc- で始めることはできません。文字で始まり、その後に文字、数字、ハイフン (-)、またはアンダースコア (_) を続けることができます。名前の長さは 5～40 文字である必要があります。

5. [デプロイ] をクリックして構成を適用します。

ステップ 2： セッションリソースの作成

このセクションでは、Python SDK を例として、CreateSession - セッションリソースの作成 API を呼び出してセッションを作成する方法を示します。

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. セッションを作成するためのコアコードを記述します。

   createSession.py のような Python コードファイルを作成します。以下のコードをファイルにコピーし、コアパラメーターを置き換えます。

   コアメソッドとパラメーター：

   • config.endpoint：

     • <ご利用の Alibaba Cloud アカウント ID>： これを ご利用の Alibaba Cloud アカウント ID に置き換えます。

     • <エンドポイント>： 詳細については、「Function Compute 3.0 サービスエリアリスト」をご参照ください。フォーマットは fcv3.[region_id].aliyuns.com です。

   • CreateSessionInput：

     • session_ttlin_seconds： セッションの合計 TTL (生存時間) (秒単位)。

     • session_idle_timeout_in_seconds： セッションのアイドルタイムアウト期間 (秒単位)。

   • client.create_session_with_options： <ご利用の関数名> を、セッションを作成したい関数の名前に置き換えます。

   # -*- 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. アカウントクライアントを作成します。
   credential = CredentialClient()
   config = open_api_models.Config(credential=credential)
   config.endpoint = f'<ご利用の Alibaba Cloud アカウント ID>.<エンドポイント>'
   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}")
   

ステップ 3： (オプション) 動的ストレージの設定

1. 関数の設定： セッションに動的ストレージを設定するには、関数を次のように設定する必要があります：

   1. インスタンスフェンシング: [設定] > [詳細設定] > [インスタンスフェンシング] に移動して [セッションフェンシング] を選択します。

   2. VPC アクセスを許可:

      • [設定] > [詳細設定] > [ネットワーク] で [VPC アクセスを許可] を有効にします。

      • [設定方法] を [カスタム設定] に設定します。

      • VPC: マウントポイントを含む VPC を選択します。

2. nas_config 設定の追加： ステップ 2： セッションリソースの作成 のコードで、以下のコードを参照して nas_config オブジェクトを追加します。このオブジェクトは、マウント情報とユーザー ID を指定します。

   コアメソッドとパラメーター：

   重要

   セッションの動的 NAS マウントと関数の NAS マウントを、[設定] > [詳細設定] > [ストレージ] 設定で同時に設定できますが、次の点にご注意ください。

   • 以下の NASConfig で定義された ユーザー ID/グループ ID は、関数のマウント設定で使用されるユーザー (ユーザー ID) およびユーザーグループ (グループ ID) と一致する必要があります。

   • 同じマウントパス (mount_dir) を動的セッションマウントと関数マウントの両方で使用することはできません。

   • NASConfig： NAS ファイルシステムとユーザー ID を設定します。たとえば、テナント A に独立した UID/GID を割り当てることができます。

     • NASMountConfig： NAS マウント設定。

       • mount_dir： インスタンス内のマウントパス。例： /home/test。

       • server_addr： NAS ファイルシステムのアドレスとテナント固有のサブディレクトリ。

     • user_id： このセッションに独立した POSIX ユーザー ID を指定します。

     • group_id： このセッションに独立した POSIX グループ 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. アカウントクライアントを作成します。
credential = CredentialClient()
config = open_api_models.Config(credential=credential)
config.endpoint = f'<ご利用の Alibaba Cloud アカウント ID>.<エンドポイント>'
client = FC20230330Client(config)

# 2. NAS マウント設定を準備します。
nas_mount_config = fc20230330_models.NASMountConfig(
    mount_dir='/mnt/data',  # インスタンス内のマウントパス
    server_addr='<ご利用の NAS サーバーアドレス>:/<テナント A のパス>'  # NAS ファイルシステムのアドレスとテナント固有のサブディレクトリ
)

# 3. NAS ファイルシステムとユーザー ID を設定します。たとえば、テナント A に独立した UID/GID を割り当てます。
nas_config = fc20230330_models.NASConfig(
    mount_points=[nas_mount_config],
    user_id=1001,  # このセッションに独立した POSIX ユーザー ID を指定します。
    group_id=1001  # このセッションに独立した POSIX グループ 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}")

ステップ 4： コードを実行してセッションを作成

1. 次のコマンドを実行してコードを実行します：

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

   パラメーター：

   • ALIBABA_CLOUD_ACCESS_KEY_ID： ご利用の Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ID。

   • ALIBABA_CLOUD_ACCESS_KEY_SECRET： ご利用の Alibaba Cloud アカウントまたは 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: ************

ステップ 5： セッションを使用して関数を呼び出す

InvokeFunction - 関数の呼び出し API を呼び出して、セッションを使用して関数を呼び出します。

コアコードと説明：

InvokeFunctionHeaders： 前のステップで返された sessionId を含むようにリクエストヘッダーを構築します。ヘッダーキー の値は、ステップ 1： セッション保持の有効化 で設定した値 (例： 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. アカウントクライアントを作成します。
credential = CredentialClient()
config = open_api_models.Config(credential=credential)
config.endpoint = f'<ご利用の Alibaba Cloud アカウント ID>.<エンドポイント>'
client = FC20230330Client(config)

# 2. リクエストヘッダーを構築します。ヘッダーキー ("x-affinity-header-v1") は、関数に設定されたセッション保持キーと同じでなければなりません。
headers = fc20230330_models.InvokeFunctionHeaders(
    common_headers={
        "x-affinity-header-v1": 'session_id'
    }
)

# 3. 呼び出しリクエストを構築します。必要に応じて本文を渡すことができます。
invoke_request = fc20230330_models.InvokeFunctionRequest(
    body='your_request_payload'.encode('utf-8')  # ペイロードの例
)

runtime = util_models.RuntimeOptions()

try:
    # 4. 呼び出しリクエストを送信します。
    invoke_response = client.invoke_function_with_options(
        'your_function_name',
        invoke_request,
        headers,
        runtime
    )
    # 5. 応答を処理します。
    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` API を使用して設定を更新することはできません。

2. GetSession - セッション設定情報の取得 を呼び出して、現在のセッションの最新の設定情報を取得し、更新を確認できます。

3. タスクが完了したら、DeleteSession - セッションリソースの削除 を呼び出してセッションリソースを解放できます。