You need to enable JavaScript to run this app.
导航
公共参数
最近更新时间:2023.11.15 22:39:28首次发布时间:2021.12.01 15:37:07

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

Action 和 Version

说明

Action 和 Version 必须在 Query 当中。

名称类型是否必填参数格式描述
ActionString[a-zA-Z]+接口的名字,与具体的接口相关,表示要执行的操作。
VersionStringYYYY-MM-DD接口的版本信息。根据您使用的接口版本,version 的值为 2022-01-01 或 2018-01-01。
X-ExpiresInt300签名的有效时间,单位秒,默认不填是 900 秒。

签名参数

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

  • 在 Header 中的场景

    名称类型是否必填描述
    X-DateString20201103T104027Z, 使用 UTC 时间,精确到秒。
    AuthorizationStringHMAC-SHA256 Credential={AccessKey}/{ShortDate}/{Region}/{Service}/request, SignedHeaders={SignedHeaders}, Signature={Signature}

    其中,Authorization 中的信息含义如下表。

    名称类型备注
    AccessKeyString请求的 AK。
    ShortDateString请求的短时间,精确到日。使用 UTC 时间,例如:20220101。
    RegionString请求的地域,例如:华北 2(北京):cn-beijing。
    ServiceNameString请求的服务,当前为 rds_postgresql。
    SignedHeadersString参与签名的 Header,用分号分隔。
    SignatureString计算完毕的签名。签名计算方式详情,请参见签名机制
    X-TT-LogidString请求的 ID,生成算法请保持一致性。
  • 在 Query 中的场景

    说明

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

    名称类型是否必填描述
    X-DateString20221103T104027Z, 使用 UTC 时间,精确到秒。
    X-AlgorithmString固定值, HMAC-SHA256;为将来扩展做准备。
    X-CredentialString{AccessKey}/{ShortDate}/{Region}/{Service}/request 组成。
    X-SignedHeadersString参与签名的 Header,用分号分隔。
    X-SignatureString计算完毕的签名。签名计算方式详情,请参见签名机制

更多详情,请参见公共参数