---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/disk-api/doc/ru/reference/shared-disks/shd-permisedit.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/disk-api/doc/ru/llms.txt

# Редактирование доступов к общему диску

Метод задает или изменяет права доступов к общему диску в организации. Доступ можно настроить для сотрудников организации, групп и подразделений.

Метод могут использовать только администраторы организации.

Необходимые права доступа для OAuth-приложения:
* `cloud_api:disk.write`


## Формат запроса {#format}

Метод: ##PATCH##.

```
https://cloud-api.yandex.net/v1/disk/virtual-disks/permissions
 ? [vd_hash](*popup-vd_hash)=<метка общего диска>
```

### Описание query-параметров {#query}

vd_hash[*](*popup-a)
: Метка общего диска. Пример `vd_hash`: ##9Uyws5pZmXgDNA##. Метку общего диска можно получить:

- по API — с помощью [метода](https://yandex.ru/dev/disk-api/doc/ru/reference/shared-disks/shd-create-state.md), который возвращает информацию о статусе создания общего диска;
- в интерфейсе Яндекс Диска — перейдите в общий диск, метка будет указана в персональной строке после `vd/`.


\* Обязательный параметр.

### Заголовок {#header}

```
Authorization: OAuth <token>
Content-Type: application/json
```

### Тело запроса {#body}

```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"
      ]
    }
  ]
}

```

#|
|| **Элемент** | **Тип данных** | **Описание** ||
|| `items` | array | Массив объектов **VirtualDiskPermissionsSubject**, каждый из которых содержит информацию об отдельном субъекте (сотруднике, группе или подразделении), для которого нужно добавить или изменить доступ к общему диску.

Метод PATCH при повторном использовании для одного и того же общего диска не изменяет весь список ранее заданных объектов целиком, а обновляет только те объекты, которые в нем передаются. То есть:
- для изменения прав субъекта (сотрудника, группы или подразделения) отправьте в запросе только описывающий его объект VirtualDiskPermissionsSubject с новым списком прав;
- для удаления прав доступа субъекта к общему диску отправьте объект VirtualDiskPermissionsSubject с пустым списком в поле `rights`. ||
|#

**VirtualDiskPermissionsSubject**

#|
|| **Элемент** | **Тип данных** | **Описание** ||
||`rights` | array |
Массив прав доступа к общему диску, которые назначаются субъекту:
- `read` — чтение данных общего диска;
- `write` — запись в любом месте общего диска.||
||`type` | string |
Тип субъекта:
- `user` — сотрудник организации;
- `group` — группа;
- `department` — подразделение.||
||`id` | integer | Идентификатор субъекта:
- для типа `user` — идентификатор сотрудника;
- для типа `group` — идентификатор группы;
- для типа `department` — идентификатор подразделения.

{% cut "Как получить идентификаторы сотрудников, групп и подразделений организации" %}


- С помощью API Яндекс 360 для бизнеса. Описания методов приведены в разделах:
  * [Сотрудники](https://yandex.ru/dev/api360/doc/ru/ref/UserService/UserService_List.html) — идентификаторы сотрудников возвращаются в ответе на запрос в поле `id` массива `users`.
  * [Группы](https://yandex.ru/dev/api360/doc/ru/ref/GroupService/GroupService_List) — идентификаторы групп возвращаются в ответе на запрос в поле `id` массива `groups`.
  * [Подразделения](https://yandex.ru/dev/api360/doc/ru/ref/DepartmentService/DepartmentService_List) — идентификаторы подразделений возвращаются в ответе на запрос в поле `id` массива `departments`.


- Идентификаторы сотрудников также можно получить через интерфейс кабинета организации Яндекс 360 для бизнеса [https://admin.yandex.ru](https://admin.yandex.ru):
  1. Выберите **Пользователи** → **Сотрудники**.
  2. Найдите строчку нужного сотрудника и нажмите на его имя.
  3. Правой кнопкой нажмите на логин сотрудника и скопируйте адрес ссылки.
  4. Вставьте адрес в любой текстовый редактор. Идентификатор сотрудника — это часть адреса после `uid=`.

{% endcut %}

||
||`org_id` | integer | Идентификатор организации, к которой принадлежит субъект. ||
|#


## Формат ответа {#response}

### Успешный ответ

Если запрос был обработан без ошибок, права доступа изменяются и API отвечает кодом `200 OK`.

### Ответ с ошибкой

<!-- source: ru/_includes/reference/response-error.md -->
Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит [описание ошибки](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#error).
<!-- endsource: ru/_includes/reference/response-error.md -->

Некоторые возможные ошибки:

* `400` — Некорректный запрос. / Ошибка инициализации данных пользователя или общего диска. / Некорректные права доступов для субъектов.
* `403` — Доступ к ресурсу запрещен. / Общий диск заблокирован.
* `405` — Метод запроса не поддерживается.

[*popup-vd_hash]: Метка общего диска. Пример `vd_hash`: ##9Uyws5pZmXgDNA##. Метку общего диска можно получить:

- по API — с помощью [метода](https://yandex.ru/dev/disk-api/doc/ru/reference/shared-disks/shd-create-state.md), который возвращает информацию о статусе создания общего диска;
- в интерфейсе Яндекс Диска — перейдите в общий диск, метка будет указана в персональной строке после `vd/`.

[*popup-a]: Обязательный параметр.