Поделиться через

Отправка или замена содержимого элемента driveItem

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Укажите содержимое нового файла или обновите содержимое существующего файла в одном вызове API. Этот метод поддерживает только файлы размером до 250 МБ.

Сведения о том, как отправить большие файлы, см. в разделе Отправка больших файлов с помощью сеанса отправки.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Files.ReadWrite Files.ReadWrite.All, Sites.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Files.ReadWrite Files.ReadWrite.All
Приложение Files.ReadWrite.All Sites.ReadWrite.All

HTTP-запрос

Замена существующего элемента

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

Отправка нового файла

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

Тело запроса

Содержимое текста запроса должно представлять собой двоичный поток файла, который необходимо отправить.

Ответ

При успешном выполнении этот метод возвращает объект driveItem для вновь созданного или обновленного файла в теле ответа.

Пример (отправка нового файла)

В этом примере строка "Содержимое файла идет здесь". передается в файл на диске вошедшего пользователя в папку FolderA с именем FileB.txt.

PUT https://graph.microsoft.com/beta/me/drive/root:/FolderA/FileB.txt:/content
Content-Type: text/plain

The contents of the file goes here.

Отклик

В случае успешного выполнения этот метод возвращает ресурс driveItem в тексте ответа для только что созданного или обновленного файла.

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

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

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

В этом примере показано, как заменить содержимое файла с известным идентификатором.

PUT https://graph.microsoft.com/beta/me/drive/items/{item-id}/content
Content-Type: text/plain

The contents of the file goes here.

Отклик

В случае успешного выполнения этот метод возвращает в тексте отклика ресурс driveItem для созданного файла.

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

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

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

Дополнительные сведения о возвращении ошибок см. в статье Ответы с ошибками.