List-Ressource

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

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/beta/sites/{site-id}.

Häufige Aufgaben	HTTP-Methode
Abrufen von Listen auf einer Website	GET /sites/{site-id}/lists
Liste erstellen	POST/Listen
Liste abrufen	GET /lists/{list-id}
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}
Aktuelle Aktivitäten abrufen	GET /lists/{list-id}/activities
[WebSocket-Kanal abrufen][]	GET /lists/{list-id}/subscriptions/socketIo
Listeninhaltstypen	GET /lists/{list-id}/contentTypes
Hinzufügen einer Kopie des Inhaltstyps von der Website	POST /lists/{list-id}/contentTypes/addCopy
Spalten auflisten	GET /lists/{list-id}/columns
Spalte erstellen	POST /lists/{list-id}/columns
Vorgänge auflisten	GET /lists/{list-id}/operations

Eigenschaften

Die list-Ressource besitzt folgende Eigenschaften.

Eigenschaft	Typ	Beschreibung
columns	Sammlung (ColumnDefinition)	Die Sammlung von Felddefinitionen für diese Liste.
contentTypes	Sammlung (contentType)	Die Sammlung von in dieser Liste enthaltenen content-Typen.
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.
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.
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.

Beziehung	Typ	Beschreibung
activities	itemActivity-Sammlung	Die letzten Aktivitäten, die innerhalb dieser Liste stattfanden.
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.
Abonnements	[Abonnement][]-Sammlung	Die Gruppe von Abonnements für die Liste.
operations	richLongRunningOperation-Sammlung	Die Sammlung von Vorgängen mit langer Ausführungsdauer für die Liste.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

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