Skip to content

Commit 5209e64

Browse files
authored
fix(AIP-151): Clarify error propagation behavior for failures that occur during long-running operations. (#1477)
1 parent e8a5e90 commit 5209e64

1 file changed

Lines changed: 9 additions & 3 deletions

File tree

aip/general/0151.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -120,9 +120,13 @@ has elapsed after the operation completed.
120120
Errors that prevent a long-running operation from _starting_ **must** return an
121121
error response ([AIP-193][]), similar to any other method.
122122

123-
Errors that occur over the course of an operation **may** be placed in the
124-
metadata message. The errors themselves **must** still be represented with a
125-
[google.rpc.Status][] object.
123+
Operations that fail during their execution phase **must** return an
124+
error response ([AIP-193][]), placed in the `Operation.error` [google.rpc.Status][]
125+
field.
126+
127+
Non-terminal errors that occur over the course of an operation **may** be placed
128+
in the metadata message and the field(s) **must** be [AIP-193][] compliant
129+
[google.rpc.Status][].
126130

127131
### Backwards compatibility
128132

@@ -163,6 +167,8 @@ updated status) but server don't need to maintain any additional state.
163167

164168
## Changelog
165169

170+
- **2025-02-04**: Clarified error propagation behavior for failures
171+
that occur during long-running operations.
166172
- **2024-04-23**: Provided pattern for validation on RPCs returning
167173
long-running operations.
168174
- **2022-05-31**: Added compatibility section.

0 commit comments

Comments
 (0)