Notification Description

このセクションでは、アップロードトークンにpersistentOps指令を含めた場合などのファイルアップロード前処理タスクにおける通知メカニズムの概要について説明します。

通知セキュリティメカニズム

オブジェクトストレージは、通知リクエストのヘッダーにAuthorizationフィールドを追加します。

フォーマット

<Accesskey>:<Urlsafe_Base64_Encode(hmac_sha1(NotifyUrl+"\n"+Response,SecretKey))>

注意：

1. Responseは受信した通知内容です。
2. オブジェクトストレージは、ユーザー配下の有効なAKとSKのセットからランダムに選択してauthenticationヘッダーのAuthorization値を生成します。認証処理の際には、全てのAKとSKのセットを記録し、いずれか正しく組み合ったキー文字列でヘッダー認証を行ってください。

通知データの説明

通知アドレスNotifyUrlを設定後、このアドレスには URL-Safe Base64 Encoded のJSON形式メッセージが送信されます。本メッセージは永続処理結果そのものとなります。
注意：アップロード前処理結果の通知受信アドレスは、HTTP/1.1 200 OKで正常に応答可能なパブリックネットワーク上のURLアドレスである必要があります。スペースなどの特殊文字を含む場合、URLエンコードが必要です。

フォーマット:

{
    "id": "<id string>",
    "code": "<code int>",
    "desc": "<desc string>",
    "separate":"<separate int>",
    "inputkey":"<inputkey string>",
    "inputbucket":"<inputbucket string>",
    "inputfsize":"<inputfsize int>",
    "items": [
        {
            "cmd": "<cmd string>",
            "code": "<code string>",
            "costTime": "<costTime int>",
            "desc": "<desc string>",
            "error": "<error string>",
            "fsize": "<fsize int>",
            "hash": "<hash string>",
            "key": "<key string>",
            "url": "<url string>",
            "duration": "<duration double>",
            "bit_rate": "<bit_rate string>",
            "resolution": "<resolution string>",
            "detail": [
                {
                    "fsize": "<fsize int>",
                    "hash": "<hash string>",
                    "key": "<key string>",
                    "url": "<url string>",
                    "duration": "<duration double>",
                    "bit_rate": "<bit_rate string>",
                    "resolution": "<resolution string>"
                }
            ]
        }
    ]
}

フィールド対応説明：

例:

{
    "id":"2c90802745ee87870145ef1430f90006",
    "code":3,
    "desc": "operate [\"avthumb/flv\"] is finish",
    "separate":0,
    "inputkey":"aaa.flv",
    "inputbucket":"chenqltesttwo",
    "inputfsize":20000,
    "items":[
        {
            "cmd":"avthumb/flv",
            "code":"3",
            "costTime": 0,
            "desc":"finish",
            "error":null,
            "fsize":20000,
            "hash":"FlWvHsc-CK6miygKCcLjCaQ5csNO",
            "key":"chenqltesttwo:aaa.flv",
            "url":"http://chenqltesttwo.com/aaa.flv",
            "duration": 198.083,
            "bit_rate": "1288025",
            "resolution": "1280X720",
            "detail": [
                {
                    "fsize": 20000,
                    "hash": "FlWvHsc-CK6miygKCcLjCaQ5csNO",
                    "key": "chenqltesttwo:aaa.flv",
                    "url": "http://chenqltesttwo.com/aaa.flv",
                    "duration": 198.083,
                    "bit_rate": "1288025",
                    "resolution": "1280X720"
                }
            ]
        }
    ]
}