内容分发网络CDN

    设置HttpHeader

    本接口用于指定加速域名添加或者删除http header。此域名必须是本用户的,否则会返回403失败。

    注意:此接口为全量接口,设置时需要将已有的Header设置也要一并写入,否则原有配置会被覆盖。

    Method Path 说明
    PUT /v2/domain/{domain}/config?httpHeader 修改或删除加速域名对应的回源Header或响应Header

    请求体(Request Body)

    参数 可选 类型 说明
    httpHeader 必选 HttpHeader 设置的回源或响应Header

    HttpHeader结构如下:

    参数 可选 类型 说明
    type 必选 String "origin"表示此header 回源生效,"response"表示给用户响应时生效
    header 必选 String header为http头字段,一般为HTTP的标准Header,也可以是用户自定义的;如x-bce-authoriztion
    value 必选 String 指定Header的值
    action 可选 String 表示是删除还是添加,可选remove/add,默认是add;目前console只支持add action; API做后端remove配置的兼容
    describe 可选 String 描述,可选,可以是中文,统一使用Unicode统码;长度不能超过100个字符

    说明:
    add origin header: 回源时在用户的请求中自动加上指定的http header
    remove origin header: 回源时从用户的请求中自动删除指定的http header
    add response header: 响应用户的请求时自动加上指定的http header
    remove response header: 响应用户的请求时自动删除指定的http header

    响应码 (Http Status Code)

    Http Status Code 说明
    200 成功

    响应体 (Response Body)

    参数 类型 说明
    status String 因更新动作是异步调用,故成功后返回的status是OPERATING,目标状态为RUNNING

    请求示例

    PUT /v2/domain/myself.baidu.com/config?httpHeader HTTP/1.1
    Host: myself.baidu.com
    Content-Length: 145
    Content-Type: application/json
     
    {
        "httpHeader":
        [
            {"type": "origin", "header": "x-auth-cn", "value":"xxxxxxxxx", "action": "add"},
            {"type": "response", "header": "content-type", "value":"application/octet-stream", "action": "add"}
        ]
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Length: 31
    Content-Type: application/json;utf-8
    
    {
        "status": "OPERATING|RUNNING"
    }
    上一篇
    回源配置接口
    下一篇
    查询HttpHeader