イベントの開始

既存のユーザー、グループ、コンパートメントを使用することも、新規に作成することもできます。

テナンシ管理者として、ユーザーがイベントの使用を開始して自動化を作成する前に、IAMポリシーを作成する必要があります:

適切な通知トピックが存在しない場合は、テナンシ管理者としてコンソールにログインしてこれを作成する必要があります。既存のトピックを使用する場合も新しいトピックを作成する場合も、通知のためにその電子メール・アカウントをモニターできるように、サブスクリプションとして電子メール・アドレスを追加します。

1. ナビゲーション・メニューを開き、「監視および管理」をクリックします。「イベント・サービス」で、「ルール」をクリックします。
2. 作業の権限があるコンパートメントを選択し、「ルールの作成」をクリックします。

   イベントは、このコンパートメントに作成したルールと、このコンパートメントおよび子コンパートメントのリソースから発行されたイベント・メッセージを比較します。

3. 次のように入力します。
   • 表示名: ルールのわかりやすい名前を指定します。この名前は後で変更できます。機密情報の入力は避けてください。
   • 説明: ルールの機能に関する説明を指定します。この説明は後で変更できます。
4. 「条件」で、「イベント・タイプ」を選択します。
   1. 「サービス名」で、「オブジェクト・ストレージ」を選択します。
   2. 「イベント・タイプ」で、「バケット」-「作成」を選択します。
5. 「アクション」で、フィルタが一致を検出したときにトリガーするアクションを指定します:
   1. 「アクション・タイプ」で、「通知」を選択します。
   2. 「通知コンパートメント」で、トピックを含むコンパートメントを選択します。
   3. 「トピック」で、トピックを選択します。
6. 「ルールの作成」をクリックします。

• 前の手順で指定した電子メール・アカウントにログインし、作成されるバケットについての通知を受信します。

  
  ヒント
  
  ルールを無効化するまで、バケットがコンパートメント(またはそのサブ・コンパートメント)に作成されるたびに通知を受け取ります。

1. ファイルを作成し、次の内容を追加します。

   {
     "actions": [
         {
           "actionType": "ONS",
           "description": "string",
           "isEnabled": true,
           "topicId": "<topic_OCID>"
         }
     ]
   }

   ヒント: ファンクション、ストリームまたはトピックをアクションとして指定できます。

   アクション・ファイル・テンプレートの例

   {
     "actions": [
         {
           "actionType": "FAAS",
           "description": "string",
           "functionId": "<function_OCID>",
           "isEnabled": true
         },
         {
           "actionType": "ONS",
           "description": "string",
           "isEnabled": true,
           "topicId": "<topic_OCID>"
         },
         {
           "actionType": "OSS",
           "description": "string",
           "isEnabled": true,
           "streamId": "<stream_OCID>"
         }
     ]
   }

2. テナンシの実際のトピックOCID値を<topic_OCID>に入力します。
3. 説明を追加します。
4. ファイル名としてaction.jsonを付けてファイルを保存します。

コマンド・プロンプトを開き、oci events rule createを実行してルールを作成します。

次のオプションを使用します:

• display-nameは、コンソールでルールの名前を示します。
• is-enabledは、ルールが評価されるかどうかを示します。

• conditionイベントの一致のパターンを示すために使用されるJSON形式の文字列(使用方法は次のコマンド例を参照)。

• compartment-idは、ルールが適用されるコンパートメントを示します。イベントは、このコンパートメントおよび子コンパートメント内のリソースからのメッセージを評価します。
• actionsは、ルールに対するアクションを指定するために作成したJSON形式ファイルのローカル・ファイル・システムでのロケーションを示します。
• ACTIVEで使用した場合のwait-for-state=は、CLIでサービスがルールを作成するのを待機して、別のGET操作を実行してから、アクティブ状態のルールを表示することを示します。このオプションを選択しない場合、CLIでは作成中のルールがただちに表示されます。

例: 

oci events rule create --display-name CLI-created_rule --is-enabled true --condition "{\"eventType\":[\"com.oraclecloud.objectstorage.createbucket\"]}" --compartment-id <compartment_OCID> --actions <path_to_json_formatted_actions_file> --wait-for-state=ACTIVE

前述のコマンドを実行すると、ルールとその表示に関するCLIプロンプトが表示されます:

 Action completed. Waiting until the resource has entered state: ACTIVE
{
  "data": {
    "actions": {
      "actions": [
        {
          "action-type": "ONS",
          "description": "Notifications action",
          "id": "ocid1.eventaction.oc1.phx.<unique_ID>",
          "lifecycle-message": null,
          "lifecycle-state": "ACTIVE",
          "topic-id": "ocid1.onstopic.oc1.phx.<unique_ID>"
        }
      ]
    },
    "compartment-id": "ocid1.compartment.oc1..<unique_ID>",
    "condition": "{\"eventType\":[\"com.oraclecloud.objectstorage.createbucket\"]}",
    "defined-tags": {},
    "description": null,
    "display-name": "CLI-created_rule",
    "freeform-tags": {},
    "id": "ocid1.eventrule.oc1.phx.<unique_ID>",
    "is-enabled": true,
    "lifecycle-message": null,
    "lifecycle-state": "ACTIVE",
    "time-created": "2019-04-25T01:32:56.855000+00:00"
  },
  "etag": "<unique_ID>--gzip"
}

• 前の手順で指定した電子メール・アカウントにログインし、作成されるバケットについての通知を受信します。

  ヒント
  
  ルールを無効化するまで、バケットがコンパートメント(またはそのサブ・コンパートメント)に作成されるたびに通知を受け取ります。