列表资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示 网站中的列表。 此资源包含列表的顶级属性，其中包括模板和字段定义。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 创建 | 列表 | 在 site 中的创建新的 list。 |
| Get | 列表 | 获取 列表的元数据。 |
| 获取项目 | listItem 集合 | 获取列表中的 listItems集合。 |
| 获取网站中的列表 | 列表 集合 | 获取网站中的列表集合。 |
| 获取最近的活动 | itemActivity 集合 | 列出在某个项上或某个层次结构下发生的最近活动。 |
| 创建项目 | listItem | 在列表中创建新的 listItem。 |
| 更新项目 | listItem | 更新 listItem 上的属性。 |
| 删除项 | None | 从列表中删除 listItem。 |
| 获取 websocket 终结点 | 订阅 | 使用 socket.io 获取驱动器和列表的准实时更改通知。 |
| 列出列表中的操作 | richLongRunningOperation 集合 | 获取与列表关联的丰富长时间运行的操作的列表。 |
| 列表内容类型 | contentType 集合 | 获取列表中的contentType 资源的集合。 |
| 将副本添加到列表 | contentType | 将 contentType 的副本从 网站 添加到 列表。 |
| List columns | columnDefinition 集合 | 获取列表中表示为 columnDefinition 对象的列的集合。 |
| 创建列 | columnDefinition | 使用指定 columnDefinition 的请求为列表创建列。 |
| 列出权限 | 权限 | 获取与列表关联的 权限 对象 列表。 |
| 创建权限 | 权限 | 获取与列表关联的 权限 对象 列表。 |
| 获取权限 | 权限 | 在列表中创建新的权限对象。 |
| 更新权限 | 权限 | 更新列表中的权限对象。 |
| 删除权限 | None | 删除列表中的权限对象。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| createdBy | identitySet | 此项的创建者的标识。 只读。 继承自 baseItem。 |
| createdDateTime | DateTimeOffset | 创建项的日期和时间。 此为只读属性。 继承自 baseItem。 |
| 说明 | String | 项目的描述性文本。 继承自 baseItem。 |
| displayName | String | 列表的可显示标题。 |
| eTag | String | 该项目的 ETag。 继承自 baseItem。 |
| id | String | 项的唯一标识符。 此为只读属性。 继承自 baseItem。 |
| lastModifiedBy | identitySet | 此项的最后一个修饰符的标识。 只读。 继承自 baseItem。 |
| lastModifiedDateTime | DateTimeOffset | 上次修改项的日期和时间。 此为只读属性。 继承自 baseItem。 |
| list | listInfo | 包含有关列表的更多详细信息。 |
| name | String | 项目名称。 继承自 baseItem。 |
| parentReference | itemReference | 父信息（如果项具有父级）。 读写。 继承自 baseItem。 |
| sharepointIds | sharepointIds | 返回对 SharePoint REST 兼容性有用的标识符。 只读。 |
| system | systemFacet | 如果存在，则指示列表由系统管理。 只读。 |
| webUrl | String | 在浏览器中显示项的 URL。 此为只读属性。 继承自 baseItem。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| activities | itemActivity 集合 | 最近发生在此列表内的活动。 |
| columns | columnDefinition 集合 | 此列表的字段定义集合。 |
| contentTypes | contentType 集合 | 此列表中出现的内容类型的集合。 |
| 驱动器 | drive | 允许使用 driveItems 作为 drive 资源访问列表。 仅存在于文档库中。 |
| items | listItem 集合 | 列表中包含的所有项。 |
| operations | richLongRunningOperation 集合 | 列表上长时间运行操作的集合。 |
| permissions | 权限 集合 | 项目的权限集。 只读。 可为 NULL。 |
| 订阅 | 订阅集合 | 列表上的订阅集。 |
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"createdBy": { "@odata.type": "microsoft.graph.identitySet" },
"createdDateTime": "String (timestamp)",
"description": "String",
"displayName": "String",
"eTag": "String",
"id": "String (identifier)",
"lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
"lastModifiedDateTime": "String (timestamp)",
"list": { "@odata.type": "microsoft.graph.listInfo" },
"name": "String",
"parentReference": { "@odata.type": "microsoft.graph.itemReference" },
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
"system": "Boolean",
"webUrl": "String"
}