Создание общего диска

Метод создает общий диск в вашей организации. В ответе возвращается идентификатор нового общего диска.

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

Создание общего диска может занимать некоторое время. Дождитесь успешного ответа на запрос о статусе этого процесса. Так вы получите метку общего диска. Только после этого можно предоставлять права доступа к нему.

Необходимые права доступа для OAuth-приложения:

• cloud_api:disk.read
• cloud_api:disk.write

Формат запроса

Метод: POST.

https://cloud-api.yandex.net/v1/disk/virtual-disks
 ? org_id=<идентификатор организации>

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

org_id*

Идентификатор организации в Яндекс 360 для бизнеса.

Чтобы посмотреть идентификатор в интерфейсе, откройте кабинет организации и выберите Общие настройки → Профиль организации. Идентификатор будет указан под названием организации.

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

Заголовок

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

Тело запроса

{
  "name": "Общий_диск 1",
  "description": "Описание общего_диска 1"
}

Формат ответа

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

Если запрос был обработан без ошибок, API отвечает кодом 200 OK и возвращает идентификатор созданного общего диска в теле ответа в объекте VirtualDiskResourceID.

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

{
  "resource_id": "440050dc-178a-4ae2-beca-ae0567e4b0bf"
}

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

VirtualDiskResourceID

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

Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит описание ошибки.