在列表中创建新项

命名空间:microsoft.graph

列表中创建新的 listItem

权限

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

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

HTTP 请求

POST https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items

请求正文

在请求正文中,提供要创建的 listItem 资源的 JSON 表示形式。

示例

下面的示例展示了如何创建新的泛型列表项。

POST https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items
Content-Type: application/json

{
  "fields": {
    "Title": "Widget",
    "Color": "Purple",
    "Weight": 32
  }
}

响应

如果成功,此方法在已创建列表项的响应正文中返回 listItem

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

{
  "id": "20",
  "createdDateTime": "2016-08-30T08:26:00Z",
  "createdBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "8606e4d5-d582-4f5f-aeba-7d7c18b20cfd"
    }
  },
  "lastModifiedDateTime": "2016-08-30T08:26:00Z",
  "lastModifiedBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "8606e4d5-d582-4f5f-aeba-7d7c18b20cfd"
    }
  }
}

注意: 为清楚起见,将截断 Response 对象。 实际调用会返回默认属性。