s3

package

Go to main page

Versions in this module

v0

v0.1.2

Aug 12, 2026

Changes in this version

+ const LifecycleRuleIDSizeLimit

+ const LifecycleStatusDisabled

+ const LifecycleStatusEnabled

+ const VersioningStatusEnabled

+ const VersioningStatusSuspended

+ func FormatVersion(versionID string) string

+ type AbortIncompleteMultipartUpload struct

+ DaysAfterInitiation int

+ func (a *AbortIncompleteMultipartUpload) AbortCutoff(now time.Time, dayDuration time.Duration) time.Time

type Backend

+ BackupSQLite3 func(ctx context.Context, destPath string) error

+ DeleteBucketLifecycleConfiguration func(ctx context.Context, accessKeyID, bucket string) error

+ FlushObjects func(ctx context.Context) error

+ GetBucketLifecycleConfiguration func(ctx context.Context, accessKeyID, bucket string) (LifecycleConfiguration, error)

+ GetBucketVersioning func(ctx context.Context, accessKeyID, bucket string) (status string, err error)

+ ListObjectVersions func(ctx context.Context, accessKeyID *string, bucket string, prefix Prefix, ...) (*ObjectVersionsListResult, error)

+ PutBucketLifecycleConfiguration func(ctx context.Context, accessKeyID, bucket string, config LifecycleConfiguration) error

+ PutBucketVersioning func(ctx context.Context, accessKeyID, bucket, status string) error

+ type BackupSQLite3Request struct

+ Path string

type CompleteMultipartUploadResult

+ VersionID string

type CopyObjectResult

+ SourceVersionID string

+ type DeleteMarker struct

+ IsLatest bool

+ Key string

+ LastModified ContentTime

+ Owner *UserInfo

+ VersionID string

+ XMLName xml.Name

+ type DeletedObject struct

+ DeleteMarker bool

+ DeleteMarkerVersionID string

+ Key string

+ VersionID string

+ type LifecycleAndOperator struct

+ ObjectSizeGreaterThan *int64

+ ObjectSizeLessThan *int64

+ Prefix *string

+ Tags []LifecycleTag

+ type LifecycleConfiguration struct

+ Rules []LifecycleRule

+ XMLName xml.Name

+ Xmlns string

+ func (c LifecycleConfiguration) ExpirationHeader(objectKey string, lastModified time.Time) string

+ func (c LifecycleConfiguration) Validate() error

+ type LifecycleExpiration struct

+ Date string

+ Days int

+ ExpiredObjectDeleteMarker *bool

+ func (e *LifecycleExpiration) ExpiryCutoff(now time.Time, dayDuration time.Duration) (cutoff time.Time, ok bool)

+ type LifecycleFilter struct

+ And *LifecycleAndOperator

+ ObjectSizeGreaterThan *int64

+ ObjectSizeLessThan *int64

+ Prefix *string

+ Tag *LifecycleTag

+ type LifecycleRule struct

+ AbortIncompleteMultipartUpload *AbortIncompleteMultipartUpload

+ Expiration *LifecycleExpiration

+ Filter *LifecycleFilter

+ ID string

+ NoncurrentVersionExpiration *LifecycleUnsupportedAction

+ NoncurrentVersionTransitions []LifecycleUnsupportedAction

+ Prefix *string

+ Status string

+ Transitions []LifecycleUnsupportedAction

+ func (r LifecycleRule) EffectivePrefix() string

+ func (r LifecycleRule) Enabled() bool

+ type LifecycleTag struct

+ Key string

+ Value string

+ type LifecycleUnsupportedAction struct

+ type ListObjectVersionsPage struct

+ FetchOwner *bool

+ KeyMarker *string

+ MaxKeys int64

+ VersionIDMarker *string

type ListObjectVersionsResult

+ KeyMarker string

type ListObjectsV1Result

+ XMLName xml.Name

type ListObjectsV2Result

+ XMLName xml.Name

type Object

+ IsDeleteMarker bool

+ VersionID string

+ Versioned bool

+ type ObjectVersion struct

+ ETag string

+ IsDeleteMarker bool

+ IsLatest bool

+ Key string

+ LastModified time.Time

+ Owner *UserInfo

+ Size int64

+ VersionID string

+ type ObjectVersionsListResult struct

+ CommonPrefixes []CommonPrefix

+ IsTruncated bool

+ NextKeyMarker string

