OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add tigrisdata/skills --skill tigris-bucket-management
Use when creating, listing, inspecting, or deleting Tigris Storage buckets
npx skills add tigrisdata/skills --skill tigris-bucket-management
Before doing anything else, install the Tigris CLI if it's not already available:
If you need to install it, tell the user: "I'm installing the Tigris CLI (@tigrisdata/cli) so we can work with Tigris object storage."
Buckets are containers for objects. This skill covers bucket lifecycle: create, list, inspect, and delete.
| Operation | Function | Key Parameters |
|---|---|---|
| Create | createBucket(name, options) | name, access, region, enableSnapshot |
| List | listBuckets(options) | limit, paginationToken |
| Inspect | getBucketInfo(name) | bucketName |
| Delete | removeBucket(name, options) | bucketName, force |
| Option | Values | Default | Purpose |
|---|---|---|---|
| access | public/private | private | Object readability |
| consistency | default/strict | default | Read consistency level |
| defaultTier | STANDARD/STANDARD_IA/GLACIER/GLACIER_IR | STANDARD | Default storage tier |
| enableSnapshot | boolean | false | Enable snapshots/forking |
| region | string | global | Bucket region |
| sourceBucketName | string | - | Fork from this bucket |
| sourceBucketSnapshot | string | - | Fork from this snapshot |
Note: Snapshot-enabled buckets must use STANDARD tier.
Warning: Force delete is irreversible. All objects will be lost.
| Level | Behavior | Use Case |
|---|---|---|
| private | Objects require auth | Default, sensitive data |
| public | Objects publicly readable | Static assets, public content |
| Level | Behavior | Trade-off |
|---|---|---|
| default | Low latency, eventual consistency | Most workloads |
| strict | Strong consistency, higher latency | Critical data |
| Tier | Use Case | Cost |
|---|---|---|
| STANDARD | General purpose | Standard |
| STANDARD_IA | Infrequently accessed | Lower cost |
| GLACIER | Long-term archive | Lowest cost |
| GLACIER_IR | Rare access, fast retrieval | Archive with occasional access |
Specify region for data locality or compliance:
Leave empty for global bucket (recommended for most use cases).
| Mistake | Fix |
|---|---|
| Enable snapshot with non-STANDARD tier | Snapshot requires STANDARD tier |
| Not checking bucket exists before delete | Use getBucketInfo first |
| Trying to delete non-empty bucket without force | Use force: true or empty bucket first |
| Name conflicts | Bucket names must be globally unique |
For version control (snapshots/forking), see the tigris-snapshots-forking skill.
import { listBuckets } from "@tigrisdata/storage";
// List all buckets
const result = await listBuckets();
if (result.error) {
console.error("Error:", result.error);
} else {
console.log("Buckets:", result.data?.buckets);
console.log("Owner:", result.data?.owner);
}
// Paginated list
const allBuckets = [];
let currentPage = await listBuckets({ limit: 10 });
allBuckets.push(...currentPage.data?.buckets);
while (currentPage.data?.paginationToken) {
currentPage = await listBuckets({
limit: 10,
paginationToken: currentPage.data?.paginationToken,
});
allBuckets.push(...currentPage.data?.buckets);
}import { getBucketInfo } from "@tigrisdata/storage";
const result = await getBucketInfo("my-bucket");
if (result.error) {
console.error("Error:", result.error);
} else {
console.log("Info:", result.data);
// {
// isSnapshotEnabled: true,
// hasForks: false,
// sourceBucketName: undefined,
// sourceBucketSnapshot: undefined
// }
}import { removeBucket } from "@tigrisdata/storage";
// Delete empty bucket
const result = await removeBucket("my-bucket");
if (result.error) {
console.error("Error:", result.error);
} else {
console.log("Deleted successfully");
}
// Force delete (even if not empty)
const result = await removeBucket("my-bucket", {
force: true,
});await createBucket("data-eu", { region: "eu" });
await createBucket("data-asia", { region: "asia-south-1" });