2.4.3. S3 获取存储桶通知
获取特定的通知,或列出存储桶中配置的所有通知。
语法
Get /BUCKET?notification=NOTIFICATION_ID HTTP/1.1
Host: cname.domain.com
Date: date
Authorization: AWS ACCESS_KEY:HASH_OF_HEADER_AND_SECRET
示例
Get /testbucket?notification=testnotificationID HTTP/1.1
Host: cname.domain.com
Date: date
Authorization: AWS ACCESS_KEY:HASH_OF_HEADER_AND_SECRET
响应示例
<NotificationConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<TopicConfiguration>
<Id></Id>
<Topic></Topic>
<Event></Event>
<Filter>
<S3Key>
<FilterRule>
<Name></Name>
<Value></Value>
</FilterRule>
</S3Key>
<S3Metadata>
<FilterRule>
<Name></Name>
<Value></Value>
</FilterRule>
</S3Metadata>
<S3Tags>
<FilterRule>
<Name></Name>
<Value></Value>
</FilterRule>
</S3Tags>
</Filter>
</TopicConfiguration>
</NotificationConfiguration>
注意
notification 子资源返回存储桶通知配置或空 notification Configuration 元素。调用者必须是存储桶所有者。
请求实体
notification-id- 描述
- 通知的名称。如果未提供 ID,则会列出所有通知。
- Type
- 字符串
NotificationConfiguration- 描述
-
TopicConfiguration实体列表。 - Type
- Container
- 必需
- 是
TopicConfiguration- 描述
-
事件主题的
Id,Topic和list。 - Type
- Container
- 必需
- 是
id- 描述
- 通知的名称。
- Type
- 字符串
- 必需
- 是
Topic- 描述
Topic Amazon Resource Name(ARN)
注意必须事先创建主题。
- Type
- 字符串
- 必需
- 是
事件- 描述
- 处理的事件。可能存在多个事件实体。
- Type
- 字符串
- 必需
- 是
Filter- 描述
- 指定配置的过滤器。
- Type
- Container
- 必需
- 否
HTTP 响应
404- 状态代码
-
NoSuchBucket - 描述
- bucket 不存在。
404- 状态代码
-
NoSuchKey - 描述
- 如果提供了通知,则不会存在。