公共请求参数是每个接口都需要使用的请求参数，开发者每次使用火山引擎 API 发送请求时都需要携带这些公共请求参数，否则会导致请求失败。公共请求参数首字母均为大写，以此区分接口请求参数。
说明
Action 和 Version 必须在 Query 中。
| 名称 | 类型 | 是否必填 | 参数格式 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | [a-zA-Z]+ | 接口的名字，与具体的接口相关，表示要执行的操作。 |
| Version | String | 是 | YYYY-MM-DD | 接口的版本信息，当前版本为 2022-10-01。 |
| X-Expires | Int | 否 | 300 | 签名的有效时间，单位：秒（s）。不设置此参数时，默认值为 900 秒。 |
签名参数是请求必不可少的部分，可以在 Header 或 Query 中：
在 Header 中的场景
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| X-Date | String | 是 | 202201013T104027Z， 使用 UTC 时间，精确到秒。 |
| Authorization | String | 是 | HMAC-SHA256 Credential={AccessKey}/{ShortDate}/{Region}/{Service}/request, SignedHeaders={SignedHeaders}, Signature={Signature} |
其中，Authorization 中的信息含义如下表所示。
| 名称 | 类型 | 备注 |
|---|---|---|
| AccessKey | String | 请求的 AK。 |
| ShortDate | String | 请求的短时间，精确到日。使用 UTC 时间，例如：20221001。 |
| Region | String | 请求的地域。例如：华北2（北京）：cn-beijing。 |
| ServiceName | String | 请求的服务，当前为 dts。 |
| SignedHeaders | String | 参与签名的 Header，用分号分隔。 |
| Signature | String | 计算完毕的签名。签名计算方式详情，请参见签名机制。 |
| X-TT-Logid | String | 请求的 ID，生成算法请保持一致性。 |
在 Query 中的场景
说明
X-Date 与 Authorization 的信息可以直接存在 Query 中。
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| X-Date | String | 是 | 20220101T104027Z，使用 UTC 时间，精确到秒。 |
| X-Algorithm | String | 是 | 固定值，HMAC-SHA256。为将来扩展做准备。 |
| X-Credential | String | 是 | 由 {AccessKey}/{ShortDate}/{Region}/{Service}/request 组成。 |
| X-SignedHeaders | String | 是 | 参与签名的 Header，用分号分隔。 |
| X-Signature | String | 是 | 计算完毕的签名。关于签名计算方式的详细信息，请参见签名机制。 |
更多详情，请参见公共参数。