List-RessourceList resource

The list-Ressource stellt eine Liste auf einer [Website][] dar.The list resource represents a list in a site. Diese Ressource enthält die Eigenschaften der Liste auf oberster Ebene, einschließlich der Vorlage- und Feld-Definitionen.This resource contains the top level properties of the list, including template and field definitions.

Aufgaben in einer ListeTasks on a list

Die folgenden Aufgaben stehen für list-Ressourcen zur Verfügung.The following tasks are available for list resources. Hinweis: Mit dieser Beta können Sie nur durch Listen navigieren, keine Listen erstellen oder aktualisieren.Note: This beta only allows navigating lists, not creating or updating them. Sie können jedoch Listenelemente erstellen oder aktualisieren.You can, however, create or update list items.

Alle Beispiele unten beziehen sich auf eine Website, z. B.: https://graph.microsoft.com/v1.0/sites/{site-id}.All examples below are relative to a site, eg: https://graph.microsoft.com/v1.0/sites/{site-id}.

Häufige AufgabenCommon task HTTP-MethodeHTTP method
Liste abrufenGet list GET /lists/{list-id}GET /lists/{list-id}
Listenelemente auflistenEnumerate list items GET /lists/{list-id}/itemsGET /lists/{list-id}/items
Listenelement aktualisierenUpdate list item PATCH /lists/{list-id}/items/{item-id}PATCH /lists/{list-id}/items/{item-id}
Listenelement löschenDelete list item DELETE /lists/{list-id}/items/{item-id}DELETE /lists/{list-id}/items/{item-id}
Listenelement erstellenCreate list item POST /lists/{list-id}POST /lists/{list-id}

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung einer list-Ressource.Here is a JSON representation of a list resource.

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

EigenschaftenProperties

Die list-Ressource besitzt folgende Eigenschaften.The list resource has the following properties.

EigenschaftsnameProperty name TypType BeschreibungDescription
displayNamedisplayName stringstring Der anzeigbare Titel der Liste.The displayable title of the list.
listlist listInfolistInfo Weitere Details über die Liste.Provides additional details about the list.
systemsystem systemFacetsystemFacet Falls vorhanden, gibt an, dass es sich um eine vom System verwaltete Liste handelt.If present, indicates that this is a system-managed list. Schreibgeschützt.Read-only.

Die folgenden Eigenschaften werden von baseItem geerbt.The following properties are inherited from baseItem.

EigenschaftsnameProperty name TypType BeschreibungDescription
idid stringstring Der eindeutige Bezeichner des Elements. Schreibgeschützt.The unique identifier of the item. Read-only.
namename stringstring Der Name des Elements.The name of the item.
createdBycreatedBy identitySetidentitySet Die Identität des Erstellers dieses Elements.Identity of the creator of this item. Schreibgeschützt.Read-only.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit der Erstellung des Elements. Schreibgeschützt.The date and time the item was created. Read-only.
descriptiondescription stringstring Der beschreibende Text für das Element.The descriptive text for the item.
eTageTag stringstring ETag für das Element. Schreibgeschützt.ETag for the item. Read-only.
lastModifiedBylastModifiedBy identitySetidentitySet Die Identität derPerson, die dieses Element zuletzt geändert hat.Identity of the last modifier of this item. Schreibgeschützt.Read-only.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit der letzten Änderung des Elements. Schreibgeschützt.The date and time the item was last modified. Read-only.
parentReferenceparentReference itemReferenceitemReference Informationen zum übergeordneten Element, wenn das Element ein übergeordnetes Element hat. Lese-/Schreibzugriff.Parent information, if the item has a parent. Read-write.
sharepointIdssharepointIds sharepointIdssharepointIds Gibt Bezeichner zurück, die für SharePoint REST-Kompatibilität nützlich sind. Schreibgeschützt.Returns identifiers useful for SharePoint REST compatibility. Read-only.
webUrlwebUrl String (URL)string (url) URL, über die das Element im Browser angezeigt werden kann. Schreibgeschützt.URL that displays the item in the browser. Read-only.

BeziehungenRelationships

Die list-Ressource weist folgende Beziehungen zu anderen Ressourcen auf.The list resource has the following relationships to other resources.

BeziehungsnameRelationship name TypType BeschreibungDescription
drivedrive drivedrive Nur in Dokumentbibliotheken vorhanden.Only present on document libraries. Ermöglicht den Zugriff auf die Liste als drive-Ressource mit driveItems.Allows access to the list as a drive resource with driveItems.
itemsitems Sammlung (listItem)Collection(listItem) Alle in der Liste enthaltenen Elemente.All items contained in the list.
columnscolumns Sammlung (ColumnDefinition)Collection(columnDefinition) Die Sammlung von Felddefinitionen für diese Liste.The collection of field definitions for this list.
contentTypescontentTypes Sammlung (contentType)Collection(contentType) Die Sammlung von in dieser Liste enthaltenen content-Typen.The collection of content types present in this list.