:時間トリガー（Time Trigger）

時間トリガー（Time Trigger）

Function Compute は、指定された時点で関数の実行をトリガー（Time Trigger）する時間トリガーをサポートします。本ドキュメントでは、時間トリガーについて 2 つの部分で説明します。

• 時間トリガーの配置方式およびパラメータ設定。
• コンソールからの時間トリガーの作成、fcli による時間トリガーの作成、および sdk の呼び出しによる時間トリガーの作成など、3 つの作成方法。

時間トリガーの設定

{
    payload:"payload"
    cronExpression: "cronExpression"
    enable: true|false
}

• payload: トリガーイベント自体の入力内容を表し、ユーザーがカスタマイズできます。
• cronExpression: 関数がトリガされる時刻は、2 つの設定方法をサポートしています。
  • @every
  • cron 式

cronExpression の設定

注意：時間トリガーに現在許可されている最小トリガー間隔は 1 分です。次の 2 つの cron 式では、間隔が 1 分未満の場合は無効な入力とみなされますので、使用しないでください。

@every

@every Value Unitここで、value は正の整数で、Unit は"ns", "us" (or "µs"), "ms", "s", "m"です。 "h"は Value Unit 時間ごとに関数がトリガされることを示します。

cron 式

cron(Seconds Minutes Hours Day-of-month Month Day-of-week ) は標準的な cron式の書式です。

注意： Cron は UTC 時間、つまり北京時間から8時間を引いた時間で実行します。

特殊文字の説明

以下の表は、cron expressionの一般的な例を示しています。

次の表の第 1 列は北京時間で、第 2 列は北京時間の対応するUTC時間（北京時間 - 8時間）です。たとえば、北京時間の 12：00 は UTC 時間の 4：00 です。 cronの式は 0 0 4 * * *です

Event 形式

時間トリガーは、以下の Event 形式で関数をトリガし、Event に応じで処理します。

{
    "triggerTime":"2018-02-09T05:49:00Z",
    "triggerName":"my_trigger",
    "payload":"awesome-fc"
}

• triggerTime は trigger をトリガする時間である、一つの trigger は、トリガ可能な時間内に複数回トリガーされることがありますが、ユーザーはこの値を使用して大量の処理を行うことができます。
• triggerName は trigger の名前です。
• payload はトリガ設定のユーザ入力パラメータです。

使用方法

Function Compute コンソールから、コマンドツールfcliを使用して、またはsdkを介して設定するなど三つの方法で関数トリガーを設定できます。 次に、これらの 3つ の方法について説明します。

時間トリガー設定を作成するにはSourceArnとInvocationRoleを指定する必要はありません。

コンソール

新しい関数を作成するときに、時間トリガーを作成することができます。

また、既存の関数を設定した時刻にトリガすることもできます。まず、関数プロパティページをクリックし、トリガーページをクリックして、時間トリガーを作成します。

コマンドラインツール fcli を使用

• 最初に、TimeTrigger Config を含む yaml ファイルを作成する必要があります。たとえば、入力パラメータが 「awesome-fc」 の関数トリガーが 5 時間ごとにトリガされる場合、トリガの timeTriggerConfig.yaml ファイルは次のようになります。

  triggerConfig:
    payload: "awesome-fc" 
    cronExpression: "0 0 0/5 * * ?"
    enable: true

• トリガーを作成（対応する function ディレクトリ内）mkt serviceName/functionName -t timer -c timeTriggerConfig.yaml

SDK を介して呼び出す

fc-python-sdk を例として、Function Compute は fc-nodejs-sdk，fc-java-sdk も提供します。

import fc2
client = fc2.Client(
    endpoint = '<Your Endpoint>',
    accessKeyID = '<Your AccessKeyID>',
    accessKeySecret = '<Your AccessKeySecret>')
service_name = '<service_name>'
function_name = '<function_name>'
trigger_name = '<trigger_name>'
trigger_type = 'timer'
trigger_config = {
    'payload': 'awesome-fc',
    'cronExpression': '0 0 0/5 * * ?',
    'enable': True
}
client.create_trigger(service_name, function_name,
                      trigger_name, trigger_type, trigger_config, None, None)

関数のコード

import json
import logging
LOG = logging.getLogger()
def handler(event, context):
    LOG.info('event: %s', event)
    evt = json.loads(event)
    triggerName = evt["triggerName"]
    triggerTime = evt["triggerTime"]
    message = evt["payload"]
    creds = context.credentials
    LOG.info('access_key_id: %s', creds.access_key_id)
    LOG.info("message = %s", message)

ご不明な点がございましたら、メッセージをいただくか、または Function Compute の公式顧客チャートグループに加入してください。（DingTalk グループ番号：11721331）