List-Ressource

Namespace: microsoft.graph

The list-Ressource stellt eine Liste auf einer [Website][] dar. Diese Ressource enthält die Eigenschaften der Liste auf oberster Ebene, einschließlich der Vorlage- und Feld-Definitionen.

Aufgaben in einer Liste

Die folgenden Aufgaben stehen für list-Ressourcen zur Verfügung.

Alle folgenden Beispiele beziehen sich auf eine Website, z. B. https://graph.microsoft.com/v1.0/sites/{site-id}.

Häufige Aufgaben	HTTP-Methode
Liste abrufen	GET /lists/{list-id}
Liste erstellen	POST/Listen
Listenelemente auflisten	GET /lists/{list-id}/items
Listenelement aktualisieren	PATCH /lists/{list-id}/items/{item-id}
Listenelement löschen	DELETE /lists/{list-id}/items/{item-id}
Listenelement erstellen	POST /lists/{list-id}
WebSocket-Kanal abrufen	GET /lists/{list-id}/subscriptions/socketIo
Vorgänge auflisten	GET /lists/{list-id}/operations

Eigenschaften

Die list-Ressource besitzt folgende Eigenschaften.

Eigenschaftsname	Typ	Beschreibung
displayName	string	Der anzeigbare Titel der Liste.
list	listInfo	Weitere Details über die Liste.
system	systemFacet	Falls vorhanden, gibt an, dass es sich um eine vom System verwaltete Liste handelt. Schreibgeschützt.

Die folgenden Eigenschaften werden von baseItem geerbt.

Eigenschaftsname	Typ	Beschreibung
id	string	Der eindeutige Bezeichner des Elements. Schreibgeschützt.
name	string	Der Name des Elements.
createdBy	identitySet	Identität des Erstellers dieses Elements. Schreibgeschützt.
createdDateTime	DateTimeOffset	Das Datum und die Uhrzeit der Erstellung des Elements. Schreibgeschützt.
description	string	Der beschreibende Text für das Element.
eTag	string	ETag für das Element. Schreibgeschützt.
lastModifiedBy	identitySet	Identität der letzten Person, die dieses Element geändert hat. Schreibgeschützt.
lastModifiedDateTime	DateTimeOffset	Das Datum und die Uhrzeit der letzten Änderung des Elements. Schreibgeschützt.
parentReference	itemReference	Informationen zum übergeordneten Element, wenn das Element ein übergeordnetes Element hat. Lese-/Schreibzugriff.
sharepointIds	sharepointIds	Gibt Bezeichner zurück, die für SharePoint REST-Kompatibilität nützlich sind. Schreibgeschützt.
webUrl	String (URL)	URL, über die das Element im Browser angezeigt werden kann. Schreibgeschützt.

Beziehungen

Die list-Ressource weist folgende Beziehungen zu anderen Ressourcen auf.

Beziehungsname	Typ	Beschreibung
drive	drive	Nur in Dokumentbibliotheken vorhanden. Ermöglicht den Zugriff auf die Liste als drive-Ressource mit driveItems.
items	Sammlung (listItem)	Alle in der Liste enthaltenen Elemente.
columns	Sammlung (ColumnDefinition)	Die Sammlung von Felddefinitionen für diese Liste.
contentTypes	Sammlung (contentType)	Die Sammlung von in dieser Liste enthaltenen content-Typen.
operations	richLongRunningOperation-Sammlung	Die Auflistung von Vorgängen mit langer Ausführungsdauer in der Liste.
subscriptions	Sammlung (subscription)	Die Gruppe von Abonnements für die Liste.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "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"
}