List 资源

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

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

list 上的任务

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

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

常见任务	HTTP 方法
获取网站中的列表	GET /sites/{site-id}/lists
创建列表	POST /列表
获取列表	GET /lists/{list-id}
枚举列表项	GET /lists/{list-id}/items
更新列表项	PATCH /lists/{list-id}/items/{item-id}
删除列表项	DELETE /lists/{list-id}/items/{item-id}
创建列表项	POST /lists/{list-id}
获取最近的活动	GET /lists/{list-id}/activities
获取 WebSocket 频道	GET /lists/{list-id}/subscriptions/socketIo
列表内容类型	GET /lists/{list-id}/contentTypes
从站点添加内容类型的副本	POST /lists/{list-id}/contentTypes/addCopy
List columns	GET /lists/{list-id}/columns
创建列	POST /lists/{list-id}/columns
列举操作	GET /lists/{list-id}/operations

属性

list 资源具有以下属性。

属性	类型	说明
columns	Collection(columnDefinition)	此列表的字段定义集合。
contentTypes	Collection(contentType)	此列表中出现的内容类型的集合。
displayName	string	列表的可显示标题。
list	listInfo	提供关于列表的其他详细信息。
system	systemFacet	如果存在，则表示这是系统管理的列表。只读。

以下属性继承自 baseItem。

属性名称	类型	说明
id	string	项的唯一标识符。只读。
名称	string	项目名称。
createdBy	identitySet	此项的创建者的标识。只读。
createdDateTime	DateTimeOffset	创建项目的日期和时间。只读。
说明	string	项目的描述性文本。
lastModifiedBy	identitySet	此项最后一个修饰符的标识。只读。
lastModifiedDateTime	DateTimeOffset	上次修改项目的日期和时间。只读。
webUrl	string (url)	在浏览器中显示此项目的 URL。只读。

关系

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

关系	类型	说明
activities	itemActivity 集合	最近发生在此列表内的活动。
drive	drive	仅存在于文档库中。允许使用 driveItems 作为 drive 资源访问列表。
项目	Collection(listItem)	列表中包含的所有项。
订阅	订阅集合	列表上的订阅集。
operations	richLongRunningOperation 集合	列表的长时间运行操作的集合。

JSON 表示形式

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

{
  "activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
  "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 ..."
  },
  "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",
  "webUrl": "url to visit the list in a browser"
}