You need to enable JavaScript to run this app.
导航
公共参数
最近更新时间:2025.09.24 17:00:28首次发布时间:2023.12.27 17:57:10
复制全文
我的收藏
有用
有用
无用
无用

所有接口请求中都必须携带公共参数,为了避免重复说明,本文中不再重复描述这部分参数,请您在请求 API 时携带这部分参数,否则请求将无法通过合法性验证。

Action&Version

Action和Version必须放在query当中。

名称

类型

是否必填

参数格式

描述

Action

String

[a-zA-Z]+

接口的名字,与具体的接口相关,表示要执行的操作。

Version

String

YYYY-MM-DD

接口的版本信息,当前版本为2020-04-01。

X-Expires

Int

300

签名的有效时间,单位秒,默认不填是900秒。

签名参数

签名参数是请求必不可少的部分,可以在header或query中。

在Header中的场景

名称

类型

是否必填

描述

X-Date

String

20201103T104027Z, 使用UTC时间,精确到秒。

Authorization

String

HMAC-SHA256 Credential={AccessKey}/{ShortDate}/{Region}/{Service}/request, SignedHeaders={SignedHeaders}, Signature={Signature}

Authorization中的信息含义如下:

名称

类型

备注

AccessKey

String

请求的AK。

ShortDate

String

请求的短时间,精确到日。使用UTC时间,例如:20180201。

Region

String

请求的Region,例如:华北2(北京):cn-beijing。
更多Region信息请参见地域与可用区介绍。

Service

String

请求的服务。- 调用实例、镜像和批量作业API时为:ecs

  • 调用云盘和快照API时为:storage_ebs

SignedHeaders

String

参与签名的Header,用分号分隔。

Signature

String

计算完毕的签名,签名计算方式见签名方法

在Query中的场景

X-Date与Authorization的信息可以直接存在在Query当中。

名称

类型

是否必填

描述

X-Date

String

20201103T104027Z, 使用UTC时间,精确到秒。

X-Algorithm

String

固定值, HMAC-SHA256;为将来扩展做准备。

X-Credential

String

由{AccessKey}/{ShortDate}/{Region}/{Service}/request组成。

X-SignedHeaders

String

参与签名的,用分号分隔。

X-Signature

String

计算完毕的签名,签名计算方式见签名方法