文档中心

技术类问题


1. KS3请求返回码有哪些?代表什么含义?
状态码 原因短语 含义与应用场景
100 Continue 说明收到了请求的部分,请客户端继续。在PUT Object的请求头中包含Expect:100-continue的时候返回,客户端需要等到收到确认时才会发送请求体。
200 OK 请求成功,实体的主体部分包含了所请求的资源。
201 Created 对象创建成功,响应的主体部分中包含已创建的资源的url。在POST Object时如果在表单域中设置了success_action——status为201,则上传成功后Ks3会返回一个状态码为201的XML
204 No Content 响应报文中没有实体的主体部分。Delete Bucket和Delete Object成功会返回该状态码
206 Partial Content 成功执行了一个Range请求。Get Object时可以通过Range首部来获取部分或某个范围的对象,这个状态码说明范围请求成功了。
304 Not Modified 如果客户端发起了一个条件GET请求,而最近资源未被修改的话,相应不包含实体的主体部分只返回该状态码。用户将使用浏览器缓存中的资源。
301 Moved Permanently 请求的URL已被移除。该URL不能响应该请求,请检查是否正确设置了bucket所在区域的uURL地址(endpoint)。
302 Found 与301类似,但客户端应该使用Location首部给出的URL来临时定位资源。例如设置镜像源后通过ks3地址访问镜像源上的文件,如果ks3上还没有该文件时会返回该状态码,重定向到源站去访问。
307 Temporary Redirect 告知客户端应该使用Location首部给出的URL来临时定位资源。将来的请求可能还要使用老的URL。GET Bucket接口调用时如果endpoint设置有误,会返回该状态码。
400 Bad Request 告知客户端发送了一个错误的请求。可以查看返回体的xml文档中的消息确定错误原因。错误消息的描述参见:错误码列表
403 Forbidden 请求被服务器拒绝了。返回的实体的主体部分会对拒绝原因进行简要描述。可能的原因包括:无效的AccessKey,签名不匹配,发起请求的时间和服务器时间超出15分钟
404 Not Found 服务器无法找到所请求的URL。可能的原因包括:该Bucket不存在,该Object不存在
405 Method Not Allowed 不支持的方法。
408 Request Timeout 客户端完成请求所花的时间太长,会返回该状态码。
409 Conflict 请求在资源上可能引发冲突。响应中会包含描述冲突的主体。可能引起冲突的原因包括:重复创建已经存在的Bucket,删除不为空的bucket
416 Requested Range Not Satisfiable 无效的Range,所请求的指定资源的某个范围,而此范围无效或无法满足时,返回该状态码。
500 Internal Server Error 服务器遇到一个妨碍它为请求提供服务的错误时,返回此状态码
501 Not Implemented 无法处理的方法,客户端发起的请求超出服务器的能力范围时,返回次状态码
2. 调用Put Object Copy接口拷贝文件,如果目标文件已经存在,如何处理?

API返回400 Invalid key,不会覆盖文件。

3. POST表单上传文件后,可以自动进行跳转吗?

可以。在POST的表单域设置success_action_redirect,指定成功上传后客户端的重定向url即可。参见: POST Object文档

4. 视频转码后的文件名如果与bucket中的其他文件重名,是返回错误,还是会直接覆盖?

同名文件会覆盖,返回成功,状态码为200。

5. 传文件至 ks3,怎样确保文件完整性?

PUT方式上传时带上Content-MD5头部,KS3会计算收到的文件的MD5,并根据用户提供的MD5进行校验,参见:文档

6. 上传文件的时候如何设置Content Type?

增加Content-Type请求头用于描述文件内容MIME格式。可以使用SDK设置。参见: SDK文档