最近更新时间:2025-11-18 10:38:10
公共请求参数是调用金山云 OpenAPI 时必须携带的基础参数。本节说明各参数的格式、是否必填以及含义。
参数名 | 类型 | 必填 | 长度限制 | 参数格式 | 描述 |
|---|---|---|---|---|---|
Action | String | 是 | 可变 |
| 接口操作名称,对应具体调用的 OpenAPI 接口。 |
Version | String | 是 | ≤10 |
| 接口版本号。不同版本可能支持不同的参数与返回值,需参考具体 API 文档。 |
X-Amz-Algorithm | String | 是 | 16 |
| 签名算法,目前仅支持 AWS4-HMAC-SHA256。 |
X-Amz-Credential | String | 是 | 可变 |
| 认证凭证,包含 AccessKeyId、日期、区域、服务名和固定后缀。 |
X-Amz-Date | String | 否* | 16 |
| 签名时间(ISO 8601 基本格式)。当未指定时,将默认使用 HTTP 头部中的 |
X-Amz-Signature | String | 是 | 64 | 十六进制 | 请求签名的计算结果。 |
X-Amz-SignedHeaders | String | 是 | 可变 |
| 参与签名计算的所有请求头字段列表,以分号分隔。 |
DryRun | Boolean | 否 | ≤5 |
| 权限验证模式: |
*:当未提供 X-Amz-Date 时,系统将使用请求头部的 Date 字段作为签名时间。
DryRun 参数用于权限预检查,适用于希望先验证是否具备操作权限而不真正执行的场景。
https://iam.api.ksyun.com/?
Action=ListUsers
&Version=2015-11-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKLTGo0pHK-EQWiDZWTSBSll2Q%2F20160914%2Fcn-beijing-6%2Fiam%2Faws4_request
&X-Amz-Date=20160914T114902Z
&X-Amz-SignedHeaders=host
&X-Amz-Signature=88f6284257863dedfc350da05d19d07f76cca622e93b829f5ce26c1a75d3da39
&<接口业务参数>
纯净模式
