Go SDK概览

本文概述了对象存储OSS提供的Go SDK相关方法。

关于Bucket操作

分类

方法

使用场景

基础操作

CreateBucket

创建Bucket。

DeleteBucket

删除Bucket。

ListBucket

列举Bucket。

IsBucketExist

判断Bucket是否存在。

GetBucketInfo

获取Bucket信息。

GetBucketLocation

获取Bucket所属地域信息。

GetBucketStat

获取Bucket的存储容量以及Object数量。

合规保留策略(WORM)

InitiateBucketWorm

新建合规保留策略。

AbortBucketWorm

删除未锁定的合规保留策略。

CompleteBucketWorm

锁定合规保留策略。

ExtendBucketWorm

延长已锁定的合规保留策略对应Bucket中Object的保留天数。

GetBucketWorm

获取Bucket的合规保留策略信息。

权限控制(ACL)

SetBucketAcl

设置Bucket访问权限。

GetBucketAcl

获取Bucket访问权限。

生命周期(Lifecycle)

SetBucketLifecycle

设置Bucket中Object的生命周期规则。

GetBucketLifecycle

获取Bucket中Object的生命周期规则。

DeleteBucketLifecycle

删除Bucket中Object的生命周期规则。

传输加速(TransferAcceleration)

SetBucketTransferAcceleration

为存储空间(Bucket)配置传输加速。

GetBucketTransferAcceleration

获取目标存储空间(Bucket)的传输加速配置。

版本控制(Versioning)

SetBucketVersioning

设置Bucket的版本控制状态。

GetBucketVersioning

获取Bucket的版本控制状态。

ListObjectVersions

列举Bucket中所有Object的版本信息。

数据复制(Replication)

PutBucketReplication

开启并设置Bucket的数据复制规则。

PutBucketRTC

为已有的跨区域复制规则开启或关闭数据复制时间控制(RTC)功能。

GetBucketReplication

查看Bucket已设置的数据复制规则。

GetBucketReplicationLocation

查看可复制到的目标Bucket所在的地域。

GetBucketReplicationProgress

查看Bucket的数据复制进度。

DeleteBucketReplication

停止Bucket的数据复制任务并删除Bucket的复制配置。

授权策略(Policy)

SetBucketPolicy

设置Bucket Policy。

GetBucketPolicy

获取Bucket Policy。

DeleteBucketPolicy

删除Bucket Policy。

存储空间清单(Inventory)

SetBucketInventory

设置Bucket清单规则。

GetBucketInventory

查看Bucket中指定的清单任务。

ListBucketInventory

查看Bucket中所有的清单任务。

DeleteBucketInventory

删除Bucket中指定的清单任务。

日志转存(Logging)

SetBucketLogging

开启Bucket访问日志记录功能。

GetBucketLogging

查看Bucket的访问日志配置情况。

DeleteBucketLogging

关闭Bucket访问日志记录功能。

静态网站(Website)

SetBucketWebsite

设置Bucket为静态网站托管模式。

GetBucketWebsite

查看Bucket的静态网站托管状态。

DeleteBucketWebsite

关闭Bucket的静态网站托管模式。

防盗链(Referer)

SetBucketReferer

设置Bucket的防盗链规则。

GetBucketReferer

查看Bucket的防盗链规则。

标签(Tags)

SetBucketTagging

添加或修改Bucket标签。

GetBucketTagging

查看Bucket标签信息。

DeleteBucketTagging

删除Bucket标签。

服务器端加密(Encryption)

SetBucketEncryption

配置Bucket的加密规则。

GetBucketEncryption

获取Bucket的加密规则。

DeleteBucketEncryption

删除Bucket的加密规则。

请求者付费(RequestPayment)

PutBucketRequestPayment

设置Bucket为请求者付费模式。

GetBucketRequestPayment

查看Bucket请求者付费模式配置信息。

跨域资源共享(CORS)

SetBucketCors

为指定的存储空间(Bucket)设置跨域资源共享CORS(Cross-Origin Resource Sharing)规则。

GetBucketCors

获取指定存储空间(Bucket)当前的跨域资源共享CORS规则。

DeleteBucketCors

关闭指定存储空间(Bucket)对应的跨域资源共享CORS功能并清空所有规则。

访问跟踪(AccessMonitor)

PutBucketAccessMonitor

配置Bucket的访问跟踪状态。

GetBucketAccessMonitor

获取Bucket的访问跟踪状态。

数据索引(Data Indexing)

OpenMetaQuery

为Bucket开启元数据管理功能。

GetMetaQueryStatus

获取指定Bucket的元数据索引库信息。

DoMetaQuery

查询满足指定条件的Object,并按照指定字段和排序方式列出Object信息。

CloseMetaQuery

关闭Bucket的元数据管理功能。

资源组

PutBucketResourceGroup

为Bucket配置所属资源组。

GetBucketResourceGroup

获取Bucket的资源组ID。

自定义域名(CNAME)

CreateBucketCnameToken

创建域名所有权验证所需的CnameToken。

GetBucketCnameToken

获取已创建的CnameToken。

PutBucketCname

为某个Bucket绑定CNAME。

ListBucketCname

获取某个Bucket下绑定的所有CNAME列表。

DeleteBucketCname

删除已绑定的CNAME。

图片处理

ProcessObject

对指定图片文件执行处理操作。

图片样式(Style)

PutBucketStyle

新增图片样式。

GetBucketStyle

获取某个Bucket下指定的图片样式信息。

ListBucketStyle

获取某个Bucket下已创建的所有图片样式。

DeleteBucketStyle

删除某个Bucket下指定的图片样式。

视频转码

AsyncProcessObject

使用异步的方式进行视频转码。

关于Object操作

分类

方法

使用场景

基础操作

PutObject

上传Object。

GetObject

获取Object。

CopyObject

拷贝Object。

AppendObject

以追加写的方式上传Object。

DeleteObject

删除单个Object。

DeleteMultipleObjects

删除多个Object。

GetObjectMeta

返回Object的基本meta信息,包括该Object的ETag、Size(文件大小)以及LastModified等,不返回文件内容。

Callback

您只需在发送给OSS的请求中携带相应的Callback参数即可实现回调。

RestoreObject

解冻归档存储、冷归档存储或者深度冷归档存储类型的Object。

SelectObject

对目标文件执行SQL语句,返回执行结果。

管理目录

PutObject

创建目录。

DeleteObject

删除目录。

断点续传上传(UploadFile)

UploadFile

使用断点续传执行上传大文件

分片上传(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)

SetObjectACL

修改Object的访问权限。

GetObjectACL

查看Object的访问权限。

软链接(Symlink)

PutSymlink

创建软链接。

GetSymlink

获取软链接。

标签(Tagging)

PutObjectTagging

设置或更新对象标签。

GetObjectTagging

获取对象标签信息。

DeleteObjectTagging

删除指定的对象标签。

关于Live Channel操作

分类

方法

使用场景

管理LiveChannel

CreateLiveChannel

创建LiveChannel。

ListLiveChannel

列举LiveChannel。

PutLiveChannelStatus

设置LiveChannel状态。

SignRtmpURL

获取LiveChannel鉴权地址

GetLiveChannelStat

获取LiveChannel状态信息。

GetLiveChannelInfo

获取LiveChannel配置信息。

PostVodPlaylist

生成LiveChannel播放列表。

GetVodPlaylist

获取LiveChannel播放列表。

GetLiveChannelHistory

获取LiveChannel推流记录。

DeleteLiveChannel

删除LiveChannel。