Recurso de lista

Espacio de nombres: microsoft.graph

El recurso list representa una lista en un sitio. Este recurso contiene las propiedades de nivel superior de la lista, incluidas las definiciones de plantilla y campo.

Tareas en una lista

Las tareas siguientes están disponibles para los recursos list.

Todos los ejemplos siguientes son relativos a un sitio, por ejemplo: https://graph.microsoft.com/v1.0/sites/{site-id}.

Tarea común	Método HTTP
Obtener lista	GET /lists/{list-id}
Crear lista	PUBLICACIONES / listas
Enumerar elementos de lista	GET /lists/{list-id}/items
Actualizar elemento de lista	PATCH /lists/{list-id}/items/{item-id}
Eliminar elemento de lista	DELETE /lists/{list-id}/items/{item-id}
Crear elemento de lista	POST /lists/{list-id}
Obtenga el canal WebSocket	Obtenga/lists/{list-id}/subscriptions/socketIo
Operaciones de lista	GET /lists/{list-id}/operations

Propiedades

El recurso list tiene las siguientes propiedades.

Nombre de propiedad	Tipo	Descripción
displayName	string	El título que se puede mostrar de la lista.
list	listInfo	Proporciona detalles adicionales sobre la lista.
system	systemFacet	Si está presente, indica que se trata de una lista administrada por el sistema. Solo lectura.

Las siguientes propiedades se heredan de baseItem.

Nombre de propiedad	Tipo	Descripción
createdBy	identitySet	Identidad del creador de este elemento. Solo lectura.
createdDateTime	DateTimeOffset	La fecha y la hora de creación del elemento. Solo lectura.
description	string	Texto descriptivo del elemento.
eTag	string	ETag para el elemento.
id	cadena	El identificador único del elemento. Solo lectura.
name	string	Nombre del elemento. Solo lectura.
lastModifiedBy	identitySet	Identidad del usuario que modificó por última vez este elemento. Solo lectura.
lastModifiedDateTime	DateTimeOffset	Fecha y hora de la última modificación del elemento. Solo lectura.
parentReference	itemReference	Información primaria, si el elemento tiene un elemento primario. Lectura y escritura.
sharepointIds	sharepointIds	Devuelve los identificadores útiles para la compatibilidad con REST de SharePoint. Solo lectura.
webUrl	string (url)	Dirección URL que muestra el elemento en el explorador. Solo lectura.

Relaciones

El recurso list tiene las siguientes relaciones con otros recursos.

Nombre de la relación	Tipo	Descripción
columns	Collection(columnDefinition)	La colección de definiciones de campo de esta lista.
contentTypes	Collection(contentType)	La colección de tipos de contenido presentes en esta lista.
drive	drive	Solo está presente en bibliotecas de documentos. Permite el acceso a la lista como un recurso drive con objetos driveItems.
items	Collection(listItem)	Todos los elementos que se incluyen en la lista.
operations	colección richLongRunningOperation	Colección de operaciones de ejecución prolongada en la lista.
suscripciones	Colección(suscripción de)	El conjunto de suscripciones de la lista.

Representación JSON

La siguiente es una representación JSON del recurso

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