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.23.4

Jan 27, 2026

v1.23.3

Jan 27, 2026

v1.23.2

Jan 26, 2026

Changes in this version

+ func ComputeChecksum(path string) (string, error)

+ func VerifyChecksum(path, expected string) (bool, error)

+ type AzureStorage struct

+ func NewAzureStorage(ctx context.Context, cfg *Config) (*AzureStorage, error)

+ func (a *AzureStorage) Bucket() string

+ func (a *AzureStorage) Close() error

+ func (a *AzureStorage) Copy(ctx context.Context, srcKey, dstKey string) error

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

+ func (a *AzureStorage) DeleteMany(ctx context.Context, keys []string) error

+ func (a *AzureStorage) Download(ctx context.Context, key string, writer io.Writer, opts *DownloadOptions) error

+ func (a *AzureStorage) DownloadFile(ctx context.Context, key string, localPath string, opts *DownloadOptions) error

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

+ func (a *AzureStorage) GetInfo(ctx context.Context, key string) (*ObjectInfo, error)

+ func (a *AzureStorage) GetSignedURL(ctx context.Context, key string, expiry time.Duration, forUpload bool) (string, error)

+ func (a *AzureStorage) List(ctx context.Context, opts *ListOptions) (*ListResult, error)

+ func (a *AzureStorage) Provider() Provider

+ func (a *AzureStorage) Upload(ctx context.Context, key string, reader io.Reader, size int64, ...) error

+ func (a *AzureStorage) UploadFile(ctx context.Context, key string, localPath string, opts *UploadOptions) error

+ type Config struct

+ AWSAccessKey string

+ AWSAssumeRoleARN string

+ AWSProfile string

+ AWSSecretKey string

+ AWSSessionToken string

+ AzureAccountKey string

+ AzureAccountName string

+ AzureConnectionStr string

+ Bucket string

+ DisableSSL bool

+ Endpoint string

+ GCSCredentialsFile string

+ GCSProjectID string

+ LocalBasePath string

+ MaxRetries int

+ PathStyle bool

+ Provider Provider

+ Region string

+ SFTPHost string

+ SFTPPassword string

+ SFTPPort int

+ SFTPPrivateKey string

+ SFTPUser string

+ Timeout time.Duration

+ func ParseURI(uri string) (*Config, string, error)

+ type DownloadOptions struct

+ ProgressFunc func(bytesDownloaded, totalBytes int64)

+ Range string

+ VersionID string

+ type GCSStorage struct

+ func NewGCSStorage(ctx context.Context, cfg *Config) (*GCSStorage, error)

+ func (g *GCSStorage) Bucket() string

+ func (g *GCSStorage) Close() error

+ func (g *GCSStorage) Copy(ctx context.Context, srcKey, dstKey string) error

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

+ func (g *GCSStorage) DeleteMany(ctx context.Context, keys []string) error

+ func (g *GCSStorage) Download(ctx context.Context, key string, writer io.Writer, opts *DownloadOptions) error

+ func (g *GCSStorage) DownloadFile(ctx context.Context, key string, localPath string, opts *DownloadOptions) error

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

+ func (g *GCSStorage) GetInfo(ctx context.Context, key string) (*ObjectInfo, error)

+ func (g *GCSStorage) GetSignedURL(ctx context.Context, key string, expiry time.Duration, forUpload bool) (string, error)

+ func (g *GCSStorage) List(ctx context.Context, opts *ListOptions) (*ListResult, error)

+ func (g *GCSStorage) Provider() Provider

+ func (g *GCSStorage) Upload(ctx context.Context, key string, reader io.Reader, size int64, ...) error

+ func (g *GCSStorage) UploadFile(ctx context.Context, key string, localPath string, opts *UploadOptions) error

+ type ListOptions struct

+ Delimiter string

+ MaxKeys int

+ Prefix string

+ StartAfter string

+ type ListResult struct

+ CommonPrefixes []string

+ IsTruncated bool

+ NextMarker string

+ Objects []ObjectInfo

+ type LocalStorage struct

+ func NewLocalStorage(cfg *Config) (*LocalStorage, error)

+ func (l *LocalStorage) Bucket() string

+ func (l *LocalStorage) Close() error

+ func (l *LocalStorage) Copy(ctx context.Context, srcKey, dstKey string) error

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

+ func (l *LocalStorage) DeleteMany(ctx context.Context, keys []string) error

+ func (l *LocalStorage) Download(ctx context.Context, key string, writer io.Writer, opts *DownloadOptions) error

+ func (l *LocalStorage) DownloadFile(ctx context.Context, key string, localPath string, opts *DownloadOptions) error

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

