全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

公共参数

最近更新时间:2025-11-18 10:38:10

公共请求参数说明(AWS4-HMAC-SHA256)

公共请求参数是调用金山云 OpenAPI 时必须携带的基础参数。本节说明各参数的格式、是否必填以及含义。


公共参数列表

参数名

类型

必填

长度限制

参数格式

描述

Action

String

可变

[a-zA-Z]+

接口操作名称,对应具体调用的 OpenAPI 接口。

Version

String

≤10

[a-zA-Z0-9]+

接口版本号。不同版本可能支持不同的参数与返回值,需参考具体 API 文档。

X-Amz-Algorithm

String

16

AWS4-HMAC-SHA256

签名算法,目前仅支持 AWS4-HMAC-SHA256

X-Amz-Credential

String

可变

AccessKeyId/YYYYMMDD/region/service/aws4_request

认证凭证,包含 AccessKeyId、日期、区域、服务名和固定后缀。

X-Amz-Date

String

否*

16

YYYYMMDD'T'HHMMSS'Z'

签名时间(ISO 8601 基本格式)。当未指定时,将默认使用 HTTP 头部中的 Date 字段。

X-Amz-Signature

String

64

十六进制

请求签名的计算结果。

X-Amz-SignedHeaders

String

可变

[a-zA-Z0-9-;]+

参与签名计算的所有请求头字段列表,以分号分隔。

DryRun

Boolean

≤5

true/false1/0

权限验证模式:
true:仅校验权限,不执行操作
false:执行实际操作


说明

  • *:当未提供 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
&<接口业务参数>

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