Documentation
¶
Overview ¶
Package obs provides a Huawei Cloud OBS (S3-compatible) Store implementation.
Index ¶
- type Config
- type Store
- func (s *Store) AbortMultipartUpload(bucket, key, uploadID string) error
- func (s *Store) CompleteMultipartUpload(bucket, key string, req *stores.CompleteMultipartUploadRequest) (*stores.CompleteMultipartUploadResponse, error)
- func (s *Store) CopyFile(req *stores.CopyObjectRequest) error
- func (s *Store) CreateBucket(req *stores.CreateBucketRequest) error
- func (s *Store) Delete(key string) error
- func (s *Store) DeleteBucket(bucket string) error
- func (s *Store) DeleteFile(bucket, key string) error
- func (s *Store) Exists(key string) (bool, error)
- func (s *Store) GetAPIRequestStats(req *stores.APIStatsRequest) (*stores.APIStatsResponse, error)
- func (s *Store) GetBucketDomains(bucket string) ([]string, error)
- func (s *Store) GetBucketInfo(bucket string) (*stores.BucketInfo, error)
- func (s *Store) GetBucketStats(bucket string) (*stores.BucketStats, error)
- func (s *Store) GetCDNStats(req *stores.CDNStatsRequest) (*stores.CDNStatsResponse, error)
- func (s *Store) GetFileInfo(bucket, key string) (*stores.FileInfo, error)
- func (s *Store) GetFileURL(bucket, key string, expires time.Duration) (string, error)
- func (s *Store) GetOriginFetchStats(req *stores.OriginStatsRequest) (*stores.OriginStatsResponse, error)
- func (s *Store) InitiateMultipartUpload(bucket string, req *stores.InitiateMultipartUploadRequest) (*stores.InitiateMultipartUploadResponse, error)
- func (s *Store) ListBuckets(req *stores.ListBucketsRequest) (*stores.ListBucketsResponse, error)
- func (s *Store) ListFiles(bucket string, req *stores.ListFilesRequest) (*stores.ListFilesResponse, error)
- func (s *Store) ListParts(bucket, key string, req *stores.ListPartsRequest) (*stores.ListPartsResponse, error)
- func (s *Store) MoveFile(req *stores.CopyObjectRequest) error
- func (s *Store) PresignUpload(key, contentType string, expires time.Duration) (*stores.DirectUpload, error)
- func (s *Store) PublicURL(key string) string
- func (s *Store) Read(key string) (io.ReadCloser, int64, error)
- func (s *Store) SetBucketPrivate(bucket string, isPrivate bool) error
- func (s *Store) SignedURL(key string, expires time.Duration) (string, error)
- func (s *Store) UploadFile(bucket, key string, reader io.Reader, size int64) error
- func (s *Store) UploadPart(bucket, key string, req *stores.UploadPartRequest) (*stores.UploadPartResponse, error)
- func (s *Store) Write(key string, r io.Reader) error
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Config ¶
type Config struct {
Endpoint string
Region string
AccessKeyID string
AccessKeySecret string
BucketName string
ProxyDomain string // optional proxy domain for public access
}
Config holds Huawei Cloud OBS storage configuration.
type Store ¶
type Store struct {
// contains filtered or unexported fields
}
Store implements stores.Store backed by Huawei Cloud OBS.
func (*Store) AbortMultipartUpload ¶
AbortMultipartUpload cancels a multipart upload.
func (*Store) CompleteMultipartUpload ¶
func (s *Store) CompleteMultipartUpload(bucket, key string, req *stores.CompleteMultipartUploadRequest) (*stores.CompleteMultipartUploadResponse, error)
CompleteMultipartUpload finalizes a multipart upload.
func (*Store) CopyFile ¶
func (s *Store) CopyFile(req *stores.CopyObjectRequest) error
CopyFile copies an object within or across OBS buckets.
func (*Store) CreateBucket ¶
func (s *Store) CreateBucket(req *stores.CreateBucketRequest) error
CreateBucket creates a new OBS bucket. Unlike S3, OBS does not use LocationConstraint via CreateBucketConfiguration — the bucket is created on the configured endpoint.
func (*Store) DeleteBucket ¶
DeleteBucket deletes an empty OBS bucket.
func (*Store) DeleteFile ¶
DeleteFile deletes an object from an OBS bucket.
func (*Store) GetAPIRequestStats ¶
func (s *Store) GetAPIRequestStats(req *stores.APIStatsRequest) (*stores.APIStatsResponse, error)
GetAPIRequestStats returns API request statistics. Huawei Cloud OBS does not expose granular API request metrics via the standard SDK; this returns ErrStatsUnsupported.
func (*Store) GetBucketDomains ¶
GetBucketDomains returns the domain names associated with an OBS bucket. For OBS, this returns the proxy domain if configured, otherwise the default endpoint-based domain.
func (*Store) GetBucketInfo ¶
func (s *Store) GetBucketInfo(bucket string) (*stores.BucketInfo, error)
GetBucketInfo returns metadata about an OBS bucket.
func (*Store) GetBucketStats ¶
func (s *Store) GetBucketStats(bucket string) (*stores.BucketStats, error)
GetBucketStats computes the total storage size and object count for an OBS bucket by paginating ListObjectsV2.
func (*Store) GetCDNStats ¶
func (s *Store) GetCDNStats(req *stores.CDNStatsRequest) (*stores.CDNStatsResponse, error)
GetCDNStats returns CDN statistics from the Huawei Cloud CDN API.
func (*Store) GetFileInfo ¶
GetFileInfo returns metadata for a single OBS object.
func (*Store) GetFileURL ¶
GetFileURL returns an expiring URL for an OBS object.
func (*Store) GetOriginFetchStats ¶
func (s *Store) GetOriginFetchStats(req *stores.OriginStatsRequest) (*stores.OriginStatsResponse, error)
GetOriginFetchStats returns origin-fetch statistics from the Huawei Cloud CDN API (ShowDomainStats with bs_flux and bs_num metrics).
func (*Store) InitiateMultipartUpload ¶
func (s *Store) InitiateMultipartUpload(bucket string, req *stores.InitiateMultipartUploadRequest) (*stores.InitiateMultipartUploadResponse, error)
InitiateMultipartUpload starts a multipart upload.
func (*Store) ListBuckets ¶
func (s *Store) ListBuckets(req *stores.ListBucketsRequest) (*stores.ListBucketsResponse, error)
ListBuckets lists all OBS buckets.
func (*Store) ListFiles ¶
func (s *Store) ListFiles(bucket string, req *stores.ListFilesRequest) (*stores.ListFilesResponse, error)
ListFiles lists objects in an OBS bucket.
func (*Store) ListParts ¶
func (s *Store) ListParts(bucket, key string, req *stores.ListPartsRequest) (*stores.ListPartsResponse, error)
ListParts lists the parts of a multipart upload.
func (*Store) MoveFile ¶
func (s *Store) MoveFile(req *stores.CopyObjectRequest) error
MoveFile moves an object within or across OBS buckets.
func (*Store) PresignUpload ¶
func (s *Store) PresignUpload(key, contentType string, expires time.Duration) (*stores.DirectUpload, error)
PresignUpload implements stores.DirectUploadPresigner via a presigned PUT.
func (*Store) SetBucketPrivate ¶
SetBucketPrivate sets the ACL of an OBS bucket.
func (*Store) UploadFile ¶
UploadFile uploads data to an OBS bucket.
func (*Store) UploadPart ¶
func (s *Store) UploadPart(bucket, key string, req *stores.UploadPartRequest) (*stores.UploadPartResponse, error)
UploadPart uploads a single part of a multipart upload.