Delete a plan
DELETE/v1/plans/:id
Stops the plan. Its backups stay restorable until they expire, unless with_points is set, which deletes them too. Only an operator can delete a plan under a mandatory policy. The answer is 202 with the deletion when the plan is kept for an operator to undelete, and always with with_points. Without with_points, a plan whose repository keeps deleted plans for no grace period, or whose policy no longer exists, is removed at once. The answer is then 204 with no body.
Any member of the project the token is scoped to.
Request
Responses
- 202
- 400
- 401
- 403
- 404
- 409
- default
Accepted
Bad Request.
invalid_request: A query parameter is malformed.
Unauthorized.
unauthenticated: The token is missing, expired or not valid.
Forbidden.
forbidden: The token's roles do not allow deleting plans. Or the plan is under a mandatory policy and the token is not an operator's.
Not Found.
not_found: No plan has this id, it belongs to another project, or it is already deleted.
Conflict.
conflict: with_points is true and a legal hold covers one of the plan's backups.
An error, as an RFC 7807 problem document.