Compartir a través de

Crear columna

  • Artículo

Espacio de nombres: microsoft.graph

Cree un columnDefinition para un fileStorageContainer que especifique un columnDefinition.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permiso con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) FileStorageContainer.Selected No admitida.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación FileStorageContainer.Selected No admitida.

Nota:

Además de los permisos de Microsoft Graph, la aplicación también debe tener los permisos o permisos de nivel de tipo de contenedor necesarios para llamar a esta API. Para obtener más información sobre los tipos de contenedor, consulte Tipos de contenedor. Para obtener más información sobre los permisos de nivel de tipo contenedor, vea Autorización de SharePoint Embedded.

Solicitud HTTP

POST /storage/fileStorage/containers/{containerId}/columns

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON del objeto columnDefinition .

Solo se admiten las siguientes propiedades relacionadas con el tipo y son mutuamente excluyentes; una columna solo puede tener una de ellas especificada a la vez.

Propiedad Tipo Descripción
Booleano booleanColumn Esta columna almacena valores booleanos.
elección choiceColumn Esta columna almacena los datos de una lista de opciones.
divisa currencyColumn Esta columna almacena valores de moneda.
dateTime dateTimeColumn Esta columna almacena valores DateTime.
hyperlinkOrPicture hyperlinkOrPictureColumn Esta columna almacena valores de hipervínculo o imagen.
número numberColumn Esta columna almacena valores de números.
personOrGroup personOrGroupColumn Esta columna almacena valores de personas o grupos.
text textColumn Esta columna almacena valores de texto.

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto columnDefinition en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

POST https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/columns
Content-Type: application/json

{
  "description": "test",
  "enforceUniqueValues": false,
  "hidden": false,
  "indexed": false,
  "name": "Title",
  "text": {
    "allowMultipleLines": false,
    "appendChangesToExistingText": false,
    "linesForEditing": 0,
    "maxLength": 255
  }
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

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

{
  "description": "test",
  "displayName": "Title",
  "enforceUniqueValues": false,
  "hidden": false,
  "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103",
  "indexed": false,
  "name": "Title",
  "text": {
    "allowMultipleLines": false,
    "appendChangesToExistingText": false,
    "linesForEditing": 0,
    "maxLength": 255
  }
}