Skip to content

Commit c4a2415

Browse files
authored
Merge pull request #41304 from Ritikaa96/finalizers-update
Updating Finalizers information
2 parents 096a657 + 5f8e3d7 commit c4a2415

File tree

1 file changed

+11
-1
lines changed
  • content/en/docs/concepts/overview/working-with-objects

1 file changed

+11
-1
lines changed

content/en/docs/concepts/overview/working-with-objects/finalizers.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ and does the following:
2626

2727
* Modifies the object to add a `metadata.deletionTimestamp` field with the
2828
time you started the deletion.
29-
* Prevents the object from being removed until its `metadata.finalizers` field is empty.
29+
* Prevents the object from being removed until all items are removed from its `metadata.finalizers` field
3030
* Returns a `202` status code (HTTP "Accepted")
3131

3232
The controller managing that finalizer notices the update to the object setting the
@@ -45,6 +45,16 @@ controller can't delete it because the finalizer exists. When the Pod stops
4545
using the `PersistentVolume`, Kubernetes clears the `pv-protection` finalizer,
4646
and the controller deletes the volume.
4747

48+
{{<note>}}
49+
* When you `DELETE` an object, Kubernetes adds the deletion timestamp for that object and then
50+
immediately starts to restrict changes to the `.metadata.finalizers` field for the object that is
51+
now pending deletion. You can remove existing finalizers (deleting an entry from the `finalizers`
52+
list) but you cannot add a new finalizer. You also cannot modify the `deletionTimestamp` for an
53+
object once it is set.
54+
55+
* After the deletion is requested, you can not resurrect this object. The only way is to delete it and make a new similar object.
56+
{{</note>}}
57+
4858
## Owner references, labels, and finalizers {#owners-labels-finalizers}
4959

5060
Like {{<glossary_tooltip text="labels" term_id="label">}},

0 commit comments

Comments
 (0)