PUT Bucket Website 名称 描述 是否必须 WebsiteConfiguration 请求的容器。 类型:容器。 子节点:IndexDocument、ErrorDocument、RoutingRules或RedirectAllRequestsTo。 注意 IndexDocument和RedirectAllRequestsTo互斥。如果填写了RedirectAllRequestsTo,则IndexDocument、ErrorDocument、RoutingRules都不能填写。 是 IndexDocument Suffix元素的容器。 注意:如果未填写RedirectAllRequestsTo,则IndexDocument必填。 类型:容器。 父节点:WebsiteConfiguration。 子节点:Suffix。 否 Suffix 在请求website endpoint上的路径时,Suffix会被加在请求的后面。例如,如果suffix是Index.html,而你请求的是bucket/images/,那么返回的响应是名为images/index.html的Object。 类型:字符串。 父节点:IndexDocument。 是 ErrorDocument Key的容器。 类型:容器。 父节点:WebsiteConfiguration。 子节点:Key。 否 Key 如果出现4XX错误,会返回指定的Object。 类型:字符串。 有效值:长度为1~1024的字符串。 父节点:ErrorDocument。 是 RoutingRules 托管模式配置到当前Bucket的重定向规则容器。 注意 如果RoutingRules下有多个RoutingRule,各RoutingRule之间无影响,按照配置的先后顺序向下执行,当有一个满足条件时,就不再继续向后匹配。如果都没有匹配,就不使用重定向规则。 类型:容器。 父节点:WebsiteConfiguration。 子节点:RoutingRule。 否 RoutingRule 重定向规则的容器。一条重定向规则包含一个Condition和一个Redirect,当Condition匹配时,Redirect生效。容器中至少要有一个重定向规则。 注意 一个RoutingRule下,出现多个Condition和Redirect时,以最后一个为准。 类型:容器。 父节点:RoutingRules。 子节点:Condition、Redirect。 是 Condition 描述重定向规则匹配的条件的容器。如果重定向规则匹配的条件未配置,则重定向规则将应用于所有请求。 注意 该容器可以不配置,如果配置,则至少应该包含HttpErrorCodeReturnedEquals、KeyPrefixEquals中的一个。 类型:容器。 父节点:RoutingRule。 子节点:HttpErrorCodeReturnedEquals、KeyPrefixEquals。 否 HttpErrorCodeReturnedEquals 指定Redirect生效时的HTTP错误码。当发生错误时,如果错误码等于这个值,那么Redirect生效。 注意 ErrorCodeReturnedEquals和KeyPrefixEquals同时存在时,只有都匹配时,Redirect才生效。 类型:字符串。 有效值:[ 400, 417 ],[ 500, 505]。 例如:当返回的http错误码为404时重定向到NotFound.html,可以将Condition中的HttpErrorCodeReturnedEquals设置为404,Redirect中的ReplaceKeyWith设置为NotFound.html。 父节点:Condition。 否 KeyPrefixEquals 重定向规则生效时的文件名的前缀。 注意 HttpErrorCodeReturnedEquals 和KeyPrefixEquals同时存在时,只有都匹配时,Redirect才生效。 类型:字符串。 取值:长度为01024的字符串。 父节点:Condition。 否 Redirect 重定信息容器。 注意 Redirect配置包含的元素可以为空,也可以包含以下元素:Protocol、HostName、ReplaceKeyPrefixWith、ReplaceKeyWith。当某一元素存在多条值时以最后一条为准。 类型:容器。 父节点:RoutingRule。 子节点:Protocol、HostName、ReplaceKeyPrefixWith、ReplaceKeyWith。 是 Protocol 重定向请求时使用的协议。 类型:字符串。 有效值:http、https,默认值为http。 父节点:Redirect或者RedirectAllRequestsTo。 否 HostName 重定向请求时使用的站点名。 如果父节点为RedirectAllRequestsTo,此项必须填写。 类型:字符串。 有效值:1~1024个字符,不能包含空格。父节点为Redirect,也不能包含斜杠(/)。 父节点:Redirect或者RedirectAllRequestsTo。 否 ReplaceKeyPrefixWith 重定向请求时使用的文件名前缀。 注意 ReplaceKeyPrefixWith与ReplaceKeyWith不能同时存在。 类型:字符串。 有效值:0~1024个字符。 父节点:Redirect。 否 ReplaceKeyWith 指定重定向请求时使用的文件名。 注意 ReplaceKeyPrefixWith与ReplaceKeyWith不能同时存在。 类型:字符串。 有效值:0~1024个字符。 父节点:Redirect。 否 RedirectAllRequestsTo 托管模式为重定向请求的容器。 注意 如果未填写IndexDocument,则RedirectAllRequestsTo必填。如果填写了RedirectAllRequestsTo,则IndexDocument、ErrorDocument、RoutingRules都不能填写。 父节点:WebsiteConfiguration。 子节点:HostName、Protocol。 否