Neues Element in einer Liste erstellenCreate a new item in a list

Erstellen Sie ein neues listItem in einer Liste.Create a new listItem in a list.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Sites.ReadWrite.AllSites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Sites.ReadWrite.AllSites.ReadWrite.All

HTTP-AnforderungHTTP request

POST https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items

AnforderungstextRequest body

Geben Sie im Anforderungstext eine JSON-Darstellung der zu erstellenden listItem-Ressource an.In the request body, supply a JSON representation of the listItem resource to create.

BeispielExample

Unten sehen Sie ein Beispiel, das die Erstellung eines neuen generischen Listenelements illustriert.Here is an example of how to create a new generic list item.

POST https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/items
Content-Type: application/json

{
  "fields": {
    "Title": "Widget",
    "Color": "Purple",
    "Weight": 32
  }
}

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird ein listItem-Objekt im Antworttext des neu erstellten Listenelements zurückgegeben.If successful, this method returns a listItem in the response body for the created list item.

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "20",
  "createdDateTime": "2016-08-30T08:26:00Z",
  "createdBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "8606e4d5-d582-4f5f-aeba-7d7c18b20cfd"
    }
  },
  "lastModifiedDateTime": "2016-08-30T08:26:00Z",
  "lastModifiedBy": {
    "user": {
      "displayName": "Ryan Gregg",
      "id": "8606e4d5-d582-4f5f-aeba-7d7c18b20cfd"
    }
  }
}

Hinweis: Das „Response“-Objekt wurde zwecks besserer Übersichtlichkeit gekürzt.Note: The response object is truncated for clarity. Der tatsächliche Aufruf gibt die Standardeigenschaften zurück.Default properties will be returned from the actual call.