Добавление пользовательских свойств в файлStorageContainer
Пространство имен: microsoft.graph
Добавьте пользовательские свойства в объект fileStorageContainer .
Разрешения
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения | Разрешения с наименьшими привилегиями | Более высокие привилегированные разрешения |
---|---|---|
Делегированные (рабочая или учебная учетная запись) | FileStorageContainer.Selected | Недоступно. |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. | Не поддерживается. |
Приложение | FileStorageContainer.Selected | Недоступно. |
Помимо разрешений Microsoft Graph, приложение также должно иметь необходимые разрешения на уровне контейнера или разрешения для вызова этого API. Дополнительные сведения о типах контейнеров см. в разделе Типы контейнеров. Дополнительные сведения о разрешениях на уровне типа контейнера см. в статье Авторизация SharePoint Embedded.
HTTP-запрос
PATCH /storage/fileStorage/containers/{containerId}/customProperties
Заголовки запросов
Имя | Описание |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Content-Type | application/json. Обязательно. |
Текст запроса
В тексте запроса укажите представление в формате JSON файлаStorageContainerCustomPropertyDictionary, которое представляет собой карту со строковыми ключами и значениями fileStorageContainerCustomPropertyValue .
При создании пользовательского свойства можно указать следующие свойства.
Свойство | Тип | Описание |
---|---|---|
value | String | Значение настраиваемого свойства. Обязательно. |
isSearchable | Логический | Флаг, указывающий, доступно ли свойство для поиска. Необязательный параметр. Значение по умолчанию — false . |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 Created
.
Примеры
Пример 1. Создание пользовательского свойства
Запрос
В следующем примере показано, как создать пользовательское свойство с именем clientUniqueId
для контейнера.
PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containers/{containerId}/customProperties
Content-Type: application/json
{
"clientUniqueId": {
"value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b"
}
}
Отклик
Ниже показан пример отклика. По умолчанию свойство недоступно для поиска.
HTTP/1.1 200 Created
Пример 2. Создание настраиваемого свойства для поиска
Запрос
В следующем примере показано, как создать пользовательское свойство clientUniqueId
с возможностью поиска для контейнера.
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",
"isSearchable": true
}
}
Отклик
Ниже приводится пример отклика.
HTTP/1.1 200 Created