Get Bucket Notification
更新时间:2024-12-10 11:03:08
PDF
该接口用于获取 Bucket 的事件通知及处理策略。QingStor 对象存储定义只有 Bucket 的所有者才能调用该 API。
请求语法
GET /?notification HTTP/1.1
Host: <bucket-name>.<zone_id>.qsstor.com
Date: <date>
Authorization: <authorization-string>
请求参数
无。
请求头
此接口仅包含公共请求头。关于公共请求头的更多信息,请参见公共请求头。
请求消息体
无。
响应头
此接口仅包含公共响应头。关于公共响应头的更多信息,请参见公共响应头。
响应消息体
成功调用该 API 后,会返回一个 Json 格式的 Response Body。该 Response Body 各参数段说明如下:
名称 | 类型 | 说明 | 是否必须 |
---|---|---|---|
notifications |
Array |
配置规则,配置项中的元素解释见下 |
是 |
id |
String |
配置的标识 |
是 |
event_types |
Array |
事件的类型,每当该类型的事件被触发时,发出通知。目前支持的类型为: |
是 |
object_filter |
String |
对象名匹配规则 |
是 |
cloudfunc |
String |
事件处理云服务,接收通知中触发的事件并进行处理。目前支持:
|
是 |
cloudfunc_args |
Object |
提供给 |
否 |
notify_url |
String |
通知事件处理结果的 URL,当事件处理完成后,会将处理结果以 POST 方式向 |
否 |
错误码
错误码 | 错误描述 | HTTP 状态码 |
---|---|---|
OK |
成功获取 Bucket 事情通知 |
200 |
其他错误码可参考错误码列表。
示例
请求示例
GET /?notification HTTP/1.1
Host: mybucket.pek3a.qsstor.com
Date: Sun, 16 Aug 2015 09:05:00 GMT
Authorization: authorization string
响应示例
HTTP/1.1 200 OK
Server: QingStor
Date: Sun, 16 Aug 2015 09:05:00 GMT
Content-Length: 125
Connection: close
x-qs-request-id: aa08cf7a43f611e5886952542e6ce14b
{
"notifications": [
{
"cloudfunc": "tupu-porn",
"event_types": [
"create_object"
],
"id": "notificaion-1",
"notify_url": "http://tupu_porn_notify_url"
}
]
}