Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

gNMI update with explicit deletion #201

Merged
merged 5 commits into from
Jul 10, 2024
Merged

gNMI update with explicit deletion #201

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
ce87e31
Update gnmi-specification.md
gwizdms Nov 7, 2023
2ed4b34
Update gnmi-specification.md
gwizdms Nov 7, 2023
5ef3f11
Merge branch 'openconfig:master' into gwizdms-patch-explicit-deletion
gwizdms Feb 5, 2024
0c89517
Update gnmi-specification.md
gwizdms Feb 5, 2024
42f7fa4
Update gnmi-specification.md
gwizdms May 30, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions rpc/gnmi/gnmi-specification.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1699,6 +1699,18 @@ Where a node within the subscribed paths has been removed, the `delete` field of
the `Notification` message MUST have the path of the node that has been removed
appended to it.

Explicit deletion is required to signify the removal of a leaf that is no longer
present on a target device in ON-CHANGE subscription mode, and optional in SAMPLE subscription mode.

Additionally, deletes are not required to be per-leaf and can be at an intermediate
branch that applies to a multitude of leaves, e.g. when removing a logical interface
in a configuration, deletes could be issued at container level branches that apply to
that interface, rather than all the individual leaves.

Explicit deletion also applies to TARGET-DEFINED subscription mode.
Whereas, if the TARGET-DEFINED subscription determines the best type of delivery to be ON-CHANGE,
explicit deletion is required and if decided to be SAMPLE, deletion will be optional.

To replace the contents of an entire node within the tree, the target populates
the `delete` field with the path of the node being removed, along with the new
contents within the `update` field.
Expand Down