tos

Query TOS object storage buckets, list objects, and generate download URLs via ByteCloud gateway.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill tos-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tos
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/tos
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill tos-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Locating objects and obtaining download links in TOS (Object Storage) normally requires navigating internal consoles across multiple regions. This Skill lets you list favorite or viewable buckets, browse objects inside a bucket, and generate download URLs directly through the ByteCloud gateway. ## Core Features & Use Cases - Bucket Discovery: List favorited or all viewable TOS buckets with pagination across regions like China-North, China-BOE, Singapore-Central, and US-East. - Object Browsing: List objects within a bucket using prefix filters and cursor-based pagination via lastkey. - Download URL Generation: Produce external download links (via bucket_name) and internal API download links (via bucket_id) for any object. - Use Case: You need to share a build artifact stored in TOS with a teammate. List your favorite buckets, find the bucket, list its objects to locate the artifact key, then generate a download URL to share. ## Quick Start Ask the agent to list your favorite TOS buckets in the China-North region, then get a download URL for a specific object in one of those buckets.

Frequently Asked Questions about tos

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list objects in a TOS bucket?

Use the list_objects action with the numeric bucket_id obtained from a bucket list response. You can filter results with a prefix parameter and paginate by passing the last object's key as lastkey when has_more is true.

How to get a download URL for a TOS object?

Call the get_download_url action with the object_key plus either bucket_name for an external download URL or bucket_id for an internal API download URL. Providing both returns both link types in one response.

What is the difference between bucket_id and bucket_name in TOS?

bucket_id is the numeric identifier required by list_objects and for internal og_download_url links. bucket_name is the string name used to construct external download_url links via the object_download_url prefix.

Which TOS regions are supported by the ByteCloud gateway?

Supported regions include China-North (default), China-BOE, US-BOE, Singapore-Central, and US-East. Short aliases like cn, boe, sg, and us can be passed as the vregion parameter.

Why does TOS authentication fail when running queries?

Authentication failures usually indicate a JWT token issue with the ByteCloud gateway. Verify your network connectivity and confirm you are logged in by running gdpa-cli login before retrying the query.