Информация об общем диске
Метод возвращает информацию об общем диске, в том числе количество занятого места.
Метод могут использовать как администраторы, так и другие сотрудники организации. Администратор может получить информацию о любом общем диске организации, другие сотрудники — только о том общем диске, доступ к которому у них есть.
Для OAuth-приложения необходимо наличие одного из прав:
cloud_api:disk.info
cloud_api:disk.read
Формат запроса
Метод: GET.
https://cloud-api.yandex.net/v1/disk/virtual-disks
? vd_hash=<метка общего диска>
Описание query-параметров
- vd_hash*
- Метка общего диска. Пример
vd_hash
: 9Uyws5pZmXgDNA. Метку общего диска можно получить:
- по API — с помощью метода, который возвращает информацию о статусе создания общего диска;
- в интерфейсе Яндекс Диска — перейдите в общий диск, метка будет указана в персональной строке после
vd/
.
* Обязательный параметр.
Заголовок
Authorization: OAuth <token>
Формат ответа
Успешный ответ
Если запрос был обработан без ошибок, API отвечает кодом 200 OK
и возвращает в объекте VirtualDisk ответа информацию об общем диске, в том числе название общего диска, его объем, количество занятого места, объем файлов в его корзине.
Пример ответа:
{
"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
Элемент |
Описание |
|
Общий объем общего диска, доступный пользователю, в байтах. |
|
Наименование общего диска. |
|
Идентификатор общего диска в организации. |
|
Объем файлов, находящихся в Корзине общего диска, в байтах. |
|
Метка общего диска. |
|
Количество занятого места на общем диске, в байтах. |
|
Права доступа к общему диску, которые есть у пользователя, отправляющего запрос:
|
Ответ с ошибкой
Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит описание ошибки.
Метка общего диска. Пример vd_hash
: 9Uyws5pZmXgDNA. Метку общего диска можно получить:
- по API — с помощью метода, который возвращает информацию о статусе создания общего диска;
- в интерфейсе Яндекс Диска — перейдите в общий диск, метка будет указана в персональной строке после
vd/
.
Обязательный параметр.