Skip to content

OSS

Aliyun Object Storage Service (OSS) provides massively scalable object storage. Day-to-day operations use ossutil (the dedicated CLI); aliyun oss is also supported via OpenAPI.

Storage Classes

ClassUse CaseMinimum Storage
StandardHot data, frequent accessNone
Infrequent Access (IA)Cool data, occasional access30 days
ArchiveCold data, rare access60 days
Cold ArchiveColdest, very rarely accessed180 days
Deep Cold ArchiveLong-term retention180 days

CLI

Buckets

bash
ossutil mb oss://BUCKET_NAME --storage-class Standard --acl private
ossutil ls oss://
ossutil stat oss://BUCKET_NAME
ossutil rb oss://BUCKET_NAME
ossutil rb oss://BUCKET_NAME -r -f                # delete recursively

# Bucket policy / ACL
ossutil bucket-policy --method put oss://BUCKET_NAME policy.json
ossutil bucket-policy --method get oss://BUCKET_NAME
ossutil set-acl oss://BUCKET_NAME public-read --bucket

Objects

bash
ossutil cp LOCAL_FILE oss://BUCKET_NAME/PREFIX/
ossutil cp oss://BUCKET_NAME/KEY ./
ossutil cp -r LOCAL_DIR oss://BUCKET_NAME/PREFIX/  # recursive upload
ossutil cp -r oss://SRC/ oss://DST/                # copy between buckets

ossutil ls oss://BUCKET_NAME/PREFIX/
ossutil stat oss://BUCKET_NAME/KEY
ossutil rm oss://BUCKET_NAME/KEY
ossutil rm -r -f oss://BUCKET_NAME/PREFIX/         # bulk delete

Sync

bash
ossutil sync LOCAL_DIR oss://BUCKET_NAME/PREFIX/
ossutil sync oss://BUCKET_NAME/PREFIX/ LOCAL_DIR
ossutil sync --delete LOCAL_DIR oss://BUCKET_NAME/PREFIX/   # mirror, deletes extras

Multipart Upload

bash
# Large files split automatically; tune part size and concurrency
ossutil cp BIG_FILE oss://BUCKET_NAME/ --part-size 16777216 --parallel 8

# Inspect / resume / abort uncommitted uploads
ossutil ls oss://BUCKET_NAME/ -m
ossutil rm oss://BUCKET_NAME/ -m -r -f             # abort all incomplete

Signed URLs

bash
ossutil sign oss://BUCKET_NAME/KEY --timeout 3600  # presigned GET, 1 hour

Lifecycle Rules

bash
ossutil lifecycle --method put oss://BUCKET_NAME lifecycle.json
ossutil lifecycle --method get oss://BUCKET_NAME
ossutil lifecycle --method delete oss://BUCKET_NAME

Reference:

  1. Official Website
  2. ossutil Documentation

Power by VitePress & Vue