Done Criteria

filecoin-pin rm --piece $pieceCid --data-set $dataSetId will cause the provided piece to be remoeved from the provided dataset.

Why Important

Usecases we're aware of:
1, remove old pieces so stop getting charged, especially since we don't have deduplication
2. easily handle takedown requests

Notes

1. We're only handling the case where the user specifies the dataSetId and pieceId. A user will likely need to use Add data-set subcommand with --ls #7 find the dataSetId of their pieceCid. More user friendly interactive options of showing a user the data sets that a given piece are not in scope, and separate issue(s) can be created for them.
2. Terminating a dataSet is happening in Add data-set $dataSetId --terminate #189
3. The original issue description is below. It's put here so there is context for most of the followup comments.

Original issue description (outdated now)

• --delete to delete a whole data set (pending allow a client to terminate a service FilOzone/synapse-sdk#199), could come up with a better name for this?
• --delete-piece to delete a PieceCID from a data set

To consider: how to deal with the hierarchy of data set -> piece; if you want to delete a piece from a specific data set how do you specify this? e.g. you accidentally added the same piece to two data sets, you should be able to remove one of them.

Perhaps a --data-set is a mandatory part of the --delete and --delete-piece operations?