+ NextVersionIDMarker string

+ Versions []ObjectVersion

+ func NewObjectVersionsListResult(maxKeys int64) *ObjectVersionsListResult

+ func (r *ObjectVersionsListResult) AddPrefix(prefix string)

+ func (r *ObjectVersionsListResult) AddVersion(v ObjectVersion)

+ func (r *ObjectVersionsListResult) Count() int64

type PutObjectResult

+ VersionID string

type UploadPartCopyResult

+ SourceVersionID string

type UploadStats

+ UnpinnedObjects int64

+ type VersionListEntry interface

+ type VersionRequest struct

+ ID string

+ Specified bool

+ func NoVersion() VersionRequest

+ func SpecificVersion(id string) VersionRequest

+ func VersionFromQuery(qv []string) VersionRequest

+ func (v VersionRequest) LogValue() string

+ type VersioningConfiguration struct

+ MfaDelete string

+ Status string

+ XMLName xml.Name

+ Xmlns string

v0.1.1

Jun 11, 2026

v0.1.0

Jun 9, 2026

Changes in this version

+ const DefaultMaxBucketKeys

+ const DefaultMaxMultipartUploads

+ const DefaultMaxUploadListParts

+ const KeySizeLimit

+ const MaxBucketKeys

+ const MaxMultipartUploads

+ const MaxUploadListParts

+ const MaxUploadPartNumber

+ const MaxUploadPartSize

+ const MetadataSizeLimit

+ const MinUploadPartSize

+ const Null

+ func FormatETag(hash []byte, partsCount int) string

+ func New(b Backend, opts ...Option) http.Handler

+ func NewAdmin(b Backend, opts ...Option) http.Handler

+ func ParseETag(s string) [16]byte

+ func ValidateBucketName(name string) error

+ type Backend interface

+ AbortMultipartUpload func(ctx context.Context, accessKeyID, bucket, object string, uploadID UploadID) error

+ CompleteMultipartUpload func(ctx context.Context, accessKeyID, bucket, object string, uploadID UploadID, ...) (*CompleteMultipartUploadResult, error)

+ CopyObject func(ctx context.Context, ...) (*CopyObjectResult, error)

+ CreateBucket func(ctx context.Context, accessKeyID, name string) error

+ CreateMultipartUpload func(ctx context.Context, accessKeyID, bucket, object string, ...) (*CreateMultipartUploadResult, error)

+ DeleteBucket func(ctx context.Context, accessKeyID, name string) error

+ DeleteObject func(ctx context.Context, accessKeyID, bucket string, object ObjectID) (*DeleteObjectResult, error)

+ DeleteObjects func(ctx context.Context, accessKeyID, bucket string, objects []ObjectID) (*ObjectsDeleteResult, error)

+ GetObject func(ctx context.Context, accessKeyID *string, bucket, object string, ...) (*Object, error)

+ HeadBucket func(ctx context.Context, accessKeyID, name string) error

+ HeadObject func(ctx context.Context, accessKeyID *string, bucket, object string, ...) (*Object, error)

+ ListBuckets func(ctx context.Context, accessKeyID string) ([]BucketInfo, error)

+ ListMultipartUploads func(ctx context.Context, accessKeyID, bucket string, ...) (*ListMultipartUploadsResult, error)

+ ListObjects func(ctx context.Context, accessKeyID *string, bucket string, prefix Prefix, ...) (*ObjectsListResult, error)

+ ListParts func(ctx context.Context, accessKeyID, bucket, object string, uploadID UploadID, ...) (*ListPartsResult, error)

+ PutObject func(ctx context.Context, accessKeyID string, bucket, object string, r io.Reader, ...) (*PutObjectResult, error)

+ UploadPart func(ctx context.Context, accessKeyID, bucket, object string, uploadID UploadID, ...) (*UploadPartResult, error)

+ UploadPartCopy func(ctx context.Context, ...) (*UploadPartCopyResult, error)

+ UploadStats func(ctx context.Context) (UploadStats, error)

+ UserInfo func(ctx context.Context, accessKeyID string) (*UserInfo, error)

+ type BucketInfo struct

+ CreationDate ContentTime

+ Name string

+ type CommonPrefix struct

+ Prefix string

+ type CompleteMultipartPart struct

+ ETag string

+ PartNumber int

+ type CompleteMultipartUploadRequest struct

+ Parts []CompleteMultipartPart

+ XMLName xml.Name

