工业数字模型驱动引擎-构造请求:请求消息头

时间:2025-02-12 14:56:15

请求消息头

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

详细的公共请求消息头字段请参见表3

表3 公共请求消息头

名称

描述

是否必选

示例

Host

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

当使用AK/SK认证时,该字段必选。

code.test.com

or

code.test.com:443

Content-Type

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

application/json

Content-Length

请求body长度,单位为Byte。

3495

Authorization

签名认证信息。

当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

-

X-Sdk-Date

请求发送的时间。

当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。

-

X-Project-ID

Project ID,项目编号。

如果是专属云场景采用AK/SK认证方式的接口请求或者多project场景采用AK/SK认证的接口请求,则该字段必选。

e9993fc787d**********aa340f9c0f4

X-Auth-Token

用户Token。

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

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

使用Token认证时该字段必选。

注:以下仅为Token示例片段。

MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

X-Domain-ID

账号ID。

AK/SK认证方式下,全局服务的接口调用时,需在请求消息头中携带X-Domain-ID。

-

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

AK/SK认证的详细说明请参见认证鉴权“AK/SK认证”

对于管理员创建 IAM 用户接口,使用AK/SK方式认证时,添加消息头后的请求如下所示。

POST https://iam.cn-north-4.myhuaweicloud.com/v3.0/OS-USER/users Content-Type: application/jsonX-Sdk-Date: 20240416T095341ZAuthorization: SDK-HMAC-SHA256 Access=****************, SignedHeaders=content-type;host;x-sdk-date, Signature=****************
support.huaweicloud.com/api-idme/idme_api_0004.html