一、功能概述
·目前 COS 存在 XML 和 JSON 两个不同版本的 API,两类 API 的签名入参有所差异,COS 推荐你使用 XML 版本的 API。JSON API 是腾讯云 COS 服务在推出 XML API 前为用户提供接入使用 COS 的 API 接口,接口与标准 XML 的 API 底层架构相同,数据互通,可以交叉使用,但是接口不兼容。
·有关 XML 版本的签名介绍文档,请参见 XML 版本 请求签名。
·有关 JSON 版本的签名介绍文档,请参见 JSON 版本 签名算法。
二、注意事项
·本签名工具不识别和提示你填写的错误参数。如果你使用本工具计算请求签名并与 SDK 或其他工具的计算结果进行比较,本工具不会主动纠正你填写的错误参数。
·本签名工具将识别你填写的不合法参数,并进行相应的提示。但仍可能生成一个无法通过签名验证的请求签名。
·本签名工具将识别及提示你尚未填写的必填参数项,且如果你未完成必填参数项的填写,你将无法生成请求签名。
三、工具地址
单击进入 COS 签名工具。
四、输入基础配置信息
1. 单击 COS 签名工具,进入 COS 签名工具页面。
2. 在基础信息栏中,选择签名类型,填写签名有效时间。
·签名类型:选择 XML API 签名。
·签名有效时间:你可以单击获取(60分钟有效期),即可获取一个有效时长为60分钟的签名。你也可以自行输入一个有效起止时间用于复现在该起止时间下的签名结果。相关签名有效时间的介绍,请参见 请求签名。
注意:说明:
注意:基础信息中的参数均为必填项。
五、输入 API 密钥信息
在 API 密钥栏中,填写你的 API 密钥信息。
注意:说明:
六、输入 HTTP 参数信息
在 HTTP 参数栏中,填写相关参数。主要参数如下:
·HttpMethod:必选项。HTTP 请求方法,包括 GET、POST、PUT、DELETE、HEAD。
·HttpURI:必填项。HTTP 请求 URI 部分,即你需要发起请求的对象名称。
·HttpParameters:可选项。HTTP 请求参数。当你需验证 url 参数时可填写该参数。其中,key 小写,value 需要进行 URLEncode,多个 key 以字典排序。
例如,“prefix=abc” 代表指定访问对象前缀为 abc 的对象。
·HttpHeaders:可选项。HTTP 请求头部。当你需验证 url 参数时可填写该参数。其中,key 小写,value 需要进行 URLEncode,多个 key 以字典排序。
例如,Host:bucket1-1254000000.cos.ap-beijing.myqcloud.com代表该签名可访问账户 1254000000 的存储桶 bucket1 下的指定文件,对应的 HttpHeaders 为host=bucket1-1254000000.cos.ap-beijing.myqcloud.com。
相关 HTTP 请求参数的详细描述,请参见 请求签名。
七、生成签名及查阅过程参数
单击生成签名,即可在右侧的结果反馈中,查看请求签名结果。如下:
COS 签名工具将分别展示生成的最终签名及计算签名过程中的过程参数。相关过程参数的详细介绍,请参见 请求签名。
八、输入基础配置信息
1. 单击 COS 签名工具,进入 COS 签名工具页面。
2. 在基础信息栏中,填写签名类型、存储桶名称以及当前时间。
·签名类型:选择 JSON API 签名。
·存储桶名称:填写需要访问的存储桶名称,格式如 bucketname-appid。
·当前时间:目前系统的时间,是一个符合 Unix Epoch 时间戳规范的数值,单位为秒。你也可以填入一个指定的时间用于复现在指定时间戳下的签名结果。
注意:说明:
注意:基础信息中的参数均为必填项。
九、输入 API 密钥信息
在 API 密钥栏中,填写你的 API 密钥信息。
注意:说明:
十、输入 HTTP 参数信息
在 HTTP 参数栏中,填写相关参数。主要参数如下:
·ExpiredTime:必选项。签名的失效时间,单位为秒。你可以在当前时间的参数上加上一个有效时长,得到签名的失效时间。单次签名时,失效时间必须设置为0。
·RandomId:必选项。无符号10进制整数的随机串。
·FilePath:可选项。标识存储资源的相对路径。格式如:/[dirname]/[filename]。
·当操作对象为文件夹时,filename 缺省。filename 中要包含文件后缀名。
·当 FilePath 为空时,生成的请求签名将适用于访问存储桶内所有对象。
相关 HTTP 请求参数的详细描述,请参见 签名算法。
十一、生成签名及查阅过程参数
单击生成签名,即可在右侧的结果反馈中,查看请求签名结果。
COS 签名工具将分别展示生成的最终签名及计算签名过程中的过程参数。相关过程参数的详细介绍,请参见 签名算法。