本文介绍对象存储OSS提供的相关API接口及其各API接口的用法。
关于Service操作
API | 描述 |
---|---|
GetService (ListBuckets) | 返回请求者拥有的所有存储空间(Bucket)。 |
关于Bucket操作
分类 | API | 描述 |
---|---|---|
基础操作 | PutBucket | 创建Bucket。 |
DeleteBucket | 删除Bucket。 | |
GetBucket(ListObject) | 列出Bucket中所有文件(Object)的信息。 | |
GetBucketV2 (ListObjectsV2) | ||
GetBucketInfo | 获取Bucket信息。 | |
GetBucketLocation | 获得Bucket所属的位置信息。 | |
合规保留策略(WORM) | InitiateBucketWorm | 新建合规保留策略。 |
AbortBucketWorm | 删除未锁定的合规保留策略。 | |
CompleteBucketWorm | 锁定合规保留策略。 | |
ExtendBucketWorm | 延长已锁定的合规保留策略对应Bucket中Object的保留天数。 | |
GetBucketWorm | 查看Bucket的合规保留策略信息。 | |
权限控制(ACL) | PutBucketAcl | 设置Bucket访问权限。 |
GetBucketAcl | 获得Bucket访问权限。 | |
生命周期(Lifecycle) | PutBucketLifecycle | 设置Bucket中Object的生命周期规则。 |
GetBucketLifecycle | 查看Bucket中Object的生命周期规则。 | |
DeleteBucketLifecycle | 删除Bucket中Object的生命周期规则。 | |
传输加速(TransferAcceleration) | PutBucketTransferAcceleration | 为存储空间(Bucket)配置传输加速。 |
GetBucketTransferAcceleration | 获取目标存储空间(Bucket)的传输加速配置。 | |
版本控制(Versioning) | PutBucketVersioning | 设置Bucket的版本控制状态。 |
GetBucketVersioning | 获取Bucket的版本控制状态。 | |
GetBucketVersions(ListObjectVersions) | 列举Bucket中所有Object的版本信息。 | |
跨区域复制(Replication) | PutBucketReplication | 设置Bucket的跨区域复制规则。 |
GetBucketReplication | 查看Bucket已设置的跨区域复制规则。 | |
GetBucketReplicationLocation | 查看可复制到的目标Bucket所在的地域。 | |
GetBucketReplicationProgress | 查看Bucket的跨区域复制进度。 | |
DeleteBucketReplication | 停止Bucket的跨区域复制任务并删除Bucket的复制配置。 | |
授权策略(Policy) | PutBucketPolicy | 设置Bucket Policy。 |
GetBucketPolicy | 获取Bucket Policy。 | |
DeleteBucketPolicy | 删除Bucket Policy。 | |
清单(Inventory) | PutBucketInventory | 设置Bucket清单规则。 |
GetBucketInventory | 查看Bucket中指定的清单任务。 | |
ListBucketInventory | 查看Bucket中所有的清单任务。 | |
DeleteBucketInventory | 删除Bucket中指定的清单任务。 | |
日志管理(Logging) | PutBucketLogging | 开启Bucket访问日志记录功能。 |
GetBucketLogging | 查看Bucket的访问日志配置情况。 | |
DeleteBucketLogging | 关闭Bucket访问日志记录功能。 | |
静态网站(Website) | PutBucketWebsite | 设置Bucket为静态网站托管模式。 |
GetBucketWebsite | 查看Bucket的静态网站托管状态。 | |
DeleteBucketWebsite | 关闭Bucket的静态网站托管模式。 | |
防盗链(Referer) | PutBucketReferer | 设置Bucket的防盗链规则。 |
GetBucketReferer | 查看Bucket的防盗链规则。 | |
标签(Tags) | PutBucketTags | 添加或修改Bucket标签。 |
GetBucketTags | 查看Bucket标签信息。 | |
DeleteBucketTags | 删除Bucket标签。 | |
加密(Encryption) | PutBucketEncryption | 配置Bucket的加密规则。 |
GetBucketEncryption | 获取Bucket的加密规则。 | |
DeleteBucketEncryption | 删除Bucket的加密规则。 | |
请求者付费(RequestPayment) | PutBucketRequestPayment | 设置Bucket为请求者付费模式。 |
GetBucketRequestPayment | 查看Bucket请求者付费模式配置信息。 | |
跨域资源共享(CORS) | PutBucketCors | 为指定的存储空间(Bucket)设置跨域资源共享CORS(Cross-Origin Resource Sharing)规则。 |
GetBucketCors | 获取指定存储空间(Bucket)当前的跨域资源共享CORS规则。 | |
DeleteBucketCors | 关闭指定存储空间(Bucket)对应的跨域资源共享CORS功能并清空所有规则。 | |
Options | 浏览器在发送跨域请求之前会发送一个preflight请求(Options)给OSS,并带上特定的来源域、HTTP方法和header等信息,以决定是否发送真正的请求。 |
关于Object的操作
分类 | API | 描述 |
---|---|---|
基础操作 | PutObject | 上传Object。 |
GetObject | 获取Object。 | |
CopyObject | 拷贝Object。 | |
AppendObject | 以追加写的方式上传Object。 | |
DeleteObject | 删除单个Object。 | |
DeleteMultipleObjects | 删除多个Object。 | |
HeadObject | 只返回某个Object的meta信息,不返回文件内容。 | |
GetObjectMeta | 返回Object的基本meta信息,包括该Object的ETag、Size(文件大小)以及LastModified等,不返回文件内容。 | |
PostObject | 通过HTML表单上传的方式上传Object。 | |
Callback | 您只需在发送给OSS的请求中携带相应的Callback参数即能实现回调。 | |
RestoreObject | 解冻归档类型(Archive)或冷归档(Cold Archive)的文件(Object)。 | |
SelectObject | 对目标文件执行SQL语句,返回执行结果。 | |
分片上传(MultipartUpload) | InitiateMultipartUpload | 初始化一个Multipart Upload事件。 |
UploadPart | 根据指定的Object名和uploadId来分块(Part)上传数据。 | |
UploadPartCopy | 通过在UploadPart请求的基础上增加一个请求头x-oss-copy-source来调用UploadPartCopy接口,实现从一个已存在的Object中拷贝数据来上传一个Part。 | |
CompleteMultipartUpload | 在将所有数据Part都上传完成后,您必须调用CompleteMultipartUpload接口来完成整个文件的分片上传。 | |
AbortMultipartUpload | 取消Multipart Upload事件并删除对应的Part数据。 | |
ListMultipartUploads | 列举所有执行中的Multipart Upload事件,即已经初始化但还未完成(Complete)或者还未中止(Abort)的Multipart Upload事件。 | |
ListParts | 列举指定uploadId所属的所有已经上传成功Part。 | |
权限控制(ACL) | PutObjectACL | 修改Object的访问权限。 |
GetObjectACL | 查看Object的访问权限。 | |
软链接(Symlink) | PutSymlink | 创建软链接。 |
GetSymlink | 获取软链接。 | |
标签(Tagging) | PutObjectTagging | 设置或更新对象标签。 |
GetObjectTagging | 获取对象标签信息。 | |
DeleteObjectTagging | 删除指定的对象标签。 |
关于Live Channel的操作
API | 描述 |
---|---|
PutLiveChannelStatus | 切换LiveChannel的状态。 |
PutLiveChannel | 创建LiveChannel。 |
GetVodPlaylist | 获取播放列表。 |
PostVodPlaylist | 生成播放列表。 |
Get LiveChannelStat | 获取LiveChannel的推流状态信息。 |
GetLiveChannelInfo | 获取LiveChannel的配置信息。 |
GetLiveChannelHistory | 获取LiveChannel的推流记录。 |
ListLiveChannel | 列举LiveChannel。 |
DeleteLiveChannel | 删除LiveChannel。 |