基本概念

Recipe を使う前に、Foundry での Recipe の作成と使用に関わる基本概念である、有効期限、実行履歴、権限について理解しておくことを推奨します。

有効期限

Recipe が動作を継続するには、計算リソースが必要です。使われていない Recipe がリソースを消費しないように、Recipe には有効期限を設定する必要があります。有効期限が切れても、Recipe は削除されません。有効期限が切れた Recipe は、対象の条件の監視を継続しなくなるだけです。そのため、その Recipe の通知の受信者全員に通知が届かなくなります。有効期限が切れる前に、作成者には何度か通知が送られます。実行を継続したい場合は、いつでも有効期限を延長できます。延長を忘れて Recipe の有効期限が切れた場合でも、Recipe を再開して有効期限を延長できます。

Recipe の有効期限の変更について詳しくはこちら。

実行履歴

設定したスケジュールに基づいて、Recipe は時間ベースのスケジュール（たとえば、3時間ごとや毎週月曜日の午前9時）またはイベントベースのスケジュール（データセットが更新されたときや、新しいオブジェクトが検出されたとき）で実行されます。

Recipe が実行されるたびに、実行履歴には次のいずれかの実行ステータスが記録されます。

• 例外を出して成功： Recipe は正常に実行され、リソースへのアクセス権があり、Recipe をミュートしていないすべての受信者に通知が送られました。このステータスは、一部の受信者にリソースへのアクセス権がなく、通知が届かなかった場合に発生することがあります。レポートの Recipe の場合、一部の受信者向けのレポートのエクスポートに失敗し、代わりにリンクが送られた場合にも、例外を出して成功となることがあります。Recipe の権限とセキュリティについては、以下で詳しく説明します。
• 成功： Recipe は正常に実行され、Recipe をミュートしていない全ユーザーに通知が送られました。
• スキップ： Recipe は正常にトリガーされましたが、通知は送られませんでした。これは、すべての受信者が Recipe をミュートしていた場合、または確認していた条件が true ではなかった場合に発生することがあります。
• 失敗： Recipe は正常に実行されず、実行中にエラーが発生しました。この実行の Recipe 履歴を展開すると、エラーの詳細を確認できます。

作成者には、失敗および例外を出して成功の場合に通知が送られます。通知設定の構成について詳しくはこちら。

プライバシー、権限、共有

Recipe は、監視対象のリソースから権限を継承します。つまり、リソースを閲覧できるユーザーは Recipe を閲覧でき、リソースの所有者は Recipe を編集できるなど、リソースの権限に応じた操作ができます。

Recipe はメールで他のユーザーにデータを送信できますが、権限によって、実際にメールでデータを受信できるのは、そのデータへのアクセス権を持つユーザーのみに制限されます。

権限の概要

定義

• 作成者/所有者： Recipe を作成したユーザーです。
• 受信者： Recipe によってトリガーされたメール/通知の受信者です。
• 監視対象リソース： Recipe が対象の変更を監視している実際のファイル（データセット、レポート、Quiver 分析など）です。

次のテーブルは、Recipe で特定の操作を行うためにユーザーに必要な権限を示しています。

受信者にレポートへのアクセス権がなくても、通知は届きます。ただし、レポートへのリンクが送られ、そのリンクからアクセス権のリクエストに進むことになります。