Обновление пользовательских свойств fileStorageContainer

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

Обновите одно или несколько настраиваемых свойств в файлеStorageContainer. Можно обновить только атрибуты value и isSearchable настраиваемых свойств. Обновляются только пользовательские свойства, указанные в тексте запроса. Пользовательские свойства, указанные в тексте запроса, создаются, если они еще не существуют в контейнере.

При обновлении пользовательского null свойства до значения свойство удаляется из контейнера.

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

Разрешения

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

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

Помимо разрешений Microsoft Graph, приложение также должно иметь необходимые разрешения на уровне контейнера или разрешения для вызова этого API. Дополнительные сведения о типах контейнеров см. в разделе Типы контейнеров. Дополнительные сведения о разрешениях на уровне типа контейнера см. в статье Авторизация SharePoint Embedded.

HTTP-запрос

PATCH /storage/fileStorage/containers/{containerId}/customProperties

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

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

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

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

Можно изменить следующие свойства в пользовательских свойствах.

Свойство	Тип	Описание
value	String	Значение настраиваемого свойства.
isSearchable	Логический	Указывает, доступно ли свойство для поиска.

Отклик

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

Примеры

Запрос

В следующем примере обновляется value свойство пользовательских свойств clientUniqeId и color. В этом примере isSearchable для clientUniqueId было задано значение true до вызова API.

HTTP

PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/customProperties
Content-type: application/json

{
  "clientUniqueId": {
    "value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b"
  },
  "color": {
    "value": "green"
  }
}

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const fileStorageContainerCustomPropertyDictionary = {
  clientUniqueId: {
    value: 'c5d88310-1fc7-49be-80ca-e7d7a11e638b'
  },
  color: {
    value: 'green'
  }
};

await client.api('/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/customProperties')
	.update(fileStorageContainerCustomPropertyDictionary);

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

Отклик

Ниже приводится пример отклика.

HTTP/1.1 200 Ok

{
  "clientUniqueId": {
    "value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b",
    "isSearchable": true
  },
  "color": {
    "value": "green",
    "isSearchable": false
  }
}