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

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

Укажите содержимое нового файла или обновите содержимое существующего файла в одном вызове 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

Заголовки запросов

Имя	Описание
Авторизация	Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type	text/plain. Обязательно.

Тело запроса

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

Ответ

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

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

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

PUT https://graph.microsoft.com/v1.0/me/drive/root:/FolderA/FileB.txt:/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": { }
}

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

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

HTTP

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

The contents of the file goes here.

CLI

mgc drives items content put --drive-id {drive-id} --drive-item-id {driveItem-id} --body 'The contents of the file goes here.\
'

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const stream = The contents of the file goes here.;

await client.api('/me/drive/items/{item-id}/content')
	.put(stream);

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

PowerShell

Import-Module Microsoft.Graph.Files

$params = The contents of the file goes here.


Set-MgDriveItemContent -DriveId $driveId -DriveItemId $driveItemId -BodyParameter $params

Подробнее о том, как добавить SDK в свой проект и создать экземпляр authProvider, см. в документации по SDK.

Отклик

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

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

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

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

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