タイマータスク

タイマー タスクによって、インテグレーション実行フローに時間遅延を追加できます。

インテグレーションの実行時、コントロールがタイマータスクに到達すると、指定された制限時間実行は一時停止し、タイマータスクより後のすべてのタスクが一時停止されます。このタスクは、インテグレーションの自動再開のみをサポートしています。インテグレーションの実行は、一時停止の期限を経過すると自動的に再開されます。たとえば、タイマータスクを 180 秒に設定すると、実行は 3 分間一時停止してから自動的に再開されます。

承認タスク、一時停止タスク、タイマータスクを比較する

3 つのタスク（承認、一時停止、タイマー）はすべてインテグレーションの一時停止と再開と同様の機能を実行します。ただし、それらにはわずかな違いがあります。次の表に、3 つのタスクの違いを示します。

承認タスク 一時停止タスク タイマータスク
インテグレーションの自動再開はサポートされていません。インテグレーションを再開するには手動での操作が必要です。 インテグレーションの手動再開と自動再開の両方をサポートしています。一時停止を取り消すための手動操作がない場合、インテグレーションは一時停止期限の経過後に実行を自動的に再開します。 インテグレーションの自動再開のみをサポートしています。インテグレーションの実行は、一時停止の期限を経過すると自動的に再開されます。
API 呼び出しではインテグレーションを再開できません。インテグレーション UI を使用して手動で一時停止を解決する必要があります。 インテグレーション用の Suspensions API を使用してインテグレーションを再開できます。 インテグレーションの自動再開のみをサポートしています。
インテグレーションが停止（一時停止）すると、ユーザーが通知を受け取ります。 インテグレーションが停止（一時停止）しても、ユーザーは通知を受け取りません。 インテグレーションが停止（一時停止）しても、ユーザーは通知を受け取りません。
出力変数（ブール値）がサポートされます。これにより、インテグレーションを再開する前に条件付きチェックを実行できます。ただし、出力変数の値は true または false のいずれかに限られます。 出力変数（文字列）がサポートされます。これにより、インテグレーションを再開する前に条件付きチェックを実行できます。出力変数には任意の値を設定できます。 出力変数はサポートしていません。

タイマータスクを構成する

タイマータスクを構成するには:

  1. Apigee UI で、Apigee 組織を選択します。
  2. [Develop] > [Integrations] の順にクリックします。
  3. 既存のインテグレーションを選択するか、[Create Integration] をクリックして新しいインテグレーションを作成します。

    新しいインテグレーションを作成する場合:

    1. [Create Integration] ダイアログで名前と説明を入力します。
    2. サポートされているリージョンのリストから、インテグレーションのリージョンを選択します。
    3. [Create] をクリックします。

    インテグレーション デザイナーでインテグレーションが開きます。

  4. インテグレーション デザイナーのナビゲーション バーで、[+ Add a task/trigger] > [Tasks] の順にクリックして、使用可能なタスクのリストを表示します。
  5. 統合エディタで [Timer] タスク要素をクリックして配置します。
  6. デザイナーの [Timer] タスク要素をクリックして、[Timer] タスク構成ペインを表示します。
  7. 残りのフィールドは、タスクの構成プロパティを使用して構成します。たとえば、[Timeout after] を 180 に設定し、[Time unit] を Seconds に設定すると、実行は 3 分間一時停止してから自動的に再開されます。
  8. プロパティへの変更は自動的に保存されます。

構成プロパティ

次の表では、Timer タスクの構成プロパティを示します。

プロパティ データ型 説明
Timeout after 整数

統合の実行を一時停止しておく時間。統合は、制限時間が経過すると、次の下流のタスクの実行を自動で再開します。

デフォルト値: 120 秒（2 分）。

最大制限時間: 44,640 分（31 日）。
Time unit 秒、分、時、日 [Timeout after] プロパティの時間単位。

エラー処理方式

タスクのエラー処理方法では、一時的なエラーによってタスクが失敗した場合のアクションを指定します。エラー処理方式と、さまざまな種類のエラー処理方式の詳細については、エラー処理方法をご覧ください。