volcengine-storage-tos_skill

Overview

This skill provides object storage operations for Volcengine TOS, focused on reliable uploads, downloads, synchronization, and permission checks. It helps map explicit paths, verify authentication and bucket policies, and produce actionable result manifests. The skill emphasizes non-destructive behavior and data integrity checks. Use it to automate common storage workflows with clear verification and audit-friendly outputs.

How this skill works

The skill inspects bucket names, region settings, and object paths before performing any action. It validates credentials and bucket policy permissions, then executes uploads, downloads, or sync tasks while preserving metadata and content types. For each operation it returns a result manifest listing object keys, public or signed URLs, checksums, and sizes. Destructive operations require explicit confirmation inputs and the skill performs size/checksum verification when available.

When to use it

• Upload large directories or single objects while preserving metadata and content-type.
• Download objects or sync buckets between local storage and TOS with path mapping.
• Generate signed URLs for temporary access to private objects.
• Verify bucket policies and permission issues before running bulk operations.
• Troubleshoot transfer failures with manifest-level checksums and URLs.

Best practices

• Always confirm bucket name, region, and object paths in the request to avoid mistakes.
• Require explicit confirmation for any destructive delete actions; default to non-destructive mode.
• Preserve original metadata and content-type on uploads to maintain downstream behavior.
• Use checksums or object size verification to validate successful transfers.
• Request signed URLs only when temporary access is needed and set short expirations for security.

Example use cases

• Sync a local archive folder to a TOS bucket while preserving object metadata and generating a manifest of uploaded keys and checksums.
• Generate a set of signed URLs for a batch of private objects to share with temporary access.
• Run a pre-flight permission check to confirm that the provided credentials can list, read, and write to the target bucket.
• Download a subset of objects using explicit path mapping and verify sizes against the manifest.
• Troubleshoot failed uploads by comparing returned checksums and sizes to local files.