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

# Информация об общем диске

Метод возвращает информацию об общем диске, в том числе количество занятого места.

Метод могут использовать как администраторы, так и другие сотрудники организации. Администратор может получить информацию о любом общем диске организации, другие сотрудники — только о том общем диске, доступ к которому у них есть.

Для OAuth-приложения необходимо наличие одного из прав:
* `cloud_api:disk.info`
* `cloud_api:disk.read`


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

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

```
https://cloud-api.yandex.net/v1/disk/virtual-disks
 ? [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>
```

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

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

Если запрос был обработан без ошибок, API отвечает кодом `200 OK` и возвращает в объекте [VirtualDisk](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#virtualdisk) ответа информацию об общем диске, в том числе название общего диска, его объем, количество занятого места, объем файлов в его корзине.

Пример ответа:

```json
{
  "total_space": 10737418240,
  "name": "First Group",
  "resource_id": "057583f5-3313-492b-bub5-da428e0c9846",
  "trash_size": 0,
  "vd_hash": "9Uyws5pZmXgDNA",
  "used_space": 138936,
  "permissions": [
    "read"
  ]
}
```

#### Описание элементов ответа

**VirtualDisk**

<!-- source: ru/_includes/reference/response-objects/id-link/virtualdisk-table.md -->


#|
|| **Элемент** | **Описание** ||
||`total_space` | Общий объем общего диска, доступный пользователю, в байтах. ||
||`name` | Наименование общего диска. ||
||`resource_id` | Идентификатор общего диска в организации. ||
||`trash_size` | Объем файлов, находящихся в Корзине общего диска, в байтах. ||
||`vd_hash` | Метка общего диска. ||
||`used_space` | Количество занятого места на общем диске, в байтах. ||
||`permissions` | 
Права доступа к общему диску, которые есть у пользователя, отправляющего запрос:
- `read` — чтение данных общего диска;
- `write` — запись в любом месте общего диска;
- `delete` — удаление общего диска (данное право есть только у администраторов организации).||
|#
<!-- endsource: ru/_includes/reference/response-objects/id-link/virtualdisk-table.md -->

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

<!-- 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 -->

[*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]: Обязательный параметр.