开发者社区 问答 正文

如何设置HTTP头信息?



描述


设置自定义http头

请求参数

参数名类型必填?说明
ActionString操作接口名,系统规定参数,取值:SetHttpHeaderConfig
DomainNameString您的加速域名
HeaderKeyString要设置HTTP头参数:取值:content-type、cache-control、content-disposition、content-language、expires、access-control-allow-origin、access-control-allow-methods、access-control-max-age
HeaderValueString要设置的HTTP头参数的取值


返回参数

名称类型描述
RequestIDString该条任务请求ID


特殊错误码

错误代码描述Http 状态码语义
InvalidHeaderKey.ValueNotSupportedThe specified value of parameter HeaderKey is not supported.400指定的 HeaderKey 不合法(超出可选范围)


示例


请求示例: http://cdn.aliyuncs.com/?Action=SetHttpHeaderConfig
&DomainName=www.macaron.org.cn
&HeaderKey=content-type
&headerValue=application
&<公共请求参数>


返回示例
JSON格式: {
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}


XML格式: <SetHttpHeaderConfigConfigResponse>
    <RequestId>AED00EC1-32A8-4D48-BEB9-BD782AF3C6BD</RequestId>
</SetHttpHeaderConfigResponse>

展开
收起
青衫无名 2017-10-24 10:49:57 2501 分享 版权
阿里云 AI 助理回答

您描述的是使用阿里云内容分发网络CDN(Content Delivery Network)服务时,设置自定义HTTP头的操作过程。通过这个功能,您可以针对特定的加速域名定制HTTP响应头,以实现对缓存策略、内容类型、跨域访问控制等多方面的细致管理。下面是对您提供信息的一个详细解析和补充说明:

操作目的

  • 自定义HTTP头:允许用户为CDN加速的资源设置特定的HTTP响应头,比如调整Cache-Control来改变缓存行为,或者设置Access-Control-Allow-Origin来支持跨域资源共享(CORS)。

请求参数详解

  1. Action: 必填参数,固定值SetHttpHeaderConfig,表示要执行的操作是设置HTTP头配置。
  2. DomainName: 必填参数,填写您的CDN加速域名,即您希望应用这些自定义HTTP头规则的域名。
  3. HeaderKey: 必填参数,指定要设置的HTTP头字段名称。可选范围包括但不限于:content-type, cache-control, content-disposition, content-language, expires, access-control-allow-origin, access-control-allow-methods, access-control-max-age等。
  4. HeaderValue: 必填参数,对应于HeaderKey所指定的HTTP头字段的具体值。

返回参数

  • RequestID: 该条任务请求的唯一标识ID,可用于后续查询操作状态或日志跟踪。

特殊错误码示例

  • InvalidHeaderKey.ValueNotSupported: 当提供的HeaderKey不在允许的范围内或格式不正确时,会返回此错误,HTTP状态码为400,意味着客户端请求有误。

示例请求

http://cdn.aliyuncs.com/
?Action=SetHttpHeaderConfig
&DomainName=your.cdn.domain.com
&HeaderKey=Cache-Control
&HeaderValue=max-age=3600

在这个示例中,我们为域名your.cdn.domain.com设置了一个名为Cache-Control的HTTP头,其值为max-age=3600,意在指示CDN边缘节点缓存该资源1小时。

注意事项

  • 在实际操作前,请确保您已登录阿里云账号,并拥有足够的权限来修改CDN配置。
  • 调用API时,可能需要进行身份验证,通常涉及AccessKeyId、AccessKeySecret及Signature等安全参数,具体请参考阿里云OpenAPI文档。
  • 根据不同的HTTP头设置,可能会对网站性能、安全性以及用户体验产生影响,请谨慎配置。
有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答