Обновление свойств ресурса DriveItem

  • Статья

Обновление метаданных ресурса DriveItem по идентификатору или пути.

Путем обновления также можно переместить элемент в другой родительский объект, изменив свойство parentReference этого элемента.

Разрешения

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

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

HTTP-запрос

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

Необязательные заголовки запросов

Имя Тип Описание
if-match String Если указан заголовок запроса, а предоставленный тег eTag (или cTag) не совпадает с текущим тегом eTag папки, то возвращается отклик 412 Precondition Failed.

Текст запроса

Укажите в тексте запроса значения обновляемых свойств.

Предыдущие значения существующих свойств, не включенных в текст запроса, будут сохранены или вычислены повторно с учетом изменений, внесенных в значения других свойств. Для достижения максимальной оптимальной производительности в приложении не следует указывать свойства, которые не были изменены.

Отклик

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

Пример

В этом примере показано, как переименовать ресурс DriveItem и присвоить ему имя new-file-name.docx.

PATCH /me/drive/items/{item-id}
Content-type: application/json

{
  "name": "new-file-name.docx"
}

Отклик

При успешном выполнении этот метод возвращает ресурс driveItem в тексте отклика.

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

{
  "id": "01NKDM7HMOJTVYMDOSXFDK2QJDXCDI3WUK",
  "name": "new-file-name.docx",
  "file": { }
}

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

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