252 阿里云

公共请求头__API-Reference_日志服务-阿里云

LOG service API是基于HTTP协议的Rest风格接口。它支持一组可以在所有API请求中使用的公共请求头（除特别说明，每个LOG service API请求都必须提供这些公共请求头），其详细定义如下：

Header名称	类型	说明
Accept	字符串	客户端希望服务端返回的类型，目前支持application/json、application/x-protobuf两种，该字段为非必选参数，仅对GET请求有效,具体取值以各个接口定义为准
Accept-Encoding	字符串	客户端希望服务端返回的压缩算法，目前支持lz4, deflate, 或空（不压缩）,该字段为非必选参数，仅对GET类请求有效,具体取值以各个接口定义为准
Authorization	字符串	签名内容，更多细节请参考请求签名。
Content-Length	数值	RFC 2616中定义得HTTP请求Body长度。如果请求无Body部分，则不需要提供该请求头。
Content-MD5	字符串	请求Body经过MD5计算后的字符串，计算结果为大写。如果没有Body部分，则不需要提供该请求头。
Content-Type	字符串	RFC 2616中定义得HTTP请求Body类型。目前Log Service API请求只支持application/x-protobuf。如果没有Body部分，则不需要提供该请求头，具体取值以各个接口定义为准
Date	字符串	当前发送时刻的时间，参数目前只支持RFC 822格式，使用GMT标准时间。格式化字符串如下：%a, %d %b %Y %H:%M:%S GMT (如：Mon, 3 Jan 2010 08:33:47 GMT)。
Host	字符串	HTTP请求的完整HOST名字（不包括如“https://” 这样的协议头），例如：big-game.cn-hangzhou.sls.aliyuncs.com。
x-log-apiversion	字符串	API的版本号，当前版本为0.6.0。
x-log-bodyrawsize	数值	请求的Body原始大小。当无Body时该字段为0，当Body是压缩数据，则为压缩前的原始数据大小。该域取值范围为[0, 3x1024x1024]。该字段为非必选字段，只在压缩时需要。
x-log-compresstype	字符串	API请求中Body部分使用的压缩方式。目前支持“lz4”压缩类型，“deflate”压缩类型（RFC 1951，使用zlib格式，参考RFC 1950）,如果不压缩可以不提供该请求头。
x-log-date	字符串	当前发送时刻的时间，格式和Date头一致。该请求头为可选项。如果请求中包含该公共请求头，在它的值会取代Date标准头的值用于服务端请求验证。无论是否有x-log-date头，HTTP标准Date头都必须提供。
x-log-signaturemethod	字符串	签名计算方式，目前仅支持”hmac-sha1”。
x-acs-security-token	字符串	使用STS临时身份发送数据，当使用STS临时身份时必填，其他情况不要填写

说明

请求中Date所表示的时间与服务器接收到该请求的时间最大可接受误差为15分钟，如果超过15分钟服务器端会拒绝该请求。如果请求中设置了x-log-date头部，则该时间误差计算基于x-log-date头的值。
如果请求指明压缩算法（在x-log-compresstype中指定），则需要把原始数据压缩后放到HTTP Body部分，而对应的Content-Length、Content-MD5头部也是按照压缩后的Body部分计算。
由于某些平台上发送HTTP请求时无法指定Date头（由平台自身的库内部自动指定为发送当前时间），造成无法使用正确的Date值计算请求签名。在这种情况下，请指定x-log-date头并用该请求头的值参与请求签名计算。Log Service服务端在接受到API请求后会首先判断是否有x-log-date头，如果有则用它的值来做签名验证，否则就用HTTP的标准头Date做签名验证。

最后更新：2016-05-06 10:44:22

上一篇：访问秘钥__API-Reference_日志服务-阿里云

下一篇：公共响应头__API-Reference_日志服务-阿里云

相关内容

热门内容

最新内容