更新列表中的项

  • 项目

更新 listItem 上的属性。

权限

调用此 API 需要以下权限之一。 若要了解详细信息，包括如何选择权限的信息，请参阅权限。

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） Sites.ReadWrite.All
委派（个人 Microsoft 帐户） 不支持。
应用程序 Sites.ReadWrite.All

HTTP 请求

PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}/fields

可选的请求标头

名称 值 说明
if-match etag 如果包含此请求标头，且提供的 eTag 与项中的当前 eTag 不匹配，则返回 412 Precondition Failed 响应，并且不会更新该项。

请求正文

在请求正文中，提供指定要更新的字段的 fieldValueSet 的 JSON 表示形式。

示例

下面是一个示例，使用新值更新列表项的“颜色”和“数量”字段。 listItem 上的所有其他值都保持独立。

PATCH /sites/{site-id}/lists/{list-id}/items/{item-id}/fields
Content-Type: application/json

{
    "Color": "Fuchsia",
    "Quantity": 934
}

响应

如果成功，此方法在已更新列表项的响应正文中返回 fieldValueSet。

HTTP/1.1 201 Created
Content-type: application/json

{
  "Name": "Widget",
  "Color": "Fuchsia",
  "Quantity": 934
}