Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

storage

package

Go to main page

Versions in this module

v1

v1.3.4

Mar 17, 2026

v1.3.3

Mar 17, 2026

Changes in this version

+ const DirectUploadChecksumMD5

+ const DirectUploadChecksumSHA256

+ const DirectUploadModeAuto

+ const DirectUploadModePost

+ const DirectUploadModePut

+ var ErrDirectUploadAuthorizationUnsupported = errors.New("storage: direct upload authorization not supported")

+ var ErrInvalidDirectUploadRequest = errors.New("storage: invalid direct upload request")

+ var ErrUnsupportedDirectUploadConstraint = providers.ErrUnsupportedDirectUploadConstraint

+ type DirectUploadAuthorization = internal.DirectUploadAuthorization

+ func AuthorizeDirectUpload(ctx context.Context, req DirectUploadRequest) (*DirectUploadAuthorization, error)

+ func AuthorizeDirectUploadWithClient(ctx context.Context, c Client, req DirectUploadRequest) (*DirectUploadAuthorization, error)

+ type DirectUploadChecksum = internal.DirectUploadChecksum

+ type DirectUploadChecksumAlgorithm = internal.DirectUploadChecksumAlgorithm

+ type DirectUploadConstraints = internal.DirectUploadConstraints

+ type DirectUploadMismatch = internal.DirectUploadMismatch

+ type DirectUploadMode = internal.DirectUploadMode

+ type DirectUploadRequest = internal.DirectUploadRequest

+ type DirectUploadSize = internal.DirectUploadSize

+ type DirectUploadVerificationRequest = internal.DirectUploadVerificationRequest

+ type DirectUploadVerificationResult = internal.DirectUploadVerificationResult

+ func VerifyDirectUploadObject(ctx context.Context, req DirectUploadVerificationRequest) (*DirectUploadVerificationResult, error)

+ func VerifyDirectUploadObjectWithClient(ctx context.Context, c Client, req DirectUploadVerificationRequest) (*DirectUploadVerificationResult, error)

type UploadOptionFunc

+ func WithMetadata(key, value string) UploadOptionFunc

v1.3.2

Mar 13, 2026

v1.3.1

Mar 10, 2026

v1.3.0

Mar 10, 2026

v1.2.1

Mar 10, 2026

v1.2.0

Mar 9, 2026

Changes in this version

+ const DefaultSignExpire

+ const TypeCOS

+ const TypeOSS

+ const TypeS3

+ var ErrAccessDenied = errors.New("storage: access denied")

+ var ErrBucketNotFound = errors.New("storage: bucket not found")

+ var ErrInvalidConfig = errors.New("storage: invalid configuration")

+ var ErrInvalidCredentials = errors.New("storage: invalid credentials")

+ var ErrMissingClient = errors.New("storage: client not configured")

+ var ErrMultipartNotFound = errors.New("storage: multipart upload not found")

+ var ErrObjectNotFound = errors.New("storage: object not found")

+ var ErrPartAlreadyExist = errors.New("storage: part already uploaded")

+ var ErrUnsupportedType = errors.New("storage: unsupported storage type")

+ func AbortMultipart(ctx context.Context, uploadID string) error

+ func AbortMultipartWithClient(ctx context.Context, c Client, uploadID string) error

+ func CompleteMultipart(ctx context.Context, uploadID string, parts []*PartInfo, ...) error

+ func CompleteMultipartWithClient(ctx context.Context, c Client, uploadID string, parts []*PartInfo, ...) error

+ func Configure(cfg *Config) error

+ func Delete(ctx context.Context, key string) error

+ func DeleteBatch(ctx context.Context, keys []string) error

+ func DeleteBatchWithClient(ctx context.Context, c Client, keys []string) error

+ func DeleteWithClient(ctx context.Context, c Client, key string) error

+ func Download(ctx context.Context, key string, opts ...DownloadOptionFunc) (io.ReadCloser, error)

+ func DownloadWithClient(ctx context.Context, c Client, key string, opts ...DownloadOptionFunc) (io.ReadCloser, error)

+ func Exists(ctx context.Context, key string) (bool, error)

+ func ExistsWithClient(ctx context.Context, c Client, key string) (bool, error)

+ func SignedURL(ctx context.Context, key string, expire time.Duration, opts ...SignOptionFunc) (string, error)

+ func SignedURLWithClient(ctx context.Context, c Client, key string, expire time.Duration, ...) (string, error)

+ func Upload(ctx context.Context, key string, reader io.Reader, opts ...UploadOptionFunc) error

+ func UploadWithClient(ctx context.Context, c Client, key string, reader io.Reader, ...) error

+ type Client = internal.Client

+ func GetClient() Client

+ type Config = internal.Config

+ type DownloadOption = internal.DownloadOption

+ type DownloadOptionFunc = internal.DownloadOptionFunc

+ type MultipartUpload = internal.MultipartUpload

+ func InitMultipart(ctx context.Context, key string, opts ...UploadOptionFunc) (*MultipartUpload, error)

+ func InitMultipartWithClient(ctx context.Context, c Client, key string, opts ...UploadOptionFunc) (*MultipartUpload, error)

+ type ObjectInfo = internal.ObjectInfo

+ type PartInfo = internal.PartInfo

+ func UploadPart(ctx context.Context, uploadID string, partNum int, reader io.Reader, ...) (*PartInfo, error)

+ func UploadPartWithClient(ctx context.Context, c Client, uploadID string, partNum int, reader io.Reader, ...) (*PartInfo, error)

+ type SignOption = internal.SignOption

+ type SignOptionFunc = internal.SignOptionFunc

+ func WithSignMethod(method string) SignOptionFunc

+ type UploadOption = internal.UploadOption

+ type UploadOptionFunc = internal.UploadOptionFunc

+ func WithContentType(ct string) UploadOptionFunc