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 /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
Get /testbucket?notification=testnotificationID HTTP/1.1
Host: cname.domain.com
Date: date
Authorization: AWS ACCESS_KEY:HASH_OF_HEADER_AND_SECRET
响应示例
注意
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
- 描述
- 如果提供了通知,则不会存在。