平安云 - 云以致用智造未来

API描述

<section class="section" id="API_Description__section_mmt_ndl_plb"><h2 class="doc-tairway">1. 上传文件</h2> 接口描述 上传文件 请求参数 <table class="table" id="API_Description__table_i3k_4dl_plb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_i3k_4dl_plb__entry__1">PUT</th> <th class="entry" id="API_Description__table_i3k_4dl_plb__entry__2"> http:// {bucket.host}/{key} http://{host}/{bucket}/{key} </th> <th class="entry" id="API_Description__table_i3k_4dl_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_i3k_4dl_plb__entry__1 " rowspan="2"> 路径参数 </td> <td class="entry" headers="API_Description__table_i3k_4dl_plb__entry__2 "> {bucket} </td> <td class="entry" headers="API_Description__table_i3k_4dl_plb__entry__3 "> Bucket名称 见资源术语 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_i3k_4dl_plb__entry__2 "> {key} </td> <td class="entry" headers="API_Description__table_i3k_4dl_plb__entry__3 "> Key名称 见资源术语 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_i3k_4dl_plb__entry__1 " rowspan="2"> 出参 </td> <td class="entry" headers="API_Description__table_i3k_4dl_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_i3k_4dl_plb__entry__3 ">-</td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_i3k_4dl_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_i3k_4dl_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> </section> <section class="section" id="API_Description__section_hlr_rdl_plb"><h2 class="doc-tairway">2. 分片上传文件</h2> 接口描述 一次分片上传，需要三个子步骤： <ul class="ul" id="API_Description__ul_fkv_sdl_plb"> <li class="li">初始化分片上传</li> <li class="li">上传每个分片</li> <li class="li">完成分片上传</li> </ul> （1）初始化分片上传 用于获取一个上传ID，在后续的步骤中（上传每一分片和完成分片上传），请求中都需要带上此ID作为请求参数。 请求参数 <table class="table" id="API_Description__table_gkv_sdl_plb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_gkv_sdl_plb__entry__1">POST</th> <th class="entry" id="API_Description__table_gkv_sdl_plb__entry__2"> {bucket.host}/{key}?uploads {host}/{bucket}/{key}?uploads </th> <th class="entry" id="API_Description__table_gkv_sdl_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_gkv_sdl_plb__entry__1 " rowspan="2"> 路径参数 </td> <td class="entry" headers="API_Description__table_gkv_sdl_plb__entry__2 "> {bucket} </td> <td class="entry" headers="API_Description__table_gkv_sdl_plb__entry__3 "> Bucket名称 见资源术语 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_gkv_sdl_plb__entry__2 "> {key} </td> <td class="entry" headers="API_Description__table_gkv_sdl_plb__entry__3 "> 对象key </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_gkv_sdl_plb__entry__1 " rowspan="2"> 出参 </td> <td class="entry" headers="API_Description__table_gkv_sdl_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_gkv_sdl_plb__entry__3 "> 见响应示例 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_gkv_sdl_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_gkv_sdl_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> 请求示例 <pre xmlns:version="java:net.sf.saxon.Version" class="pre codeblock language-java">POST /xiaoming-bucket-0009/mykey?uploads HTTP/1.1 Authorization: AWS 5NE0EMKT1XAIF1WRUSDB:uFlfwIpe2yPSbtVhF6QjBYHTmL0=, Content-Type: application/zip, Date: Wed, 03 Jan 2018 01:56:39 GMT</pre> 响应示例 <pre xmlns:version="java:net.sf.saxon.Version" class="pre codeblock language-java"><?xml version="1.0" encoding="UTF-8"?> <InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Bucket>xiaoming-bucket-0009</Bucket> <Key>mykey</Key> <UploadId>2~fj31Nbo8jDMALTOjMOoq_WZe1iyTOyw</UploadId> </InitiateMultipartUploadResult></pre> （2）上传每个分片 将分片的字节流作为请求的body。每个分片（除了最后一个分片）的大小必须不小于5M，分片总数不大于10000片。 请求参数 <table class="table" id="API_Description__table_x5n_zdl_plb"><caption></caption><colgroup><col style="width:164pt"><col style="width:295pt"><col style="width:184.5pt"></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_x5n_zdl_plb__entry__1">PUT</th> <th class="entry" id="API_Description__table_x5n_zdl_plb__entry__2"> http://{bucket.host}/{key}?partNumber={partNumber} &uploadId={uploadId} http://{host}/{bucket}/{key}?partNumber={partNumber} &uploadId={uploadId} </th> <th class="entry" id="API_Description__table_x5n_zdl_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__1 " rowspan="2"> 入参 </td> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__2 "> partNumber </td> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__3 "> 分片编号。第1片编号为1，以后每片编号加1。 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__2 "> uploadId </td> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__3 "> 上传ID，来源于初始化上传返回的ID。 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__1 " rowspan="2"> 路径参数 </td> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__2 "> {bucket} </td> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__3 "> Bucket名称 请参见<a class="xref" href="/ssr/help/storage/obs/api.Explaination" target="_blank">资源术语</a>。 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__2 "> {key} </td> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__3 "> 对象Key。 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__1 " rowspan="2"> 出参 </td> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__3 "> 请记录头部中的ETag值，该值在最后调用完成分片时会用到。注意，在公网环境/代理环境中响应头部的ETag名称可能会被篡改为Etag或etag，获取时请注意大小写 请参见<a class="xref" href="#API_Description__p_uvg_q2l_plb">响应示例</a>。 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_x5n_zdl_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> 请求示例 <pre xmlns:version="java:net.sf.saxon.Version" class="pre codeblock language-java">PUT /xiaoming-bucket-0009/mykey?partNumber=1&uploadId=2~wox3UUmC3CtiVDZO7Ktnnia6vROLudY HTTP/1.1 Authorization: AWS 5NE0EMKT1XAIF1WRUSDB:6QcN+fHGHFclO5WvcdxfaznskFc= Content-MD5: sEj3I1ECjtaOEVlpUuKhzA== Content-Type: application/zip Date: Wed, 03 Jan 2018 02:21:05 GMT</pre> 响应示例 <pre xmlns:version="java:net.sf.saxon.Version" class="pre codeblock language-java">HTTP/1.1 200 OK ETag: "b048f72351028ed68e11596952e2a1cc"</pre> （3）完成分片上传 将每次分片响应的ETag值拼装成以下的XMl作为请求的body，PartNumber从1开始： <pre xmlns:version="java:net.sf.saxon.Version" class="pre codeblock language-java"><CompleteMultipartUpload> <Part> <PartNumber>1</PartNumber> <ETag>b048f72351028ed68e11596952e2a1cc</ETag> </Part> <Part> <PartNumber>2</PartNumber> <ETag>43144f8ff83a9379222c579078b96042</ETag> </Part> </CompleteMultipartUpload></pre> 请求参数 <table class="table" id="API_Description__table_rpc_v2l_plb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_rpc_v2l_plb__entry__1">POST</th> <th class="entry" id="API_Description__table_rpc_v2l_plb__entry__2"> http:// {bucket.host}/{key}?uploadId={uploadId} http://{host}/{bucket}/{key}?uploadId={uploadId} </th> <th class="entry" id="API_Description__table_rpc_v2l_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_rpc_v2l_plb__entry__1 "> 入参 </td> <td class="entry" headers="API_Description__table_rpc_v2l_plb__entry__2 "> uploadId </td> <td class="entry" headers="API_Description__table_rpc_v2l_plb__entry__3 "> 上传ID，来源于初始化上传返回的ID </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_rpc_v2l_plb__entry__1 " rowspan="2"> 路径参数 </td> <td class="entry" headers="API_Description__table_rpc_v2l_plb__entry__2 "> {bucket} </td> <td class="entry" headers="API_Description__table_rpc_v2l_plb__entry__3 "> Bucket名称 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_rpc_v2l_plb__entry__2 "> {key} </td> <td class="entry" headers="API_Description__table_rpc_v2l_plb__entry__3 "> 对象key </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_rpc_v2l_plb__entry__1 " rowspan="2"> 出参 </td> <td class="entry" headers="API_Description__table_rpc_v2l_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_rpc_v2l_plb__entry__3 "> - </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_rpc_v2l_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_rpc_v2l_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> 请求示例 <pre xmlns:version="java:net.sf.saxon.Version" class="pre codeblock language-java">POST /xiaoming-bucket-0009/mykey?uploadId=2~R8TAtOVsxcxzw8_pQI5g8WgSIz81Vqn HTTP/1.1 Authorization: AWS 5NE0EMKT1XAIF1WRUSDB:LC1TqLtmbSXwylvokg3Wubo5Sgo= Date: Wed, 03 Jan 2018 02:36:36 GMT Content-Type: application/octet-stream <CompleteMultipartUpload> <Part> <PartNumber>1</PartNumber> <ETag>b048f72351028ed68e11596952e2a1cc</ETag> </Part> <Part> <PartNumber>2</PartNumber> <ETag>43144f8ff83a9379222c579078b96042</ETag> </Part> </CompleteMultipartUpload></pre> 响应示例 <pre xmlns:version="java:net.sf.saxon.Version" class="pre codeblock language-java">HTTP/1.1 200 OK Content-Type: application/xml <?xml version="1.0" encoding="UTF-8"?> <CompleteMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Bucket>xiaoming-bucket-0009</Bucket> <Key>mykey</Key> <ETag>cca15715f657c57c4e1051f727b7d7c4-2</ETag> </CompleteMultipartUploadResult></pre> （4）取消分片上传 可以删除该某一上传ID相关的未完成的片，以释放占用OBS存储空间。 请求参数 <table class="table" id="API_Description__table_ywj_jfl_plb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_ywj_jfl_plb__entry__1">DELETE</th> <th class="entry" id="API_Description__table_ywj_jfl_plb__entry__2"> http:// {bucket.host}/{key}?uploadId={uploadId} http://{host}/{bucket}/{key}?uploadId={uploadId} </th> <th class="entry" id="API_Description__table_ywj_jfl_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_ywj_jfl_plb__entry__1 "> 入参 </td> <td class="entry" headers="API_Description__table_ywj_jfl_plb__entry__2 "> uploadId </td> <td class="entry" headers="API_Description__table_ywj_jfl_plb__entry__3 "> 上传ID，来源于初始化上传返回的ID </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ywj_jfl_plb__entry__1 " rowspan="2"> 路径参数 </td> <td class="entry" headers="API_Description__table_ywj_jfl_plb__entry__2 "> {bucket} </td> <td class="entry" headers="API_Description__table_ywj_jfl_plb__entry__3 "> Bucket名称 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ywj_jfl_plb__entry__2 "> {key:.*} </td> <td class="entry" headers="API_Description__table_ywj_jfl_plb__entry__3 "> 对象key </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ywj_jfl_plb__entry__1 " rowspan="2"> 出参 </td> <td class="entry" headers="API_Description__table_ywj_jfl_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_ywj_jfl_plb__entry__3 "> - </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ywj_jfl_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_ywj_jfl_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> 请求示例 <pre xmlns:version="java:net.sf.saxon.Version" class="pre codeblock language-java">DELETE /xiaoming-bucket-0009/mykey?uploadId=2~SNGTH88-FcDMa7A7cPUnyc4DtNYjdLx HTTP/1.1 Authorization: AWS 5NE0EMKT1XAIF1WRUSDB:ObFa4+N5bB/lDRUfbAAIHUUGGtI= Date: Wed, 03 Jan 2018 02:49:11 GMT Content-Type: application/x-www-form-urlencoded</pre> 响应示例 <pre xmlns:version="java:net.sf.saxon.Version" class="pre codeblock language-java">HTTP/1.1 204 No Content Content-Type: text/plain</pre> </section> <section class="section" id="API_Description__section_w4r_nfl_plb"><h2 class="doc-tairway">3. 下载文件</h2> 接口描述 下载文件 请求参数 <table class="table" id="API_Description__table_nsy_4fl_plb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_nsy_4fl_plb__entry__1">GET</th> <th class="entry" id="API_Description__table_nsy_4fl_plb__entry__2"> http://{bucket.host}/{key} http://{host}/{bucket}/{key} </th> <th class="entry" id="API_Description__table_nsy_4fl_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__1 " rowspan="4"> 入参 </td> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__2 "> AWSAccessKeyId </td> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__3 "> 租户AK(非必填) </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__2 "> Expires </td> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__3 "> 从1990-01-01 00:00:00 GMT到截止有效期的秒数(非必填) </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__2 "> Signature </td> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__3 "> 签名串(非必填) </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__2 "> response-content-disposition </td> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__3 "> 下载文件重命名(非必填) </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__1 " rowspan="2"> 路径参数 </td> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__2 "> {bucket} </td> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__3 "> Bucket名字，格式：小写字母、数字中划线（不支持中文），不能以中横线开头或结尾，不能以-s数字结尾命名规范：RSMS子系统英文简称-环境-自定义/流水码,环境：用dev代表开发测试环境，prd代表生产环境和灾备环境。 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__2 "> {key} </td> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__3 "> 对象key </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__1 " rowspan="2"> 出参 </td> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__3 "> 对象流 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_nsy_4fl_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> <div class="note important note_important">重要： 当通过签名URL下载文件时，入参中的AWSAccessKeyId，Expires，Signature为必填；否则，头参Authorization，Content-Type，Date为必填，且不要填写入参AWSAccessKeyId。</div> </section> <section class="section" id="API_Description__section_a12_xfl_plb"><h2 class="doc-tairway">4. 获取Object信息</h2> 接口描述 获取object信息 请求参数 <table class="table" id="API_Description__table_wkr_xfl_plb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_wkr_xfl_plb__entry__1">HEAD</th> <th class="entry" id="API_Description__table_wkr_xfl_plb__entry__2"> http://{bucket.host}/{key} http://{host}/{bucket}/{key} </th> <th class="entry" id="API_Description__table_wkr_xfl_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_wkr_xfl_plb__entry__1 " rowspan="2"> 路径参数 </td> <td class="entry" headers="API_Description__table_wkr_xfl_plb__entry__2 "> {bucket} </td> <td class="entry" headers="API_Description__table_wkr_xfl_plb__entry__3 "> Bucket名字 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_wkr_xfl_plb__entry__2 "> {key} </td> <td class="entry" headers="API_Description__table_wkr_xfl_plb__entry__3 "> 对象key </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_wkr_xfl_plb__entry__1 " rowspan="2"> 出参 </td> <td class="entry" headers="API_Description__table_wkr_xfl_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_wkr_xfl_plb__entry__3 "> Object信息，请从response header里获取object相关信息包括Content-Type, Content-Length, ETag, Date。注意，用户自定义的metadata，其KEY值前会被添加字符串“x-amz-meta-”。比如，用户定义的color，响应的header中会以x-amz-meta-color呈现。 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_wkr_xfl_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_wkr_xfl_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> </section> <section class="section" id="API_Description__section_q2v_xfl_plb"><h2 class="doc-tairway">5. 删除Object</h2> 接口描述 删除object 请求参数 <table class="table" id="API_Description__table_rh3_yfl_plb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_rh3_yfl_plb__entry__1">DELETE</th> <th class="entry" id="API_Description__table_rh3_yfl_plb__entry__2"> http://{bucket.host}/{key} http://{host}/{bucket}/{key} </th> <th class="entry" id="API_Description__table_rh3_yfl_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_rh3_yfl_plb__entry__1 " rowspan="2"> 路径参数 </td> <td class="entry" headers="API_Description__table_rh3_yfl_plb__entry__2 "> {bucket} </td> <td class="entry" headers="API_Description__table_rh3_yfl_plb__entry__3 "> Bucket名字，格式：小写字母、数字、中划线（不支持中文），不能以中横线开头或结尾，不能以-s数字结尾命名规范：RSMS子系统英文简称-环境-自定义/流水码，环境：用dev代表开发测试环境，prd代表生产环境和灾备环境。 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_rh3_yfl_plb__entry__2 "> {key} </td> <td class="entry" headers="API_Description__table_rh3_yfl_plb__entry__3 "> 对象key </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_rh3_yfl_plb__entry__1 " rowspan="2"> 出参 </td> <td class="entry" headers="API_Description__table_rh3_yfl_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_rh3_yfl_plb__entry__3 "> - </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_rh3_yfl_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_rh3_yfl_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> </section> <section class="section" id="API_Description__section_t5n_yfl_plb"><h2 class="doc-tairway">6. 图片格式转换</h2> 接口描述 图片格式转换 请求参数 <table class="table" id="API_Description__table_ivf_zfl_plb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_ivf_zfl_plb__entry__1">GET</th> <th class="entry" id="API_Description__table_ivf_zfl_plb__entry__2"> http://{bucket.host}/{key}/imageView/{mode}/w/{width}/h/{height}/format/{format} http://{host}/{bucket}/{key}/imageView/{mode}/w/{width}/h/{height}/format/{format} </th> <th class="entry" id="API_Description__table_ivf_zfl_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__1 " rowspan="6"> 入参 </td> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__2 "> {bucket} </td> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__3 "> - </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__2 "> {key} </td> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__3 "> 对象key </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__2 "> {mode}/ </td> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__3 "> 缩放方式，有效值0~5 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__2 "> {width} </td> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__3 "> 图片宽度，有效值0-6000（非必传） </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__2 "> {height} </td> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__3 "> 图片高度，有效值0-6000（非必传） </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__2 "> {format} </td> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__3 "> 图片格式(非必传)，支持jpeg, tiff, gif, bmp, png </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__1 " rowspan="2"> 出参 </td> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__3 "> 图片流 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_ivf_zfl_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> <div class="note important note_important">重要： 参数width和height至少需传入一个，不能同时为0 </div> 所有访问路径： http://{host}/download/{bucket}/{key:.*}/imageView/{mode}/w/{width}/h/{height}/format/{format}, http://{host}/{bucket}/{key:.*}/imageView/{mode}/w/{width}/h/{height}/format/{format}, http://{host}/download/{bucket}/{key:.*}/imageView/{mode}/h/{height}/format/{format}, http://{host}/{bucket}/{key:.*}/imageView/{mode}/h/{height}/format/{format}, http://{host}/download/{bucket}/{key:.*}/imageView/{mode}/w/{width}/format/{format}, http://{host}/{bucket}/{key:.*}/imageView/{mode}/w/{width}/format/{format}, http://{host}/download/{bucket}/{key:.*}/imageView/{mode}/w/{width}/h/{height}, http://{host}/{bucket}/{key:.*}/imageView/{mode}/w/{width}/h/{height}, http://{host}/download/{bucket}/{key:.*}/imageView/{mode}/w/{width}, http://{host}/{bucket}/{key:.*}/imageView/{mode}/w/{width}, http://{host}/download/{bucket}/{key:.*}/imageView/{mode}/h/{height}, http://{host}/{bucket}/{key:.*}/imageView/{mode}/h/{height} </section> <section class="section" id="API_Description__section_elk_zfl_plb"><h2 class="doc-tairway">7. 剪切图</h2> 接口描述 剪切图 请求参数 <table class="table" id="API_Description__table_q4y_zfl_plb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_q4y_zfl_plb__entry__1">GET</th> <th class="entry" id="API_Description__table_q4y_zfl_plb__entry__2"> http://{bucket.host}/{key}/cut/{width}/{height} http://{host}/{bucket}/{key}/cut/{width}/{height} </th> <th class="entry" id="API_Description__table_q4y_zfl_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__1 " rowspan="4"> 入参 </td> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__2 "> {bucket} </td> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__3 "> Bucket名字，格式：小写字母、数字、中划线（不支持中文），不能以中横线开头或结尾，不能以-s数字结尾命名规范：RSMS子系统英文简称-环境-自定义/流水码，环境：用dev代表开发测试环境，prd代表生产环境和灾备环境。 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__2 "> {key} </td> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__3 "> 对象key </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__2 "> {width} </td> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__3 "> 图片宽度，有效值0-6000 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__2 "> {height} </td> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__3 "> 图片高度，有效值0~6000 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__1 " rowspan="2">出参</td> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__3 "> 图片流 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_q4y_zfl_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> </section> <section class="section" id="API_Description__section_t3f_1gl_plb"><h2 class="doc-tairway">8. 获取指定图片信息</h2> 接口描述 获取指定图片信息 请求参数 <table class="table" id="API_Description__table_lw5_1gl_plb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_lw5_1gl_plb__entry__1">PUT</th> <th class="entry" id="API_Description__table_lw5_1gl_plb__entry__2"> http://{bucket.host}/imageInfo/{key} http://{host}/imageInfo/{bucket}/{key} </th> <th class="entry" id="API_Description__table_lw5_1gl_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_lw5_1gl_plb__entry__1 " rowspan="2"> 路径参数 </td> <td class="entry" headers="API_Description__table_lw5_1gl_plb__entry__2 "> {bucket} </td> <td class="entry" headers="API_Description__table_lw5_1gl_plb__entry__3 "> - </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_lw5_1gl_plb__entry__2 "> {key} </td> <td class="entry" headers="API_Description__table_lw5_1gl_plb__entry__3 "> 对象key </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_lw5_1gl_plb__entry__1 " rowspan="2"> 出参 </td> <td class="entry" headers="API_Description__table_lw5_1gl_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_lw5_1gl_plb__entry__3 "> {ColorModel, Format, FrameNumber, Height, Width } </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_lw5_1gl_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_lw5_1gl_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> </section> <section class="section" id="API_Description__section_lb1_bgl_plb"><h2 class="doc-tairway">9. 删除转码记录及转换后的Object</h2> 接口描述 删除转码记录及转换后的Object 请求参数 <table class="table" id="API_Description__table_ig4_bgl_plb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_ig4_bgl_plb__entry__1">PUT</th> <th class="entry" id="API_Description__table_ig4_bgl_plb__entry__2"> http://{bucket.host}/deleteByCK?bucket={bucket} &convertedKey={convertedKey} http://{host}/deleteByCK?bucket={bucket} &convertedKey={convertedKey} </th> <th class="entry" id="API_Description__table_ig4_bgl_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_ig4_bgl_plb__entry__1 " rowspan="2"> 入参 </td> <td class="entry" headers="API_Description__table_ig4_bgl_plb__entry__2 "> convertedKey </td> <td class="entry" headers="API_Description__table_ig4_bgl_plb__entry__3 "> 转换后新生成的对象Key </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ig4_bgl_plb__entry__2 "> bucket </td> <td class="entry" headers="API_Description__table_ig4_bgl_plb__entry__3 "> - </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ig4_bgl_plb__entry__1 " rowspan="2"> 出参 </td> <td class="entry" headers="API_Description__table_ig4_bgl_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_ig4_bgl_plb__entry__3 "> 无 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ig4_bgl_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_ig4_bgl_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> </section> <section class="section" id="API_Description__section_y4r_bgl_plb"><h2 class="doc-tairway">10. 获取media转码记录，用于查询转码进度</h2> 接口描述 获取media转码记录，用于查询转码进度 请求参数 <table class="table" id="API_Description__table_ovf_cgl_plb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_ovf_cgl_plb__entry__1">GET</th> <th class="entry" id="API_Description__table_ovf_cgl_plb__entry__2"> http://{bucket.host}/queryByCKs?bucket={bucket}&convertedKeys={convertedKeys} http://{host}/queryByCKs?bucket={bucket}&convertedKeys={convertedKeys} </th> <th class="entry" id="API_Description__table_ovf_cgl_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_ovf_cgl_plb__entry__1 " rowspan="2"> 入参 </td> <td class="entry" headers="API_Description__table_ovf_cgl_plb__entry__2 "> convertedKeys </td> <td class="entry" headers="API_Description__table_ovf_cgl_plb__entry__3 "> 转换后新生成的对象Key集,通过逗号分割 如：key1,key2 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ovf_cgl_plb__entry__2 "> bucket </td> <td class="entry" headers="API_Description__table_ovf_cgl_plb__entry__3 "> - </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ovf_cgl_plb__entry__1 " rowspan="2"> 出参 </td> <td class="entry" headers="API_Description__table_ovf_cgl_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_ovf_cgl_plb__entry__3 "> "bucket":" yourBucket", "finishTime":"2017-07-14 13:56:54", "submitTime":"2017-07-14 13:56:53", "startTime":"2017-07-14 13:56:53", "state":"Error",//状态，用于反应转码进度"oriObjectKey":"46a5476297c740239820ed4d64e256a6$002",//原始key"message":"desFile.exists: false",//失败原因 "convertedKey":" yourConvertedKey " </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_ovf_cgl_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_ovf_cgl_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> </section> <section class="section" id="API_Description__section_dyt_qgl_plb"><h2 class="doc-tairway">11. 媒体转码和视频截图</h2> 接口描述 媒体转码和视频截图 请求参数 <table class="table" id="API_Description__table_s3m_rgl_plb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead"> <tr class="row"> <th class="entry" id="API_Description__table_s3m_rgl_plb__entry__1"> POST</th> <th class="entry" id="API_Description__table_s3m_rgl_plb__entry__2"> http://{bucket.host}/pfop?bucket={bucket}&key={key}&sourceType={sourceType}&force={force}&fops={fops}&notifyURL={notifyURL} http://{host}/ pfop?bucket={bucket}&key={key}&sourceType={sourceType}&force={force}&fops={fops}&notifyURL={notifyURL} </th> <th class="entry" id="API_Description__table_s3m_rgl_plb__entry__3">说明</th> </tr> </thead><tbody class="tbody"> <tr class="row"> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__1 " rowspan="6"> 入参 </td> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__2 "> bucket </td> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__3 "> Bucket名字 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__2 "> key </td> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__3 "> 对象key </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__2 "> sourceType </td> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__3 "> 源类型 如image、media。 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__2 "> fops </td> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__3 "> 自定义的规则 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__2 "> force </td> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__3 "> 是否覆盖原有的Key 默认为false </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__2 "> notifyURL </td> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__3 "> 转码JOB的通知URL（非必传） </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__1 " rowspan="2"> 出参 </td> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__2 "> 成功 </td> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__3 "> 对象流 </td> </tr> <tr class="row"> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__2 "> 失败 </td> <td class="entry" headers="API_Description__table_s3m_rgl_plb__entry__3 "> 异常信息 </td> </tr> </tbody></table> </section>

以上内容是否解决了您的问题？是否

1. 上传文件
2. 分片上传文件
3. 下载文件
<,>4. 获取Object信息<,>
5. 删除Object
<,>6. 图片格式转换<,>
<,>7. 剪切图<,>
<,>8. 获取指定图片信息<,>
<,>9. 删除转码记录及转换后的Object<,>
<,>10. 获取media转码记录，用于查询转码进度<,>
11. 媒体转码和视频截图