Отправка или замена содержимого элемента DriveItemUpload or replace the contents of a DriveItem

Используя простой API отправки, вы можете отправлять содержимое нового файла или обновлять содержимое существующего файла с помощью одного вызова API. Этот метод поддерживает файлы размером не более 4 МБ.The simple upload API allows you to provide the contents of a new file or update the contents of an existing file in a single API call. This method only supports files up to 4MB in size.

Сведения о том, как отправлять большие файлы, см. в разделе Отправка больших файлов с помощью сеанса отправки.To upload large files see Upload large files with an upload session.

РазрешенияPermissions

Для вызова этого API требуется одно из указанных ниже разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Тип разрешенияPermission type Разрешения (в порядке повышения привилегий)Permissions (from least to most privileged)
Делегированные (рабочая или учебная учетная запись)Delegated (work or school account) Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.AllFiles.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
Делегированные (личная учетная запись Майкрософт)Delegated (personal Microsoft account) Files.ReadWrite, Files.ReadWrite.AllFiles.ReadWrite, Files.ReadWrite.All
Для приложенийApplication Files.ReadWrite.All, Sites.ReadWrite.AllFiles.ReadWrite.All, Sites.ReadWrite.All

HTTP-запрос (для замены существующего элемента)HTTP request (to replace an existing item)

PUT /drives/{drive-id}/items/{item-id}/content
PUT /groups/{group-id}/drive/items/{item-id}/content
PUT /me/drive/items/{item-id}/content
PUT /sites/{site-id}/drive/items/{item-id}/content
PUT /users/{user-id}/drive/items/{item-id}/content

HTTP-запрос (для отправки нового файла)HTTP request (to upload a new file)

PUT /drives/{drive-id}/items/{parent-id}:/{filename}:/content
PUT /groups/{group-id}/drive/items/{parent-id}:/{filename}:/content
PUT /me/drive/items/{parent-id}:/{filename}:/content
PUT /sites/{site-id}/drive/items/{parent-id}:/{filename}:/content
PUT /users/{user-id}/drive/items/{parent-id}:/{filename}:/content

Тело запросаRequest body

Содержимое текста запроса должно представлять собой двоичный поток файла, который необходимо отправить.The contents of the request body should be the binary stream of the file to be uploaded.

ОткликResponse

При успешном выполнении этот метод возвращает объект driveItem в теле отклика для вновь созданного или обновленного файла.If successful, this method returns a driveItem object in the response body for the newly created or updated file.

Пример (отправка нового файла)Example (upload a new file)

В этом примере показано, как отправить строку "The contents of the file goes here" (Здесь начинается содержимое файла.)This example uploads the string "The contents of the file goes here." в файл FileB.txt в папке FolderA в объекте drive пользователя, вошедшего в систему.to a file in the signed-in user's drive under FolderA named FileB.txt.

PUT /me/drive/root:/FolderA/FileB.txt:/content
Content-Type: text/plain

The contents of the file goes here.

ОткликResponse

При успешном выполнении этот метод возвращает ресурс driveItem в теле отклика для созданного файла.If successful, this method returns an driveItem resource in the response body for the newly created file.

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

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

Пример (обновление существующего файла)Example (updating an existing file)

В этом примере показано, как заменить содержимое файла известным идентификатором.This example replaces the contents of a file with a known ID.

PUT /me/drive/items/{item-id}/content
Content-Type: text/plain

The contents of the file goes here.

ОткликResponse

При успешном выполнении этот метод возвращает ресурс driveItem в теле отклика для созданного файла.If successful, this method returns an driveItem resource in the response body for the newly created file.

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

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

ЗамечанияRemarks

SharePoint Server 2016 блокирует отправку на сервер файлов с некоторыми расширениями.SharePoint Server 2016 blocks several file extensions from being uploaded to the server.

  • ASHX — файл веб-обработчика ASP.NET.ashx - ASP.NET Web handler file
  • ASMX — исходный файл веб-служб ASP.NET.asmx - ASP.NET Web Services source file
  • JSON — файл нотации объектов JavaScript.json - JavaScript Object Notation file
  • SOAP — файл протокола SOAP.soap - Simple Object Access Protocol file
  • SVC — файл службы Windows Communication Foundation (WCF).svc - Windows Communication Foundation (WCF) service file
  • XAMLX — файл службы рабочих процессов Visual Studio.xamlx - Visual Studio Workflow service file

Дополнительные сведения о блокируемых расширениях файлов см. в статье Типы файлов, которые невозможно добавить в список или библиотеку.See Types of files that cannot be added to a list or library for more information on blocked file extensions.

Отклики с ошибкамиError responses

Дополнительные сведения о том, как возвращаются ошибки, см. в статье Ошибки.See Error Responses for details about how errors are returned.