图引擎服务 GES-管理面API构造请求:请求消息头

时间:2024-04-29 11:34:09

请求消息头

附加请求消息头字段,如指定的URI和HTTP方法所要求的字段。例如,定义消息体类型的请求消息头“Content-Type”,请求鉴权信息等。

如下公共消息头需要添加到请求中。

表1 公共请求头

参数

是否必选

说明

示例

Content-Type

消息体的类型(格式),默认取值为“application/json”,有其他取值时会在具体接口中专门说明。

application/json

X-Auth-Token

使用Token方式认证时必选

用户Token。例如,IAM用户Token也就是调用获取用户Token接口的响应值,该接口是唯一不需要认证的接口。

-

X-Project-ID

子项目ID。在多项目场景中使用,用于不同项目获取token。

e9993fc787d94b6c886cbaa340f9c0f4

Authorization

使用AK/SK认证时必选。

签名认证信息。该值来源于请求签名结果。

-

X-Sdk-Date

使用AK/SK认证时必选。

请求的发生时间,格式为(YYYYMMDD'T'HHMMSS'Z')。

取值为当前系统的GMT时间。

20150907T101459Z

Host

使用AK/SK认证时必选。

请求的服务器信息,从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口,https的默认端口为443。

code.test.com

or

code.test.com:443

Content-Length

POST/PUT请求必填。 GET不能包含。

请求body长度,单位为Byte。

3495

X-Language

请求语言。支持配置如下值:

  • zh-cn:中文
  • en-us:英文

en-us

华为云API同时支持使用AK/SK认证,AK/SK认证是使用SDK对请求进行签名,签名过程会自动往请求中添加Authorization(签名认证信息)和X-Sdk-Date(请求发送的时间)请求头。

AK/SK认证的详细说明请参考AK/SK认证

例如,对于IAM获取用户Token接口,由于不需要认证,所以只添加“Content-Type”即可,添加消息头后的请求如下所示。

POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens
  Content-Type: application/json
support.huaweicloud.com/api-ges/ges_03_0004.html