Skip to content

Commit

Permalink
AIP-121: List responses contain the resource
Browse files Browse the repository at this point in the history
AIP-132 documents the guidance for List responses, which *contain* the
resource as a `repeated` field, along with pagination information. This
patch updates AIP-121 to consistently indicate that the List request
merely contains the resource rather than being the resource, which
wouldn't make sense since the point of a List request is to enumerate
multiple such resources.
  • Loading branch information
wchargin committed Oct 28, 2024
1 parent 8cb7bb2 commit 063a4cb
Showing 1 changed file with 7 additions and 7 deletions.
14 changes: 7 additions & 7 deletions aip/general/0121.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,13 +65,13 @@ If the request to or the response from a standard method (or a custom method in
the same *service*) **is** the resource or **contains** the resource, the
resource schema for that resource across all methods **must** be the same.

| Standard method | Request | Response |
| --------------- | --------------------- | --------------- |
| Create | Contains the resource | Is the resource |
| Get | None | Is the resource |
| Update | Contains the resource | Is the resource |
| Delete | None | None |
| List | None | Is the resource |
| Standard method | Request | Response |
| --------------- | --------------------- | ---------------------- |
| Create | Contains the resource | Is the resource |
| Get | None | Is the resource |
| Update | Contains the resource | Is the resource |
| Delete | None | None |
| List | None | Contains the resources |

*The table above describes each standard method's relationship to the resource,
where "None" indicates that the resource neither **is** nor **is contained** in
Expand Down

0 comments on commit 063a4cb

Please sign in to comment.