最近更新时间:2025-03-12 18:56:17
客户调用金山云边缘节点计算文件共享服务服务的OpenAPI接口是通过向指定服务地址发送请求,并按照OpenAPI文档说明在请求中添加相应的公共参数和接口参数来完成的。
文件共享服务OpenAPI的请求结构组成如下:
1.服务地址
文件共享服务的服务接入地址为:kenc.api.ksyun.com
2.通信协议
支持通过 HTTP 或 HTTPS 两种方式进行请求通信,推荐使用安全性更高的 HTTPS方式发送请求。
3.请求方法
文件共享服务的OpenAPI同时支持GET和POST请求。
不能混合使用两种请求方式。如果使用 GET 方式,参数均从 querystring 取得;如果使用 POST 方式,参数均从请求Body中取得。
如果请求方式是GET,需要对所有请求参数做URL编码;如果请求方式是POST,需要使用x-www-form-urlencoded方式进行编码。
4.请求参数
金山云OpenAPI请求包含两类参数:公共请求参数和接口请求参数。其中,公共请求参数是每个接口都要用到的请求参数,具体可参见公共参数及签名机制小节;接口请求参数是各个接口所特有的,具体见各个接口的“请求参数”描述。
5.字符编码
请求及返回结果都使用UTF-8字符集进行编码。
调用金山云的OpenAPI服务,调用成功,返回的HTTP状态码(Status)为200;调用失败,返回4xx 或5xx的HTTP状态码(Status)。
示例
{
"RequestId": "12df0962-777d-44b9-8d6f-e1a31db8d34b004",
"Code":"Success", //结果状态码
"InstanceId": "sfss-gfsdgy3fga3tonbq-jxmp35"
}
示例
{
"RequestId": "12df0962-777d-44b9-8d6f-e1a31db8d34b004",
"Code": "InvalidParameter",
"Message": "invalid param DataVolume.1.Size"
}
金山云OpenAPI支持以下两种签名算法,您可以根据业务需要选择所使用的签名算法,请注意两种签名算法所使用的公共参数有所区别。
(1)简化版签名算法,相比AWS签名算法,签名机制更加简单。
(2)AWS签名算法版本4,具体可以参考AWS文档
纯净模式