Редактирование доступов к общему диску
Метод задает или изменяет права доступов к общему диску в организации. Доступ можно настроить для сотрудников организации, групп и подразделений.
Метод могут использовать только администраторы организации.
Необходимые права доступа для OAuth-приложения:
cloud_api:disk.write
Формат запроса
Метод: PATCH.
https://cloud-api.yandex.net/v1/disk/virtual-disks/permissions
? vd_hash=<метка общего диска>
Описание query-параметров
- vd_hash*
- Метка общего диска. Пример
vd_hash
: 9Uyws5pZmXgDNA. Метку общего диска можно получить:
- по API — с помощью метода, который возвращает информацию о статусе создания общего диска;
- в интерфейсе Яндекс Диска — перейдите в общий диск, метка будет указана в персональной строке после
vd/
.
* Обязательный параметр.
Заголовок
Authorization: OAuth <token>
Content-Type: application/json
Тело запроса
{
"items": [
{
"org_id": 123456,
"id": 1130000006678996,
"type": "user",
"rights": [
"read",
"write"
]
},
{
"org_id": 123456,
"id": 2,
"type": "department",
"rights": [
"write",
"read"
]
},
{
"org_id": 123456,
"id": 5,
"type": "group",
"rights": [
"write"
]
}
]
}
Элемент |
Тип данных |
Описание |
|
array |
Массив объектов VirtualDiskPermissionsSubject, каждый из которых содержит информацию об отдельном субъекте (сотруднике, группе или подразделении), для которого нужно добавить или изменить доступ к общему диску. Метод PATCH при повторном использовании для одного и того же общего диска не изменяет весь список ранее заданных объектов целиком, а обновляет только те объекты, которые в нем передаются. То есть:
|
VirtualDiskPermissionsSubject
Элемент |
Тип данных |
Описание |
|
array |
Массив прав доступа к общему диску, которые назначаются субъекту:
|
|
string |
Тип субъекта:
|
|
integer |
Идентификатор субъекта:
Как получить идентификаторы сотрудников, групп и подразделений организации
|
|
integer |
Идентификатор организации, к которой принадлежит субъект. |
Формат ответа
Успешный ответ
Если запрос был обработан без ошибок, права доступа изменяются и API отвечает кодом 200 OK
.
Ответ с ошибкой
Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит описание ошибки.
Некоторые возможные ошибки:
400
— Некорректный запрос. / Ошибка инициализации данных пользователя или общего диска. / Некорректные права доступов для субъектов.403
— Доступ к ресурсу запрещен. / Общий диск заблокирован.405
— Метод запроса не поддерживается.
Метка общего диска. Пример vd_hash
: 9Uyws5pZmXgDNA. Метку общего диска можно получить:
- по API — с помощью метода, который возвращает информацию о статусе создания общего диска;
- в интерфейсе Яндекс Диска — перейдите в общий диск, метка будет указана в персональной строке после
vd/
.
Обязательный параметр.