aip-dev / google.aip.dev

API Improvement Proposals. https://aip.dev/
Other
1.06k stars 484 forks source link

AIP-135: expansion of force field and enumeration of force-delete reasoning #869

Open noahdietz opened 2 years ago

noahdietz commented 2 years ago

The force field detailed in AIP-135 speaks to supporting the forced deletion of a resource and its child resources via a Standard Delete i.e. cascading delete, where without it the delete would fail as the presence of child resources prevents a parent from being deleted.

However, there are other such scenarios beyond forcing a cascading delete that the force flag should support including:

As such, it may make sense to do one or all of the following:

  1. Expand the accepted uses of force beyond toggling cascading deletion
  2. Introduce the use of a force_reason or delete_behavior field in Standard Delete that is an enum providing more toggles/overrides or desired delete behavior on a per API basis
  3. Introduce a well-known set of acceptable delete behaviors expressed as enums that APIs may introduce
noahdietz commented 2 years ago

cc: @jgeewax @shwoodard