List 资源

命名空间：microsoft.graph

list 资源表示 site 中的列表。 此资源包含列表的顶级属性，其中包括模板和字段定义。

list 上的任务

下面列出了可执行的 list 资源任务。

下面的所有示例都与网站相关，例如：https://graph.microsoft.com/v1.0/sites/{site-id}。

常见任务	HTTP 方法
获取列表	GET /lists/{list-id}
创建列表	POST /列表
枚举列表项	GET /lists/{list-id}/items
更新列表项	PATCH /lists/{list-id}/items/{item-id}
删除列表项	DELETE /lists/{list-id}/items/{item-id}
创建列表项	POST /lists/{list-id}
获取 WebSocket 频道	GET /lists/{list-id}/subscriptions/socketIo
列举操作	GET /lists/{list-id}/operations

属性

list 资源具有以下属性。

属性名称	类型	说明
displayName	string	列表的可显示标题。
list	listInfo	提供关于列表的其他详细信息。
system	systemFacet	如果存在，则表示这是系统管理的列表。只读。

以下属性继承自 baseItem。

属性名称	类型	说明
id	string	项的唯一标识符。只读。
名称	string	项目名称。
createdBy	identitySet	此项的创建者的标识。只读。
createdDateTime	DateTimeOffset	创建项目的日期和时间。只读。
说明	string	项目的描述性文本。
eTag	string	该项目的 ETag。只读。
lastModifiedBy	identitySet	此项最后一个修饰符的标识。只读。
lastModifiedDateTime	DateTimeOffset	上次修改项目的日期和时间。只读。
parentReference	itemReference	父信息（如果此项具有父级）。读写。
sharepointIds	sharepointIds	返回对 SharePoint REST 兼容性有用的标识符。只读。
webUrl	string (url)	在浏览器中显示此项目的 URL。只读。

关系

list 资源与其他资源具有以下关系。

关系名称	类型	说明
驱动器	drive	仅存在于文档库中。允许使用 driveItems 作为 drive 资源访问列表。
项目	Collection(listItem)	列表中包含的所有项。
columns	Collection(columnDefinition)	此列表的字段定义集合。
contentTypes	Collection(contentType)	此列表中出现的内容类型的集合。
operations	richLongRunningOperation 集合	列表上长时间运行操作的集合。
订阅	集合（订阅）	列表上的订阅集。

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
  "contentTypes": [ { "@odata.type": "microsoft.graph.contentType" }],
  "displayName": "title of list",
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "items": [ { "@odata.type": "microsoft.graph.listItem" } ],
  "list": {
    "@odata.type": "microsoft.graph.listInfo",
    "hidden": false,
    "template": "documentLibrary | genericList | survey | links | announcements | contacts | accessRequest ..."
  },
  "operations": [ { "@odata.type": "microsoft.graph.richLongRunningOperation" }],
  "system": false,
  "subscriptions": [ {"@odata.type": "microsoft.graph.subscription"} ],

  /* inherited from baseItem */
  "id": "string",
  "name": "name of list",
  "createdBy": { "@odata.type": "microsoft.graph.identitySet" },
  "createdDateTime": "timestamp",
  "description": "description of list",
  "eTag": "string",
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "timestamp",
  "parentReference": { "@odata.type": "microsoft.graph.itemReference" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "webUrl": "url to visit the list in a browser"
}