Share via

List-Ressource

  • Artikel

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. Hinweis: Mit dieser Beta können Sie nur durch Listen navigieren, keine Listen erstellen oder aktualisieren. Sie können jedoch Listenelemente erstellen oder aktualisieren.

Alle Beispiele unten 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}
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

JSON-Darstellung

Es folgt eine JSON-Darstellung einer list-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 | accessRequest ..."
  },
  "system": false,

  /* 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"
}

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 Die 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 Die Identität derPerson, die dieses Element zuletzt 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
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.
columns Sammlung (ColumnDefinition) Die Sammlung von Felddefinitionen für diese Liste.
contentTypes Sammlung (contentType) Die Sammlung von in dieser Liste enthaltenen content-Typen.