赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 日志服务
  4. 开发参考
  5. API参考附录
  6. 公共请求头

公共请求头

  • API参考附录
  • 发布于 2025-04-22
  • 0 次阅读
文档编辑
文档编辑

本文列举了日志服务API的公共请求头信息。

参数列表

日志服务API是基于HTTP协议的REST风格接口。它支持一组可以在所有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类型。目前日志服务API请求只支持application/x-protobuf类型。如果没有Body部分,则不需要提供该请求头。具体取值以各个接口定义为准。
Date字符串是当前发送时刻的时间,参数目前只支持RFC 1123格式,使用GMT标准时间。格式化字符串如下:%a,%d%b%Y %H:%M:%S GMT (例如:Mon, 3 Jan 2010 08:33:47 GMT)。
Host字符串是HTTP请求的完整HOST名称(不包括如http://这样的协议头)。例如,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头并用该请求头的值参与请求签名计算。日志服务端在接收到API请求后会首先判断是否有x-log-date头。如果有,则用它的值来做签名验证,否则就用HTTP的标准头Date做签名验证。

示例

POST / HTTP/1.1
Authorization: LOG <yourAccessKeyId>:<yourSignature>
x-log-bodyrawsize: 0
User-Agent: sls-java-sdk-v-0.6.1
x-log-apiversion: 0.6.0
Host: my-project-test.cn-shanghai.log.aliyuncs.com
x-log-signaturemethod: hmac-sha1
Date: Sun, 27 May 2018 07:43:26 GMT
Content-Type: application/json
Content-MD5: A7967D81EFF5E3CD447FB6D8DF294E20
Content-Length: 80
Connection: Keep-Alive
相关文章

服务入口 2025-04-22 10:36

本文介绍日志服务不同网络类型的服务入口。 查看服务入口

访问密钥 2025-04-22 10:36

阿里云访问密钥(AccessKey)是调用API访问云资源的安全口令,您可以使用AccessKey签名API请求内容以通过服务端的安全验证。本文介绍如何获取AccessKey。 什么是AccessK

公共请求头 2025-04-22 10:36

本文列举了日志服务API的公共请求头信息。 参数列表 日志服务API是基于HTTP协议的REST风格接口。它支持一组可以

公共响应头 2025-04-22 10:36

本文列举了日志服务的API的公共响应头信息。 参数列表 Log Service API是基于HTTP协议的REST风格接口。

请求签名 2025-04-22 10:36

为保证用户日志数据的安全,日志服务API的所有HTTP请求都必须经过安全验证。验证流程基于阿里云的访问密钥安全验证,使用非对称加密算法完成。 使用说明

错误码 2025-04-22 10:36

在调用API接口过程中,若服务端返回结果中包含错误信息,则表示调用API接口失败。您可以根据本文错误码对照表查找对应的解决方法。 概述

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号