+ type CompleteMultipartUploadResponse struct

+ Bucket string

+ ETag string

+ Key string

+ Location string

+ XMLName xml.Name

+ Xmlns string

+ type CompleteMultipartUploadResult struct

+ ContentMD5 [16]byte

+ ETag string

+ type CompletedPart struct

+ ETag [16]byte

+ PartNumber int

+ type Content struct

+ ETag string

+ Key string

+ LastModified ContentTime

+ Owner *UserInfo

+ Size int64

+ StorageClass StorageClass

+ type ContentTime struct

+ func NewContentTime(t time.Time) ContentTime

+ func (c ContentTime) MarshalXML(e *xml.Encoder, start xml.StartElement) error

+ type CopyObjectResult struct

+ ContentMD5 [16]byte

+ LastModified time.Time

+ PartsCount int32

+ VersionID string

+ type CreateMultipartUploadOptions struct

+ Meta map[string]string

+ type CreateMultipartUploadResult struct

+ UploadID UploadID

+ type DeleteObjectResult struct

+ IsDeleteMarker bool

+ VersionID string

+ type DeleteRequest struct

+ Objects []ObjectID

+ Quiet bool

+ type ErrorResponse struct

+ Code string

+ HostID string

+ Message string

+ RequestID string

+ XMLName xml.Name

+ type ErrorResult struct

+ Code string

+ Key string

+ Message string

+ RequestID string

+ Resource string

+ XMLName xml.Name

+ type GetBucketLocation struct

+ LocationConstraint string

+ XMLName xml.Name

+ Xmlns string

+ type HttpTime struct

+ func NewHttpTime(t time.Time) HttpTime

+ func (c *HttpTime) StdTime() time.Time

+ func (c *HttpTime) UnmarshalXML(d *xml.Decoder, start xml.StartElement) error

+ func (c HttpTime) MarshalXML(e *xml.Encoder, start xml.StartElement) error

+ type InitiateMultipartUploadResponse struct

+ Bucket string

+ Key string

+ UploadID string

+ XMLName xml.Name

+ Xmlns string

+ type ListBucketsResponse struct

+ Buckets []BucketInfo

+ Owner *UserInfo

+ XMLName xml.Name

+ Xmlns string

+ type ListMultipartUploadsOptions struct

+ Delimiter string

+ Prefix string

+ type ListMultipartUploadsPage struct

+ KeyMarker string

+ MaxUploads int64

+ UploadIDMarker string

+ type ListMultipartUploadsResponse struct

+ Bucket string

+ CommonPrefixes []CommonPrefix

+ Delimiter string

+ IsTruncated bool

+ KeyMarker string

+ MaxUploads int64

+ NextKeyMarker string

+ NextUploadIDMarker string

+ Prefix string

+ UploadIDMarker string

+ Uploads []ListedMultipartUpload

+ XMLName xml.Name

+ Xmlns string

+ type ListMultipartUploadsResult struct

+ CommonPrefixes []string

+ IsTruncated bool

+ NextKeyMarker string

+ NextUploadIDMarker string

+ Uploads []MultipartUploadInfo

+ type ListObjectVersionsResult struct

+ CommonPrefixes []CommonPrefix

+ Delimiter string

+ IsTruncated bool

+ MaxKeys int64

+ Name string

+ NextKeyMarker string

+ NextVersionIDMarker *string

+ Prefix string

+ VersionIDMarker string

+ Versions []Version

+ XMLName xml.Name

+ Xmlns string

+ type ListObjectsPage struct

+ FetchOwner *bool

+ Marker *string

+ MaxKeys int64

+ type ListObjectsResultBase struct

+ CommonPrefixes []CommonPrefix

+ Contents []*Content

+ Delimiter string

+ EncodingType string

+ IsTruncated bool

+ MaxKeys int64

+ Name string

+ Prefix string

+ XMLName xml.Name

+ Xmlns string

+ type ListObjectsV1Result struct

+ Marker string

+ NextMarker string

+ type ListObjectsV2Result struct

+ ContinuationToken *string

+ KeyCount int64

+ NextContinuationToken string

+ StartAfter string

+ type ListPartsPage struct

+ MaxParts int64

+ PartNumberMarker int

+ type ListPartsResponse struct

+ Bucket string

+ Initiator *UserInfo

+ IsTruncated bool

+ Key string

+ MaxParts int64

+ NextPartNumberMarker int

