OSS接口规范和错误响应

1. 开放接口规范

开发者在发送请求给 OSS 时，既可以使用 带签名认证的请求，也可以使用匿名访问。

OSS提供的相关API官方文档: https://help.aliyun.com/document_detail/31957.html#reference-ahf-k4t-tdb

例:

• 关于service的操作

  GetService (ListBuckets) 返回请求拥有者的所有bucket

• 关于bucket的操作

  createBucket, putBucketACL, getBucketInfo…………..

• 关于object的操作

  putObject, copyObject, getObject, ……………..

• 关于 multipart upload的操作

  InitiateMultipartUpload(初始化多文件上传事件) , uploadPart(分块上传)…………….

• 跨域资源共享 cors

  putBucketcors(在指定bucket设置一个cors规则), ……………

• live channel操作

2. 错误响应

• 响应格式

  当用户访问OSS出错时，OSS会返回给用户一个合适的3xx，4xx或者5xx的HTTP状态码；以及一个application/xml格式的消息体

  所有错误的消息体中都包括以下几个元素：

  • Code：OSS返回给用户的错误码。
  • Message：OSS给出的详细错误信息。
  • RequestId：用于唯一标识该次请求的UUID；当你无法解决问题时，可以凭这个RequestId来请求OSS开发工程师的帮助。
  • HostId：用于标识访问的OSS集群（目前统一为oss.aliyuncs.com）

• 错误码

  官方文档