Simple Message Queue (formerly MNS):OSS イベント通知

シナリオ

• 他のユーザーに OSS バケットに対する操作の実行を承認し、これらの操作が発生したときに通知を受けたい場合は、イベント通知ルールを作成できます。

• イベント通知に基づいてデータを分析し、一定期間内に操作が何回発生したかを確認し、ビジネスの最近の動向を分析できます。また、E-MapReduce (EMR) など、分析のためにイベント通知を他のサービスにインポートすることもできます。

• イベント通知に基づいて、OSS リソースに対して実行される操作の QPS などのメトリックを監視できます。

イベント

メッセージ形式

OSS イベント通知のメッセージ内容は Base64 でエンコードされています。デコードされた内容は JSON 形式です。次のサンプルコードは、デコードされたメッセージ内容の例を示しています。

{
    "events":[
        {
            "eventName":"ObjectDownloaded:GetObject", // イベント名
            "eventSource":"acs:oss", // イベントソース
            "eventTime":"2016-07-01T11:17:30.000Z", // イベント発生時刻
            "eventVersion":"1.0", // イベントプロトコルバージョン
            "oss":{
                "bucket":{
                    "arn":"acs:oss:cn-shenzhen:123456789098****:event-notification-test-shenzhen", // バケットのARN
                    "name":"event-notification-test-shenzhen", // バケット名
                    "ownerIdentity":"123456789098****" // バケット作成者のID
                },
                "object":{
                    "deltaSize":0, // オブジェクトのサイズ変更
                    "eTag":"0CC175B9C0F1B6A831C399E26977****", // オブジェクトの内容
                    "key":"test", // オブジェクト名
                    "readFrom":0, // オブジェクト読み取り開始位置
                    "readTo":1, // オブジェクト読み取り終了位置
                    "size":1 // オブジェクトのサイズ
                },
                "ossSchemaVersion":"1.0", // OSSスキーマのバージョン
                "ruleId":"GetObjectRule" // イベントに一致するルールのID
            },
            "region":"cn-shenzhen", // バケットが存在するリージョン
            "requestParameters":{
                "sourceIPAddress":"140.205.XX.XX" // リクエストの送信元 IP アドレス
            },
            "responseElements":{
                "requestId":"5776514AF09A9E654242****" // リクエスト ID
            },
            "userIdentity":{
                "principalId":"123456789098****" // リクエスタの一意の ID（UID）
            },
            "xVars":{
                "x:callback-var1":"value1", // コールバックのカスタムパラメータ1
                "x:vallback-var2":"value2" // コールバックのカスタムパラメータ2
            }
        }
    ]
}

次の表は、メッセージ内容のパラメーターについて説明しています。

使用上の注意

• 新しいイベント通知ルールが有効になるまで約 10 分かかります。

• イベント通知ルールのトピックはシステムによって自動的に作成され、作成されたトピックに対して課金される場合があります。詳細については、「請求の概要」をご参照ください。

• イベント通知ルールを作成または削除できます。ただし、イベント通知ルールを変更することはできません。

（オプション）ステップ 1：キューを作成する

ダウンストリーム クライアントからメッセージを受信するためにキューをサブスクライブするには、キューを作成する必要があります。イベント通知ルールが作成された後にサブスクリプションを作成することもできます。

1. SMQ コンソール にログインします。

2. 左側のナビゲーション ウィンドウで、[キューモデル] > キュー を選択します。

3. 上部のナビゲーション バーで、リージョンを選択します。

4. キュー ページで、キューを作成 をクリックします。

5. キューを作成 パネルで、次のパラメーターを設定し、OK をクリックします。

   • 名前: キューの名前。

   • メッセージの最大長さ: キューに送信されるメッセージの最大長。

   • ロングポーリング期間: ReceiveMessage 操作が呼び出された後、ロングポーリング リクエストが保持される最大期間。

   • メッセージの可視性タイムアウト時間: キューからメッセージが受信された後、メッセージが非アクティブ状態のままになる期間。

   • メッセージの保持期間: メッセージがキューに存在する最大期間。指定された保持期間が過ぎると、メッセージが受信されたかどうかに関係なく、メッセージは削除されます。

   • メッセージ遅延時間: キューに送信されたすべてのメッセージが消費されるまでの期間。

   • ログ機能の有効化: ログ記録機能を有効にするかどうかを指定します。

   キューが作成されると、キュー ページに表示されます。

