API 描述

<p><strong>1. 上传文件</strong></p> <p><strong>接口描述</strong></p> <p>上传文件</p> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>PUT</strong></p> </td> <td> <p><strong>http:// {bucket.host}/{key}</strong></p> <p><strong>http://{host}/{bucket}/{key}</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td rowspan="2"> <p>路径参数</p> </td> <td> <p>{bucket}</p> </td> <td> <p>Bucket名称</p> <p>见资源术语</p> </td> </tr> <tr> <td> <p>{key}</p> </td> <td> <p>Key名称</p> <p>见资源术语</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>&nbsp;</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p>&nbsp;</p> <p><strong>2. 分片上传文件</strong></p> <p><strong>接口描述</strong></p> <p>一次分片上传,需要三个子步骤:</p> <ul> <li>初始化分片上传</li> <li>上传每个分片</li> <li>完成分片上传</li> </ul> <p><strong>(1)</strong><strong>初始化分片上传</strong></p> <p>用于获取一个上传ID,在后续的步骤中(上传每一分片和完成分片上传),请求中都需要带上此ID作为请求参数。</p> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>POST</strong></p> </td> <td> <p><strong>{bucket.host}/{key}?uploads</strong></p> <p><strong>{host}/{bucket}/{key}?uploads</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td rowspan="2"> <p>路径参数</p> </td> <td> <p>{bucket}</p> </td> <td> <p>Bucket名称</p> <p>见资源术语</p> </td> </tr> <tr> <td> <p>{key}</p> </td> <td> <p>对象key</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>见响应示例</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td style="vertical-align:top"> <p>POST /xiaoming-bucket-0009/mykey?uploads HTTP/1.1</p> <p>Authorization: AWS 5NE0EMKT1XAIF1WRUSDB:uFlfwIpe2yPSbtVhF6QjBYHTmL0=, Content-Type: application/zip,</p> <p>Date: Wed, 03 Jan 2018 01:56:39 GMT</p> </td> </tr> </tbody> </table> <p><strong>响应示例</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td style="vertical-align:top"> <p>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;</p> <p>&lt;InitiateMultipartUploadResult xmlns=&quot;http://s3.amazonaws.com/doc/2006-03-01/&quot;&gt;</p> <p>&lt;Bucket&gt;xiaoming-bucket-0009&lt;/Bucket&gt;</p> <p>&lt;Key&gt;mykey&lt;/Key&gt;</p> <p>&lt;UploadId&gt;2~fj31Nbo8jDMALTOjMOoq_WZe1iyTOyw&lt;/UploadId&gt;</p> <p>&lt;/InitiateMultipartUploadResult&gt;</p> </td> </tr> </tbody> </table> <p><strong>(2)</strong><strong>上传每个分片</strong></p> <p>将分片的字节流作为请求的body。每个分片(除了最后一个分片)的大小必须不小于5M,分片总数不大于10000片。</p> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>PUT</strong></p> </td> <td> <p><strong>http://{bucket.host}/{key}?partNumber={partNumber}</strong></p> <p><strong>&amp;uploadId={uploadId}</strong></p> <p><strong>http://{host}/{bucket}/{key}?partNumber={partNumber}</strong></p> <p><strong>&amp;uploadId={uploadId}</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td rowspan="2"> <p>入参</p> </td> <td> <p>partNumber</p> </td> <td> <p>分片编号。第1片编号为1,以后每片编号加1</p> </td> </tr> <tr> <td> <p>uploadId</p> </td> <td> <p>上传ID,来源于初始化上传返回的ID</p> </td> </tr> <tr> <td rowspan="2"> <p>路径参数</p> </td> <td> <p>{bucket}</p> </td> <td> <p>Bucket名称</p> <p>见资源术语</p> </td> </tr> <tr> <td> <p>{key}</p> </td> <td> <p>对象key</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>请记录头部中的ETag值,该值在最后调用完成分片时会用到。注意,在公网环境/代理环境中响应头部的ETag名称可能会被篡改为Etag或etag,获取时请注意大小写</p> <p>见响应示例</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td style="vertical-align:top"> <p>PUT /xiaoming-bucket-0009/mykey?partNumber=1&amp;uploadId=2~wox3UUmC3CtiVDZO7Ktnnia6vROLudY HTTP/1.1</p> <p>Authorization: AWS 5NE0EMKT1XAIF1WRUSDB:6QcN+fHGHFclO5WvcdxfaznskFc=</p> <p>Content-MD5: sEj3I1ECjtaOEVlpUuKhzA==</p> <p>Content-Type: application/zip</p> <p>Date: Wed, 03 Jan 2018 02:21:05 GMT</p> </td> </tr> </tbody> </table> <p><strong>响应示例</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td style="vertical-align:top"> <p>HTTP/1.1 200 OK</p> <p>ETag: &quot;b048f72351028ed68e11596952e2a1cc&quot;</p> </td> </tr> </tbody> </table> <p><strong>(3)完成分片上传</strong></p> <p>将每次分片响应的ETag值拼装成以下的XMl作为请求的body,PartNumber从1开始:</p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td style="vertical-align:top"> <p>&lt;CompleteMultipartUpload&gt;</p> <p>&lt;Part&gt;</p> <p>&lt;PartNumber&gt;1&lt;/PartNumber&gt;</p> <p>&lt;ETag&gt;b048f72351028ed68e11596952e2a1cc&lt;/ETag&gt;</p> <p>&lt;/Part&gt;</p> <p>&lt;Part&gt;</p> <p>&lt;PartNumber&gt;2&lt;/PartNumber&gt;</p> <p>&lt;ETag&gt;43144f8ff83a9379222c579078b96042&lt;/ETag&gt;</p> <p>&lt;/Part&gt;</p> <p>&lt;/CompleteMultipartUpload&gt;</p> </td> </tr> </tbody> </table> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>POST</strong></p> </td> <td> <p><strong>http:// {bucket.host}/{key}?uploadId={uploadId}</strong></p> <p><strong>http://{host}/{bucket}/{key}?uploadId={uploadId}</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td> <p>入参</p> </td> <td> <p>uploadId</p> </td> <td> <p>上传ID,来源于初始化上传返回的ID</p> </td> </tr> <tr> <td rowspan="2"> <p>路径参数</p> </td> <td> <p>{bucket}</p> </td> <td> <p>Bucket名称</p> </td> </tr> <tr> <td> <p>{key}</p> </td> <td> <p>对象key</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>&nbsp;</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td style="vertical-align:top"> <p>POST</p> <p>/xiaoming-bucket-0009/mykey?uploadId=2~R8TAtOVsxcxzw8_pQI5g8WgSIz81Vqn HTTP/1.1</p> <p>Authorization: AWS 5NE0EMKT1XAIF1WRUSDB:LC1TqLtmbSXwylvokg3Wubo5Sgo=</p> <p>Date: Wed, 03 Jan 2018 02:36:36 GMT</p> <p>Content-Type: application/octet-stream</p> <p>&lt;CompleteMultipartUpload&gt;</p> <p>&lt;Part&gt;</p> <p>&lt;PartNumber&gt;1&lt;/PartNumber&gt;</p> <p>&lt;ETag&gt;b048f72351028ed68e11596952e2a1cc&lt;/ETag&gt;</p> <p>&lt;/Part&gt;</p> <p>&lt;Part&gt;</p> <p>&lt;PartNumber&gt;2&lt;/PartNumber&gt;</p> <p>&lt;ETag&gt;43144f8ff83a9379222c579078b96042&lt;/ETag&gt;</p> <p>&lt;/Part&gt;</p> <p>&lt;/CompleteMultipartUpload&gt;</p> </td> </tr> </tbody> </table> <p><strong>响应示例</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td style="vertical-align:top"> <p>HTTP/1.1 200 OK</p> <p>Content-Type: application/xml</p> <p>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;</p> <p>&lt;CompleteMultipartUploadResult xmlns=&quot;http://s3.amazonaws.com/doc/2006-03-01/&quot;&gt;</p> <p>&lt;Bucket&gt;xiaoming-bucket-0009&lt;/Bucket&gt;</p> <p>&lt;Key&gt;mykey&lt;/Key&gt;</p> <p>&lt;ETag&gt;cca15715f657c57c4e1051f727b7d7c4-2&lt;/ETag&gt;</p> <p>&lt;/CompleteMultipartUploadResult&gt;</p> </td> </tr> </tbody> </table> <p><strong>(4)取消分片上传</strong></p> <p>可以删除该某一上传ID相关的未完成的片,以释放占用OBS存储空间。</p> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>DELETE</strong></p> </td> <td> <p><strong>http:// {bucket.host}/{key}?uploadId={uploadId}</strong></p> <p><strong>http://{host}/{bucket}/{key}?uploadId={uploadId}</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td> <p>入参</p> </td> <td> <p>uploadId</p> </td> <td> <p>上传ID,来源于初始化上传返回的ID</p> </td> </tr> <tr> <td rowspan="2"> <p>路径参数</p> </td> <td> <p>{bucket}</p> </td> <td> <p>Bucket名称</p> </td> </tr> <tr> <td> <p>{key:.*}</p> </td> <td> <p>对象key</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>&nbsp;</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p><strong>请求示例</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td style="vertical-align:top"> <p>DELETE /xiaoming-bucket-0009/mykey?uploadId=2~SNGTH88-FcDMa7A7cPUnyc4DtNYjdLx HTTP/1.1</p> <p>Authorization: AWS 5NE0EMKT1XAIF1WRUSDB:ObFa4+N5bB/lDRUfbAAIHUUGGtI=</p> <p>Date: Wed, 03 Jan 2018 02:49:11 GMT</p> <p>Content-Type: application/x-www-form-urlencoded</p> </td> </tr> </tbody> </table> <p><strong>响应示例</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td style="vertical-align:top"> <p>HTTP/1.1 204 No Content</p> <p>Content-Type: text/plain</p> </td> </tr> </tbody> </table> <p>&nbsp;</p> <p><strong>3. 下载文件</strong></p> <p><strong>接口描<span style="display:none">&nbsp;</span>述</strong></p> <p>下载文件</p> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>GET</strong></p> </td> <td> <p><strong>http://{bucket.host}/{key}</strong></p> <p><strong>http://{host}/{bucket}/{key}</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td rowspan="4"> <p>入参</p> </td> <td> <p>AWSAccessKeyId</p> </td> <td> <p>租户AK(非必填)</p> </td> </tr> <tr> <td> <p>Expires</p> </td> <td> <p>从1990-01-01 00:00:00 GMT到截止有效期的秒数(非必填)</p> </td> </tr> <tr> <td> <p>Signature</p> </td> <td> <p>签名串(非必填)</p> </td> </tr> <tr> <td> <p>response-content-disposition</p> </td> <td> <p>下载文件重命名(非必填)</p> </td> </tr> <tr> <td rowspan="2"> <p>路径参数</p> </td> <td> <p>{bucket}</p> </td> <td> <p>Bucket名字,格式:小写字母、 数字、中划线(不支持中文),不能以中横线开头或结尾,不能以-s数字结尾 命名规范:RSMS子系统英文简称-环境-自定义/流水码,环境:用dev代表开发测试环境,prd代表生产环境和灾备环境</p> </td> </tr> <tr> <td> <p>{key}</p> </td> <td> <p>对象key</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>对象流</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p>注意,当通过签名URL下载文件时,入参中的AWSAccessKeyId,Expires,Signature为必填;否则,头参Authorization,Content-Type,Date为必填,且不要填写入参AWSAccessKeyId。</p> <p>&nbsp;</p> <p><strong>4. 获取Object信息</strong></p> <p><strong>接口描述</strong></p> <p>获取object信息</p> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>HEAD</strong></p> </td> <td> <p><strong>http://{bucket.host}/{key}</strong></p> <p><strong>http://{host}/{bucket}/{key}</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td rowspan="2"> <p>路径参数</p> </td> <td> <p>{bucket}</p> </td> <td> <p>Bucket名字</p> </td> </tr> <tr> <td> <p>{key}</p> </td> <td> <p>对象key</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>Object信息,请从response header里获取object相关信息 包括Content-Type, Content-Length, ETag, Date。 注意,用户自定义的metadata,其KEY值前会被添加字符串&ldquo;x-amz-meta-&rdquo;。比如,用户定义的color,响应的header中会以x-amz-meta-color呈现。</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p>&nbsp;</p> <p><strong>5. 删除Object</strong></p> <p><strong>接口描述</strong></p> <p>删除object</p> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>DELETE</strong></p> </td> <td> <p><strong>http://{bucket.host}/{key}</strong></p> <p><strong>http://{host}/{bucket}/{key}</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td rowspan="2"> <p>路径参数</p> </td> <td> <p>{bucket}</p> </td> <td> <p>Bucket名字,格式:小写字母、 数字、中划线(不支持中文),不能以中横线开头或结尾,不能以-s数字结尾 命名规范:RSMS子系统英文简称-环境-自定义/流水码,环境:用dev代表开发测试环境,prd代表生产环境和灾备环境</p> </td> </tr> <tr> <td> <p>{key}</p> </td> <td> <p>对象key</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>&nbsp;</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p>&nbsp;</p> <p><strong>6. 图片格式转换</strong></p> <p><strong>接口描述</strong></p> <p>图片格式转换</p> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>GET</strong></p> </td> <td> <p><strong>http://{bucket.host} /{key}</strong></p> <p><strong>/imageView/{mode}/w/{width}/h/{height}/format/{format}</strong></p> <p><strong>http://{host} /{bucket}/{key}</strong></p> <p><strong>/imageView/{mode}/w/{width}/h/{height}/format/{format}</strong></p> <p><strong>&nbsp;</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td rowspan="6"> <p>入参</p> </td> <td> <p>{bucket}</p> </td> <td> <p>&nbsp;</p> </td> </tr> <tr> <td> <p>{key}</p> </td> <td> <p>对象key</p> </td> </tr> <tr> <td> <p>{mode}/</p> </td> <td> <p>缩放方式,有效值0-5</p> </td> </tr> <tr> <td> <p>{width}</p> </td> <td> <p>图片宽度,有效值0-6000(非必传)</p> </td> </tr> <tr> <td> <p>{height}</p> </td> <td> <p>图片高度,有效值0-6000(非必传)</p> </td> </tr> <tr> <td> <p>{format}</p> </td> <td> <p>图片格式(非必传),支持jpeg, tiff, gif, bmp, png</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>图片流</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p><strong>注:参数width和height至少需传入一个,不能同时为0</strong></p> <p><strong>所有访问路径:</strong></p> <p><strong>http://{host}/download/{bucket}/{key:.*}/imageView/{mode}/w/{width}/h/{height}/format/{format},</strong></p> <p><strong>http://{host}/{bucket}/{key:.*}/imageView/{mode}/w/{width}/h/{height}/format/{format},</strong></p> <p><strong>http://{host}/download/{bucket}/{key:.*}/imageView/{mode}/h/{height}/format/{format},</strong></p> <p><strong>http://{host}/{bucket}/{key:.*}/imageView/{mode}/h/{height}/format/{format},</strong></p> <p><strong>http://{host}/download/{bucket}/{key:.*}/imageView/{mode}/w/{width}/format/{format},</strong></p> <p><strong>http://{host}/{bucket}/{key:.*}/imageView/{mode}/w/{width}/format/{format},</strong></p> <p><strong>http://{host}/download/{bucket}/{key:.*}/imageView/{mode}/w/{width}/h/{height},</strong></p> <p><strong>http://{host}/{bucket}/{key:.*}/imageView/{mode}/w/{width}/h/{height},</strong></p> <p><strong>http://{host}/download/{bucket}/{key:.*}/imageView/{mode}/w/{width},</strong></p> <p><strong>http://{host}/{bucket}/{key:.*}/imageView/{mode}/w/{width},</strong></p> <p><strong>http://{host}/download/{bucket}/{key:.*}/imageView/{mode}/h/{height},</strong></p> <p><strong>http://{host}/{bucket}/{key:.*}/imageView/{mode}/h/{height}</strong></p> <p>&nbsp;</p> <p><strong>7. 剪切图</strong></p> <p><strong>接口描述</strong></p> <p>剪切图</p> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>GET</strong></p> </td> <td> <p><strong>http://{bucket.host}/{key}/cut/{width}/{height}</strong></p> <p><strong>http://{host}/{bucket}/{key}/cut/{width}/{height}</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td rowspan="4"> <p>入参</p> </td> <td> <p>{bucket}</p> </td> <td> <p>Bucket名字,格式:小写字母、 数字、中划线(不支持中文),不能以中横线开头或结尾,不能以-s数字结尾 命名规范:RSMS子系统英文简称-环境-自定义/流水码,环境:用dev代表开发测试环境,prd代表生产环境和灾备环境</p> </td> </tr> <tr> <td> <p>{key }</p> </td> <td> <p>对象key</p> </td> </tr> <tr> <td> <p>{width}</p> </td> <td> <p>图片宽度,有效值0-6000</p> </td> </tr> <tr> <td> <p>{height}</p> </td> <td> <p>图片高度,有效值0-6000</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>图片流</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p>&nbsp;</p> <p><strong>8. 获取指定图片信息</strong></p> <p><strong>接口描述</strong></p> <p>获取指定图片信息</p> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>PUT</strong></p> </td> <td> <p><strong>http://{bucket.host}/imageInfo/{key}</strong></p> <p><strong>http://{host}/imageInfo/{bucket}/{key}</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td rowspan="2"> <p>路径参数</p> </td> <td> <p>{bucket}</p> </td> <td> <p>&nbsp;</p> </td> </tr> <tr> <td> <p>{key}</p> </td> <td> <p>对象key</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>{ColorModel, Format, FrameNumber, Height,&nbsp;Width&nbsp;}</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p>&nbsp;</p> <p><strong>9. 删除转码记录及转换后的Object</strong></p> <p><strong>接口描述</strong></p> <p>删除转码记录及转换后的Object</p> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>PUT</strong></p> </td> <td> <p><strong>http://{bucket.host}/deleteByCK</strong> <strong>?bucket={bucket}</strong></p> <p><strong>&amp;convertedKey={convertedKey}</strong></p> <p><strong>http://{host}/deleteByCK</strong> <strong>?bucket={bucket}</strong></p> <p><strong>&amp;convertedKey={convertedKey}</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td rowspan="2"> <p>入参</p> </td> <td> <p>convertedKey</p> </td> <td> <p>转换后新生成的对象Key</p> </td> </tr> <tr> <td> <p>bucket</p> </td> <td> <p>&nbsp;</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>无</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p>&nbsp;</p> <p><strong>10. 获取media转码记录,用于查询转码进度</strong></p> <p><strong>接口描述</strong></p> <p>获取media转码记录,用于查询转码进度</p> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>GET</strong></p> </td> <td> <p><strong>http://{bucket.host}/queryByCKs?bucket={bucket}</strong></p> <p><strong>&amp;convertedKeys={convertedKeys}</strong></p> <p><strong>http://{host}/queryByCKs?bucket={bucket}</strong></p> <p><strong>&amp;convertedKeys={convertedKeys}</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td rowspan="2"> <p>入参</p> </td> <td> <p>convertedKeys</p> </td> <td> <p>转换后新生成的对象Key集,通过逗号分割</p> <p>如:key1,key2</p> </td> </tr> <tr> <td> <p>bucket</p> </td> <td> <p>&nbsp;</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>&quot;bucket&quot;:&quot;&nbsp;yourBucket&quot;,&nbsp;&quot;finishTime&quot;:&quot;2017-07-14 13:56:54&quot;,&nbsp;&quot;submitTime&quot;:&quot;2017-07-14 13:56:53&quot;,&nbsp;&quot;startTime&quot;:&quot;2017-07-14 13:56:53&quot;,&nbsp;&quot;state&quot;:&quot;Error&quot;,//状态,用于反应转码进度&quot;oriObjectKey&quot;:&quot;46a5476297c740239820ed4d64e256a6$002&quot;,//原始key&quot;message&quot;:&quot;desFile.exists: false&quot;,//失败原因&nbsp;&quot;convertedKey&quot;:&quot;&nbsp;yourConvertedKey &quot;&nbsp;&nbsp;</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p>&nbsp;</p> <p><strong>11.&nbsp;媒体转码和视频截图</strong></p> <p><strong>接口描述</strong></p> <p>媒体转码和视频截图</p> <p><strong>请求参数</strong></p> <table border="1" cellpadding="0" cellspacing="0"> <tbody> <tr> <td> <p><strong>&nbsp;&nbsp; POST</strong></p> </td> <td> <p><strong>http://{bucket.host}/pfop?bucket={bucket}&amp;key={key}</strong></p> <p><strong>&amp;sourceType={sourceType}&amp;force={force}</strong></p> <p><strong>&amp;fops={fops}&amp;notifyURL={notifyURL}</strong></p> <p><strong>http://{host}/ pfop?bucket={bucket}&amp;key={key}</strong></p> <p><strong>&amp;sourceType={sourceType}&amp;force={force}</strong></p> <p><strong>&amp;fops={fops}&amp;notifyURL={notifyURL}</strong></p> </td> <td> <p><strong>说明</strong></p> </td> </tr> <tr> <td rowspan="6"> <p>入参</p> </td> <td> <p>bucket</p> </td> <td> <p>Bucket名字</p> </td> </tr> <tr> <td> <p>key</p> </td> <td> <p>对象key</p> </td> </tr> <tr> <td> <p>sourceType</p> </td> <td> <p>源类型</p> <p>如下:</p> <p>image、media</p> </td> </tr> <tr> <td> <p>fops</p> </td> <td> <p>自定义的规则</p> </td> </tr> <tr> <td> <p>force</p> </td> <td> <p>是否覆盖原有的Key 默认为false</p> </td> </tr> <tr> <td> <p>notifyURL</p> </td> <td> <p>转码JOB的通知URL(非必传)</p> </td> </tr> <tr> <td rowspan="2"> <p>出参</p> </td> <td> <p>成功</p> </td> <td> <p>对象流</p> </td> </tr> <tr> <td> <p>失败</p> </td> <td> <p>异常信息</p> </td> </tr> </tbody> </table> <p>&nbsp;</p>
以上内容是否解决了您的问题?
请补全提交信息!
咨询·建议

电话咨询 - 7x24 小时

400-151-8800

邮件咨询

cloud@pingan.com

在线客服

7x24 小时,急速解答

工单支持

解决云产品相关技术问题