+ Owner *UserInfo

+ PartNumberMarker int

+ Parts []ListedPartResponse

+ StorageClass StorageClass

+ UploadID string

+ XMLName xml.Name

+ Xmlns string

+ type ListPartsResult struct

+ InitiatorDisplayName string

+ InitiatorID string

+ IsTruncated bool

+ NextPartNumberMarker string

+ OwnerDisplayName string

+ OwnerID string

+ Parts []UploadPart

+ StorageClass StorageClass

+ type ListedMultipartUpload struct

+ Initiated ContentTime

+ Initiator *UserInfo

+ Key string

+ Owner *UserInfo

+ StorageClass StorageClass

+ UploadID string

+ type ListedPartResponse struct

+ ETag string

+ LastModified ContentTime

+ PartNumber int

+ Size int64

+ type MultipartUploadInfo struct

+ Initiated time.Time

+ Key string

+ UploadID UploadID

+ type Object struct

+ Body io.ReadCloser

+ ContentMD5 [16]byte

+ LastModified time.Time

+ Metadata map[string]string

+ PartsCount *int32

+ Range *ObjectRange

+ Size int64

+ type ObjectCopyResult struct

+ ETag string

+ LastModified ContentTime

+ XMLName xml.Name

+ type ObjectID struct

+ ETag *string

+ Key string

+ LastModifiedTime *HttpTime

+ Size *int64

+ VersionID string

+ type ObjectRange struct

+ Length int64

+ Start int64

+ type ObjectRangeRequest struct

+ End int64

+ FromEnd bool

+ Start int64

+ func (o *ObjectRangeRequest) Range(size int64) (*ObjectRange, error)

+ type ObjectsDeleteResult struct

+ Deleted []ObjectID

+ Error []ErrorResult

+ XMLName xml.Name

+ type ObjectsListResult struct

+ CommonPrefixes []CommonPrefix

+ Contents []*Content

+ IsTruncated bool

+ NextMarker string

+ func NewObjectsListResult(maxKeys int64) *ObjectsListResult

+ func (b *ObjectsListResult) Add(item *Content)

+ func (b *ObjectsListResult) AddPrefix(prefix string)

+ type Option func(*s3)

+ func WithHostBucketBases(bases []string) Option

+ func WithLogger(logger *zap.Logger) Option

+ func WithRegion(region string) Option

+ type PartCopyResult struct

+ ETag string

+ LastModified ContentTime

+ XMLName xml.Name

+ type Prefix struct

+ Delimiter string

+ HasDelimiter bool

+ HasPrefix bool

+ Prefix string

+ func (p Prefix) CommonPrefix(key string) string

+ type PutObjectOptions struct

+ ContentLength int64

+ ContentMD5 *[16]byte

+ ContentSHA256 *[32]byte

+ Meta map[string]string

+ type PutObjectResult struct

+ ContentMD5 [16]byte

+ type StorageClass string

+ func (s StorageClass) MarshalXML(e *xml.Encoder, start xml.StartElement) error

+ type UploadID [16]byte

+ func NewUploadID() (uid UploadID)

+ func ParseUploadID(s string) (UploadID, error)

+ func (uid UploadID) String() string

+ type UploadPart struct

+ ContentMD5 [16]byte

+ LastModified time.Time

+ PartNumber int

+ Size int64

+ type UploadPartCopyOptions struct

+ PartNumber int

+ Range ObjectRange

+ type UploadPartCopyResult struct

+ ContentMD5 [16]byte

+ LastModified time.Time

+ type UploadPartOptions struct

+ ContentLength int64

+ ContentMD5 *[16]byte

+ ContentSHA256 *[32]byte

+ PartNumber int

+ type UploadPartResult struct

+ ContentMD5 [16]byte

+ LastModified time.Time

+ type UploadStats struct

+ FailedUploads int64

+ MultipartUploads int64

+ OrphanedObjects int64

+ PendingObjects int64

+ PendingSize int64

+ UploadedObjects int64

+ UploadedSize int64

+ func (s UploadStats) PrometheusMetric() []prometheus.Metric

+ type UserInfo struct

+ DisplayName string

+ ID string

+ type Version struct

+ ETag string

+ IsLatest bool

+ Key string

+ LastModified ContentTime

+ Owner *UserInfo

+ Size int64

+ StorageClass StorageClass

+ VersionID string

+ XMLName xml.Name

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL