PUT Bucket Origin

PUT /?origin HTTP 1.1
Host:<BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String

<OriginConfiguration>
    <OriginRule>
        <RulePriority>Integer</RulePriority>
        <OriginType>Redirect|Proxy|Mirror</OriginType>
        <OriginCondition>
            <!--回源设置的 HTTP 状态码设置根据回源类型决定，如果是 Proxy、Mirror 是404，如果是 Redirect 是4XX 或5XX 的任意状态码-->
            <HTTPStatusCode>404</HTTPStatusCode>
            <!--支持前缀筛选-->
            <Prefix></Prefix>
            <!--支持后缀筛选-->
            <Suffix></Suffix>
            <FilterHost>
                <!--屏蔽指定域名的回源。-->
                <ForbidHost>
                    <DomainList>
                        <Domain>bucket-appid.region.myqcloud.com</Domain>
                        <Domain>mydomain.myqcloud.com</Domain>
                    </DomainList>
                </ForbidHost>
            </FilterHost>
        </OriginCondition>
        <OriginParameter>
            <Protocol>HTTP|HTTPS|FOLLOW</Protocol>
            <!--回源是否保留源站的错误码-->
            <TransparentErrorCode>true|false</TransparentErrorCode>
            <!--回源是否保留原始查询参数，支持保留、不保留两种-->
            <FollowQueryString>true|false</FollowQueryString>
            <!--回源的请求头部参数-->
            <HttpHeader>
                <!--回源是否传输全部的请求头部，支持传递、不传递两种-->
                <FollowAllHeaders>true|false</FollowAllHeaders>
                <!--回源新增指定头部，最多10个，自定义头部中一对键值算一个-->
                <!--如果有值则新增头部，如果为空则不新增-->
                <NewHttpHeaders>
                    <Header>
                        <Key>x-cos|oss|amz-ContentType|CacheControl|ContentDisposition|ContentEncoding|HttpExpiresDate|UserMetaData</Key>
                        <Value>string</Value>
                    </Header>
                </NewHttpHeaders>
                <!--回源透传原始请求的指定头部-->
                <FollowHttpHeaders>
                    <Header>
                        <Key>x-cos|oss|amz-ContentType|CacheControl|ContentDisposition|ContentEncoding|HttpExpiresDate|UserMetaData</Key>
                    </Header>
                </FollowHttpHeaders>
                <!--回源不透传原始请求的指定头部-->
                <ForbidFollowHttpHeaders>
                    <Header>
                        <Key>String</Key>
                    </Header>
                </ForbidFollowHttpHeaders>
            </HttpHeader>
            <!--follow3xx 参数-->
            <FollowRedirection>true|false</FollowRedirection>
            <!--选择 follow3xx 后，选择是否透传回源头部，默认为 false 不透传。-->
            <FollowRedirectionConfiguration>
                <FollowOriginHeaders>true|false</FollowOriginHeaders>
            </FollowRedirectionConfiguration>
            <!--重定向返回码参数只有在回源类型为 Redirect、Proxy 时可选，否则报参数错误-->
            <HttpRedirectCode>301|302|307</HttpRedirectCode>
        </OriginParameter>
        <!--切备错误码，默认5XX 切换备站，添加此选项后支持4XX 切换备站  -->
        <HTTPStandbyCode>
            <StatusCode>404</StatusCode>
            <StatusCode>403</StatusCode>
        </HTTPStandbyCode>
        <!--404错误码缓存。设置此选项后，将对404错误码进行缓存，1分钟内不会去源站重复拉取url的数据。CacheErrorCode和TransparentErrorCode不支持同时设置。-->
        <CacheErrorCode>404</CacheErrorCode>
        <OriginInfo>
            <!--Mirror 模式支持设置多个源站，按比例回源，分担单个源站的回源流量，最多支持填入10条回源地址，比例按权重分配；Proxy 和 Redirect 仅支持一个源站-->
            <HostInfo>
                <HostName>bucketname-appid.cos.region.myqcloud.com</HostName>
                <!--源站权重，按比例回源-->
                <Weight>4</Weight>
                <!--备份回源地址，最多支持填入10条备份回源地址，节点命名依次按照1-10编号-->
                <StandbyHostName_1>bucketname2-appid.cos.region.myqcloud.com</StandbyHostName_1>
                <StandbyHostName_2>bucketname3-appid.cos.region.myqcloud.com</StandbyHostName_2>
            </HostInfo>
            <HostInfo>
                <HostName>bucketname4-appid.cos.region.myqcloud.com</HostName>
                <!--源站权重，按比例回源-->
                <Weight>2</Weight>
                <!--备份回源地址，最多支持填入10条备份回源地址，节点命名依次按照1-10编号-->
                <StandbyHostName_1>bucketname5-appid.cos.region.myqcloud.com</StandbyHostName_1>
                <StandbyHostName_2>bucketname6-appid.cos.region.myqcloud.com</StandbyHostName_2>
            </HostInfo>
            <FileInfo>
                <!--回源为指定的文件-->
                <FixedFileConfiguration>
                    <FixedFilePath>String</FixedFilePath>
                </FixedFileConfiguration>
                <PrefixConfiguration>
                    <!--回源文件的新增文件前缀-->
                    <Prefix></Prefix>
                    <!--回源文件前缀替换。仅支持 Redirect 模式，已使用前缀筛选（OriginCondition.Prefix）的情况下，可根据ReplacedWithPrefix，将筛选字符串替换掉。-->
                    <ReplacedWithPrefix></ReplacedWithPrefix>
                </PrefixConfiguration>
                <SuffixConfiguration>
                    <!--回源文件的新增文件后缀-->
                    <Suffix></Suffix>
                    <!--回源文件后缀替。仅支持 Redirect 模式，已使用前缀筛选（OriginCondition.Prefix）的情况下，可根据ReplacedWithSuffix，将筛选字符串替换掉。-->
                    <ReplacedWithSuffix></ReplacedWithSuffix>
                </SuffixConfiguration>
            </FileInfo>
        </OriginInfo>
    </OriginRule>
</OriginConfiguration>