Columnas Upsert

Espacio de nombres: microsoft.graph

Upsert (crear o actualizar) hasta 20 objetos columnDefinition en un fileStorageContainer en una sola solicitud. La revisión diferencial permite al autor de la llamada realizar varias operaciones (crear, actualizar) en un máximo de 20 columnas con una sola solicitud.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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.

Además de los permisos de Microsoft Graph, la aplicación también debe tener los permisos de nivel 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 de contenedor, consulte Autorización de SharePoint Embedded.

Solicitud HTTP

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

Encabezados de solicitud

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione un objeto JSON con las siguientes propiedades.

Cada entrada de la colección de valores representa una operación en una columnDefinition. La presencia de la propiedad id determina cómo se interpreta la entrada:

• Crear: omita la propiedad id . Especifique la propiedad nombre y la propiedad tipo de columna (por ejemplo, booleano, texto, elección).
• Actualizar: incluya el identificador de la columna existente y las propiedades que se van a actualizar.

Respuesta

Si tiene éxito, este método devuelve un 200 OK código de respuesta y una colección de objetos columnDefinition en el cuerpo de la respuesta. Las columnas que se procesan correctamente incluyen el objeto columnDefinition completo. Los elementos con errores incluyen una anotación @Core.DataModificationException con detalles del error.

Esta API también puede devolver los siguientes códigos de respuesta de error para toda la solicitud:

Ejemplos

Solicitud

En el ejemplo siguiente se muestra una única solicitud de revisión diferencial que combina elementos de creación y actualización en una llamada. Los elementos sin un identificador se tratan como operaciones de creación; los elementos con un identificador se tratan como operaciones de actualización. Los elementos que producen errores se notifican en línea con una anotación @Core.DataModificationException . Los elementos restantes siguen siendo correctos.

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

{
  "@context": "#$delta",
  "value": [
    {
      "id": "aec21c58-7f1f-4875-b438-d47ef622306c",
      "isSearchable": false
    },
    {
      "id": "aec21c58-7f1f-4875-b438-d47df622306c",
      "isSearchable": false
    },
    {
      "name": "booleanColumn1234",
      "boolean": {}
    },
    {
      "name": "booleanColumn33",
      "boolean": {}
    }
  ]
}

const options = {
	authProvider,
};

const client = Client.init(options);

const columns = {
  '@context': '#$delta',
  value: [
    {
      id: 'aec21c58-7f1f-4875-b438-d47ef622306c',
      isSearchable: false
    },
    {
      id: 'aec21c58-7f1f-4875-b438-d47df622306c',
      isSearchable: false
    },
    {
      name: 'booleanColumn1234',
      boolean: {}
    },
    {
      name: 'booleanColumn33',
      boolean: {}
    }
  ]
};

await client.api('/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/columns')
	.update(columns);

Respuesta

En el ejemplo siguiente se muestra la respuesta. La respuesta incluye un elemento para cada elemento de la solicitud, en el mismo orden. En este ejemplo, el primer elemento de solicitud es una operación de actualización que se realiza correctamente, el segundo elemento de solicitud es una operación de actualización en la que se produce un error porque no existe ninguna columna con ese identificador, el tercer elemento de solicitud es una operación de creación que se realiza correctamente y el cuarto elemento de solicitud es una operación de creación que produce un error porque ya existe una columna con ese nombre.

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

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#storage/fileStorage/containers('b%21ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z')/columns/$delta",
  "value": [
    {
      "@odata.etag": "\"4\"",
      "description": "",
      "displayName": "booleanColumn8",
      "id": "aec21c58-7f1f-4875-b438-d47ef622306c",
      "indexed": false,
      "isSearchable": false,
      "isDeletable": true,
      "isSealed": false,
      "name": "booleanColumn8",
      "readOnly": false,
      "type": "boolean",
      "boolean": {}
    },
    {
      "@Core.DataModificationException": {
        "@odata.type": "#Org.OData.Core.V1.DataModificationExceptionType",
        "failedOperation": "Update",
        "responseCode": 404,
        "info": {
          "code": "NotFound",
          "message": "Item not found."
        }
      },
      "id": "aec21c58-7f1f-4875-b438-d47df622306c",
      "type": "unknownFutureValue"
    },
    {
      "@odata.etag": "\"1\"",
      "description": "",
      "displayName": "booleanColumn1234",
      "id": "7eac4ae0-afe9-4a02-8cfa-9369558b44db",
      "indexed": false,
      "isSearchable": false,
      "isDeletable": true,
      "isSealed": false,
      "name": "booleanColumn1234",
      "readOnly": false,
      "type": "boolean",
      "boolean": {}
    },
    {
      "@Core.DataModificationException": {
        "@odata.type": "#Org.OData.Core.V1.DataModificationExceptionType",
        "failedOperation": "Create",
        "responseCode": 409,
        "info": {
          "code": "Conflict",
          "message": "A field with the specified name already exists"
        }
      },
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "booleanColumn33",
      "type": "unknownFutureValue",
      "boolean": {}
    }
  ]
}