Removing Artifacts

Removing from Catalog and Backing Storage

If you wish to remove an artifact from the Catalog, you can use the following command line tool:

./build/ark-catalog-ingest-tool \
    --schedule-artifact-removal a0255f8c-ddc2-4281-ae59-3999bf5cd630 \
    --artifact-removal-time 1732496400

This will schedule the given artifact for removal at the specified time (in Unix epoch, UTC). This is just the approximate time the artifact will be removed – it will be removed no earlier than that time, but may not be removed for some number of hours after the given date.

If this is a log, the original manifest will be erased, and any “orphaned” split files (split files not referenced by any other manifest) will also be erased.

Any “catalog managed” file (such as external attachments) will also be erased.

You can cancel the removal by setting the artifact removal time to 0.

By default, artifacts that are scheduled for removal are not returned in normal queries. You can adjust this by using the following queries:

  • removed:show - Make all ‘scheduled for removal’ artifacts visible.
  • removed:only - Only show scheduled for removal artifacts.
  • removed:hidden - Default behavior, hide all ‘scheduled for removal’ artifacts.

In any case, you can still describe (or download) scheduled for removal artifacts until they are completely removed from the system.