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

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

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

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


{% note warning %}

Создавать общие диски можно только после оплаты лимита на их создание. Как купить лимит, описано в [Справке по тарифам и оплате](https://yandex.ru/support/yandex-360/business/purchase/ru/upgrade/shared-disk.html) Яндекс 360 для бизнеса.

{% endnote %}


Создание общего диска может занимать некоторое время. Дождитесь успешного ответа на [запрос о статусе](https://yandex.ru/dev/disk-api/doc/ru/reference/shared-disks/shd-create-state.md) этого процесса. Так вы получите метку общего диска. Только после этого можно предоставлять права доступа к нему.

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


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

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

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

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

org_id[*](*popup-a)
: <!-- source: ru/_includes/reference/term-org-id.md -->
  Идентификатор организации в Яндекс 360 для бизнеса.

  Чтобы посмотреть идентификатор в интерфейсе, откройте [кабинет организации](https://admin.yandex.ru) и выберите **Общие настройки** → **Профиль организации**. Идентификатор будет указан под названием организации.
  <!-- endsource: ru/_includes/reference/term-org-id.md -->

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

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

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

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

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

#|
|| **Параметр** | **Тип данных** | **Описание** ||
||`name`[*](*popup-a) | string | Название общего диска. Минимальная длина — 2, максимальная длина — 255. ||
||`description`[*](*popup-a) | string | Описание общего диска. Максимальная длина — 512. ||
|#


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

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

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

{% note warning %}

Сохраните полученный идентификатор. Без него вы не сможете отправить запрос на получение статуса создания общего диска и дальше работать с созданным общим диском через API.

{% endnote %}

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

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

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

**VirtualDiskResourceID**

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


#|
|| **Элемент** | **Описание** ||
|| `resource_id` | Идентификатор общего диска в организации. ||
|#
<!-- endsource: ru/_includes/reference/response-objects/id-link/virtualdiskresourceid-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-org_id]: Идентификатор организации в Яндекс 360 для бизнеса.

Чтобы посмотреть идентификатор в интерфейсе, откройте [кабинет организации](https://admin.yandex.ru) и выберите **Общие настройки** → **Профиль организации**. Идентификатор будет указан под названием организации.

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