Skip to content

Commit 27e63a2

Browse files
authored
Fix(AIP-233): Change the recommendation to allow returning partial (#1071)
successes.
1 parent b5e24a2 commit 27e63a2

1 file changed

Lines changed: 6 additions & 2 deletions

File tree

aip/general/0233.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,10 +39,12 @@ rpc BatchCreateBooks(BatchCreateBooksRequest) returns (BatchCreateBooksResponse)
3939
the collection used for simple CRUD operations. If the operation spans
4040
parents, a dash (`-`) **may** be accepted as a wildcard.
4141
- The body clause in the `google.api.http` annotation **should** be `"*"`.
42-
- The operation **must** be atomic: it **must** fail for all resources or
42+
- The operation **should** be atomic: it **should** fail for all resources or
4343
succeed for all resources (no partial success).
4444
- If the operation covers multiple locations and at least one location is
4545
down, the operation **must** fail.
46+
- In cases where supporting partial responses cannot be avoided, the design
47+
should follow the guidelines of [AIP-193](https://aip.dev/193).
4648

4749
### Request message
4850

@@ -114,7 +116,9 @@ message BatchCreateBooksResponse {
114116

115117
## Changelog
116118

117-
- **2022-06-02:** Changed suffix descriptions to eliminate superfluous "-".
119+
- **2023-04-18**: Changed the recommendation to allow returning partial
120+
successes.
121+
- **2022-06-02**: Changed suffix descriptions to eliminate superfluous "-".
118122
- **2020-09-16**: Suggested annotating `parent` and `requests` fields.
119123
- **2020-08-27**: Removed parent recommendations for top-level resources.
120124
- **2019-08-01**: Changed the examples from "shelves" to "publishers", to

0 commit comments

Comments
 (0)