全部文档
当前文档

暂无内容

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

文档中心

调用方式

最近更新时间: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文档

公共参数

签名算法

纯净模式常规模式

纯净模式

点击可全屏预览文档内容