Обновление пакета

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

Обновите метаданные для пакетаdriveItems по идентификатору. Вы можете обновить только следующие метаданные:

  • Имя пакета
  • Альбом coverImageItemId (если применимо)

Любые другие запросы на изменение будут игнорироваться.

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

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

Разрешения

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

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

HTTP-запрос

PATCH /drive/items/{bundle-id}

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
if-match Etag. Необязательный параметр. Если этот заголовок запроса включен, а указанный eTag не соответствует текущему eTag в buncle, 412 Precondition Failed возвращается ответ.

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

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

Отклик

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

Сведения об ответах на ошибки см. в разделе Ответы на ошибки.

Пример

В этом примере пакет переименовывается.

Запрос

PATCH https://graph.microsoft.com/v1.0/drive/items/{bundle-id}
Content-Type: application/json

{
  "name": "Shared legal agreements"
}

Отклик

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

{
  "id": "0123456789abc",
  "name": "Shared legal agreements",
  "bundle": {
    "childCount": 3
  }
}

Объект ответа, показанный здесь, может быть сокращен для удобочитаемости.