S3 获取存储区通知

在线编辑

获取特定通知或列出存储区上配置的所有通知。

语法

Get /_BUCKET_?notification=_NOTIFICATIONID 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 子资源返回存储区通知配置或空 NotificationConfiguration 元素。 调用者必须是存储区所有者。

请求实体

notification-id

描述

通知的名称。 如果未提供标识，那么将列出所有通知。

类型

字符串

NotificationConfiguration

描述

TopicConfiguration 实体的列表。

类型

容器

必需

是

TopicConfiguration

描述

事件实体的 Id， Topic和 list 。

类型

容器

必需

是

id

描述

通知的名称。

类型

字符串

必需

是

Topic

描述

主题 Amazon 资源名称 (ARN)

注: 必须事先创建主题。

类型

字符串

必需

是

Event

描述

已处理事件。 可能存在多个事件实体。

类型

字符串

必需

是

Filter

描述

指定配置的过滤器。

类型

容器

必需

False

HTTP 响应

404

状态代码

NoSuchBucket

描述

存储区不存在。

404

状态代码

NoSuchKey

描述

如果已提供通知，那么该通知不存在。