+ func (l *LocalStorage) GetInfo(ctx context.Context, key string) (*ObjectInfo, error)

+ func (l *LocalStorage) GetSignedURL(ctx context.Context, key string, expiry time.Duration, forUpload bool) (string, error)

+ func (l *LocalStorage) List(ctx context.Context, opts *ListOptions) (*ListResult, error)

+ func (l *LocalStorage) Provider() Provider

+ func (l *LocalStorage) Upload(ctx context.Context, key string, reader io.Reader, size int64, ...) error

+ func (l *LocalStorage) UploadFile(ctx context.Context, key string, localPath string, opts *UploadOptions) error

+ type ObjectInfo struct

+ ContentType string

+ ETag string

+ Key string

+ LastModified time.Time

+ Metadata map[string]string

+ Size int64

+ StorageClass string

+ VersionID string

+ type Provider string

+ const ProviderAzure

+ const ProviderGCS

+ const ProviderLocal

+ const ProviderS3

+ const ProviderSFTP

+ type S3Storage struct

+ func NewS3Storage(ctx context.Context, cfg *Config) (*S3Storage, error)

+ func (s *S3Storage) Bucket() string

+ func (s *S3Storage) Close() error

+ func (s *S3Storage) Copy(ctx context.Context, srcKey, dstKey string) error

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

+ func (s *S3Storage) DeleteMany(ctx context.Context, keys []string) error

+ func (s *S3Storage) Download(ctx context.Context, key string, writer io.Writer, opts *DownloadOptions) error

+ func (s *S3Storage) DownloadFile(ctx context.Context, key string, localPath string, opts *DownloadOptions) error

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

+ func (s *S3Storage) GetInfo(ctx context.Context, key string) (*ObjectInfo, error)

+ func (s *S3Storage) GetSignedURL(ctx context.Context, key string, expiry time.Duration, forUpload bool) (string, error)

+ func (s *S3Storage) List(ctx context.Context, opts *ListOptions) (*ListResult, error)

+ func (s *S3Storage) Provider() Provider

+ func (s *S3Storage) Upload(ctx context.Context, key string, reader io.Reader, size int64, ...) error

+ func (s *S3Storage) UploadFile(ctx context.Context, key string, localPath string, opts *UploadOptions) error

+ type SFTPStorage struct

+ func NewSFTPStorage(cfg *Config) (*SFTPStorage, error)

+ func (s *SFTPStorage) Bucket() string

+ func (s *SFTPStorage) Close() error

+ func (s *SFTPStorage) Copy(ctx context.Context, srcKey, dstKey string) error

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

+ func (s *SFTPStorage) DeleteMany(ctx context.Context, keys []string) error

+ func (s *SFTPStorage) Download(ctx context.Context, key string, writer io.Writer, opts *DownloadOptions) error

+ func (s *SFTPStorage) DownloadFile(ctx context.Context, key string, localPath string, opts *DownloadOptions) error

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

+ func (s *SFTPStorage) GetInfo(ctx context.Context, key string) (*ObjectInfo, error)

+ func (s *SFTPStorage) GetSignedURL(ctx context.Context, key string, expiry time.Duration, forUpload bool) (string, error)

+ func (s *SFTPStorage) List(ctx context.Context, opts *ListOptions) (*ListResult, error)

+ func (s *SFTPStorage) Provider() Provider

+ func (s *SFTPStorage) Upload(ctx context.Context, key string, reader io.Reader, size int64, ...) error

+ func (s *SFTPStorage) UploadFile(ctx context.Context, key string, localPath string, opts *UploadOptions) error

+ type Storage interface

+ Bucket func() string

+ Close func() error

+ Copy func(ctx context.Context, srcKey, dstKey string) error

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

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

+ Download func(ctx context.Context, key string, writer io.Writer, opts *DownloadOptions) error

+ DownloadFile func(ctx context.Context, key string, localPath string, opts *DownloadOptions) error

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

+ GetInfo func(ctx context.Context, key string) (*ObjectInfo, error)

+ GetSignedURL func(ctx context.Context, key string, expiry time.Duration, forUpload bool) (string, error)

+ List func(ctx context.Context, opts *ListOptions) (*ListResult, error)

+ Provider func() Provider

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

+ UploadFile func(ctx context.Context, key string, localPath string, opts *UploadOptions) error

+ func New(ctx context.Context, cfg *Config) (Storage, error)

+ type UploadOptions struct

+ ACL string

+ Concurrency int

+ ContentType string

+ KMSKeyID string

+ Metadata map[string]string

+ PartSize int64

+ ProgressFunc func(bytesUploaded, totalBytes int64)

+ ServerSideEncryption string

+ StorageClass string