AIStoreThis guide demonstrates three ways to evict remote bucket content from AIStore using the ais evict command.
You can:
The template is usually an optional prefix, range (Bash expansion, e.g.,
{start..end}), and optional suffix.
To completely remove a remote bucket from AIStore—including its metadata—run ais evict without --keep-md.
This operation removes all cached content and the bucket’s entry from AIStore’s bucket metadata (BMD).
Check eviction job status (it usually completes in a split second, so use --all to show finished jobs):
To remove only the in-cluster objects while retaining the bucket metadata, use --keep-md (or -k):
This is useful for reclaiming space without losing bucket properties.
Confirm the bucket is still in-cluster:
Check eviction job status (use -all to show running and already finished jobs):
You can evict subsets of objects by specifying:
--template pattern (e.g., brace expansions)--list of object namesAssume we’ve prefetched objects under the copy prefix:
Verify data was cached:
Notice 200 “cached” (ie., in-cluster) objects. Now evict just that prefix:
Or alternatively, use an explicit prefix:
You can also use brace-expansion syntax, e.g.
ais evict "s3://abc/shard-{0000..9999}.tar.lz4; see--helpfor details.
Check progress and notice that each target reports eviction statistics—object counts and their sizes.
This is because prefix-, template-, or list-based eviction requires AIStore to visit each matching object individually.
Example output:
In this particular case, 3-node cluster reported
(69+61+70) = 200evictions, consistent withais bucket summaryabove.
Use ais show job --all to monitor and verify jobs.