(オプション) ステップ 2: バケットを作成する

目的のバケットがすでに存在する場合は、このステップをスキップします。

1. OSS コンソール にログオンします。

2. 左側のナビゲーションウィンドウで、[バケット] をクリックします。

3. [バケット] ページで、[バケットの作成] をクリックします。

4. [バケットの作成] パネルで、次のパラメーターを設定し、[作成] をクリックします。

   • バケット名: バケットの名前。この例では、event-notification-test を使用します。

   • リージョン: バケットが存在するリージョン。リージョンは、キューが存在するリージョンと同じである必要があります。

   • パブリックアクセスをブロック: パブリックアクセスをブロックするかどうかを指定します。この例では、この機能は無効になっています。

   • ACL: バケットの権限を指定します。この例では、[パブリック読み取り/書き込み] が選択されています。

     説明

     その他のパラメーターにはデフォルト値を使用します。

手順

イベント通知ルールが作成されると、SMQ はルール用の Topic を自動的に作成し、指定されたエンドポイントを使用して Topic のサブスクリプションを作成します。SMQ コンソールで Topic とサブスクリプションを表示および管理できます。

1. [SMQ コンソール] にログオンします。

2. 左側のナビゲーションウィンドウで、[イベント通知] をクリックします。

3. 上部のナビゲーションバーで、リージョンを選択します。

4. OSS[イベント通知] ページの [ルールを作成] タブで、 をクリックします。

5. [ルールの作成 - OSS] パネルで、次のパラメーターを設定し、[OK] をクリックします。

   • 名前: ルールの名前を入力します。

   • イベントタイプ: 1 つ以上のイベントタイプを選択します。

   • 一致モード: ルールの一致モードを設定します。

     説明

     一致モードには、完全名、プレフィックス、サフィックス、およびプレフィックスとサフィックスがあります。 2 つの一致モードに共通部分を含めることはできません。 OSS リソースには、バケットとオブジェクトが含まれます。これらの名前はスラッシュ (/) で区切られます。例: movie/hello.avi。

     • 完全名: movie/hello.avi。

     • プレフィックス:

       • movie/hello は、movie バケット内でプレフィックスが hello のすべてのオブジェクトを示します。

       • movie/ は、movie バケット内のすべてのオブジェクトを示します。

       • mov は、プレフィックスが mov のバケット内のすべてのオブジェクトを示します。

     • サフィックス: avi は、すべてのバケット内でサフィックスが .avi のすべてのオブジェクトを示します。

     • プレフィックスとサフィックス: movie/ プレフィックスと .avi サフィックスの組み合わせは、movie バケット内でサフィックスが .avi のすべてのオブジェクトを示します。

   • 受信端末: ドロップダウンリストから [キュー] を選択し、手順 1 で作成したキューの名前を入力します。

ステップ 4: オブジェクトのアップロード

1. OSS コンソール にログインします。

2. 左側のナビゲーションウィンドウで、[バケット] をクリックします。

3. [バケット] ページで、管理する OSS バケットの名前をクリックして、[オブジェクト管理] ページに移動します。

4. オブジェクトリストの上にある [オブジェクトのアップロード] をクリックします。 >

5. 表示されたページで、パラメーターを設定し、[オブジェクトのアップロード] をクリックします。 パラメーターの詳細については、「Simple upload」トピックの Simple upload セクションをご参照ください。

   タスクリストパネルが表示されます。[アップロードタスク] タブに、オブジェクトの状態が「アップロード済み」と表示されます。

ステップ 5: メッセージを受信する

1. SMQ コンソール にログインします。

2. 左側のナビゲーションウィンドウで、[キューモデル] > キュー を選択します。

3. 上部のナビゲーションバーで、リージョンを選択します。

4. キュー ページで、管理するキューを見つけ、アクション 列で [詳細] > メッセージを送信を選択します。

5. [メッセージの受信] セクションの [クイック エクスペリエンス] ページで、[メッセージの受信] をクリックします。

   [メッセージの受信] セクションにメッセージのリストが表示されます。

6. メッセージリストで、表示するメッセージを見つけ、詳細[アクション] 列の詳細をクリックします。 ダイアログボックスで、メッセージの内容を表示します。