You need to enable JavaScript to run this app.
导航
镜像仓库
  • 文档首页
    • /
  • 镜像仓库

公共参数

最近更新时间：2022.09.08 15:20:36

首次发布时间：2021.11.18 18:17:38

我的收藏

公共请求参数是每个接口都需要使用的请求参数，开发者每次使用火山引擎 OpenAPI 发送请求时都需要携带这些公共请求参数，否则会导致请求失败。公共请求参数首字母均为大写，以此区分其他请求参数。

Action 和 Version

注意

Action 和 Version 必须放在 Query 当中。

名称类型是否必填参数格式描述
ActionString是[a-zA-Z]+接口的名字，与具体的接口相关。
VersionString是YYYY-MM-DD接口的版本信息，与具体的接口相关。
X-ExpiresInt否300签名的有效时间，单位为秒，默认不填是 900 秒。

签名参数

说明

签名参数是请求必不可少的部分，可以放在 Header 或 Query 中。

在 Header 中的场景

名称类型是否必填描述
X-DateString是使用 UTC 时间，精确到秒。请使用格式：YYYYMMDD'T'HHMMSS'Z'，例如：20201103T104027Z。
AuthorizationString是用于验证请求合法性的认证信息。格式为：HMAC-SHA256 Credential={AccessKey}/{ShortDate}/{Region}/{Service}/request, SignedHeaders={SignedHeaders}, Signature={Signature}。

Authorization 中的信息含义：

名称类型备注
AccessKeyString请求的 Access Key ID。
ShortDateString请求的短时间，精确到日。使用 UTC 时间，例如：20180201。
RegionString请求的 Region，例如：华北2（北京）：cn-beijing

更多 Region 信息请参见 开服地域。

ServiceNameString请求的服务，调用镜像仓库 API 时为：cr。
SignedHeadersString参与签名的 Header，用分号（;）分隔。
SignatureString计算完毕的签名。签名计算方式，请参见 签名机制。

在 Query 中的场景

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

默认 CPU 请求类型是否必填描述
X-DateString是使用 UTC 时间，精确到秒，例如：20201103T104027Z。
X-AlgorithmString是固定值HMAC-SHA256；为将来扩展做准备。
X-CredentialString是由{AccessKey}/{ShortDate}/{Region}/{Service}/request组成。
X-SignedHeadersString是参与签名的 Header，用分号（;）分隔。
X-SignatureString是计算完毕的签名。签名计算方式，请参见 签名机制。