tencent-cos-uploader（腾讯 cos 上传者）

Tencent COS Uploader

Overview

Use Tencent COS Python SDK to upload a local file and return presigned URLs for browser preview and file download.

Prerequisites

1. Install dependency:

pip install cos-python-sdk-v5

1. Prepare COS credentials (env vars preferred):

• COS_SECRET_ID
• COS_SECRET_KEY
• COS_REGION
• COS_BUCKET
• COS_SESSION_TOKEN (optional, for temporary credentials)

Workflow

1. Confirm required inputs:

- region (from --region or env) - bucket (from --bucket or env) - --file local file path - --key object key in bucket (default is filename)

1. Run the script:

python3 scripts/cos_upload_and_presign.py \
  --region ap-guangzhou \
  --bucket my-bucket-1250000000 \
  --file /absolute/path/to/file.pdf \
  --key reports/2026/file.pdf \
  --expires 3600

1. Return JSON output containing:

- view_url: GET presigned URL for viewing - download_url: presigned URL with attachment disposition - upload_result: SDK upload response

Script Parameters

• --region COS region, optional if COS_REGION exists
• --bucket bucket name with appid suffix, optional if COS_BUCKET exists
• --file local file path to upload, required
• --key object key in bucket, optional
• --expires URL expiration seconds, default 3600
• --secret-id optional if COS_SECRET_ID exists
• --secret-key optional if COS_SECRET_KEY exists
• --session-token optional if COS_SESSION_TOKEN exists
• --scheme https or http, default https
• --download-filename custom filename for download prompt (optional)

Notes

• Keep expires as short as practical to reduce link leakage risk.
• download_url is generated via get_presigned_download_url; view_url is generated via get_presigned_url(Method='GET').
• If --key is omitted, the script uses the source filename as object key.