From 063a4cb8588bb21faa6397a7db8b5ebc59c387de Mon Sep 17 00:00:00 2001 From: Willow Chargin Date: Mon, 28 Oct 2024 15:35:33 -0700 Subject: [PATCH] AIP-121: List responses contain the resource 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. --- aip/general/0121.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/aip/general/0121.md b/aip/general/0121.md index e83507dba..bbbee20e4 100644 --- a/aip/general/0121.md +++ b/aip/general/0121.md @@ -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