状态码 | 原因短语 | 含义与应用场景 |
---|---|---|
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 | 无法处理的方法,客户端发起的请求超出服务器的能力范围时,返回次状态码 |
API返回400 Invalid key,不会覆盖文件。
可以。在POST的表单域设置success_action_redirect,指定成功上传后客户端的重定向url即可。参见: POST Object文档
同名文件会覆盖,返回成功,状态码为200。
PUT方式上传时带上Content-MD5头部,KS3会计算收到的文件的MD5,并根据用户提供的MD5进行校验,参见:文档
增加Content-Type请求头用于描述文件内容MIME格式。可以使用SDK设置。参见: SDK文档