Skip to content

Commit 23627ed

Browse files
authored
feat(AIP-134): Make update_mask field must be optional (#1327)
* update aip-134 guidance to state update_mask field must be optional * add changelog
1 parent 60e40af commit 23627ed

1 file changed

Lines changed: 4 additions & 4 deletions

File tree

aip/general/0134.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -100,10 +100,9 @@ message UpdateBookRequest {
100100
called `update_mask`.
101101
- The fields used in the field mask correspond to the resource being updated
102102
(not the request message).
103-
- The field **may** be required or optional. If it is required, it **must**
104-
include the corresponding annotation. If optional, the service **must**
105-
treat an omitted field mask as an implied field mask equivalent to all
106-
fields that are populated (have a non-empty value).
103+
- The field **must** be optional, and the service **must** treat an omitted
104+
field mask as an implied field mask equivalent to all fields that are
105+
populated (have a non-empty value).
107106
- Update masks **must** support a special value `*`, meaning full replacement
108107
(the equivalent of `PUT`).
109108
- The request message **must not** contain any other required fields, and
@@ -298,6 +297,7 @@ does not exist, the service **must** error with `NOT_FOUND` (HTTP 404) unless
298297

299298
## Changelog
300299

300+
- **2024-03-14**: Make `update_mask` optional field_behaviour guidance a **must**.
301301
- **2023-08-26**: Adding consistency requirement.
302302
- **2023-07-17**: Make `update_mask` name guidance a **must**.
303303
- **2022-11-04**: Aggregated error guidance to AIP-193.

0 commit comments

Comments
 (0)