# Подключение S3 хранилища Yandex Cloud

### Создание бакета

1. Перейдите в консоль Yandex Cloud ([ссылка](https://console.yandex.cloud/)).
2. Перейдите в раздел "**Все сервисы**" -> "**Object Storage**".

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FjB5yYiQ0VqkHUPCsmxlR%2FYandexObjectStorageSection.png?alt=media&#x26;token=ccbdd5f2-98f6-454e-92e1-e5da735bbe81" alt=""><figcaption><p>Раздел "Object Storage"</p></figcaption></figure>

3. Нажмите "**Создать бакет**".

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F1pdbPZuDw4Ja9rK4OXkn%2FYandexS3createBucket.png?alt=media&#x26;token=5e3e8d0e-9433-40d6-ad7f-a1ba01712666" alt=""><figcaption><p>Кнопка "Создать бакет"</p></figcaption></figure>

4. Заполните следующие параметры для создаваемого бакета:

* **Имя** — укажите название бакета (в нашем примере - `mikopbx-s3-storage`). Имя должно быть уникальным в рамках всего Yandex Cloud.
* **Макс. размер** — задайте максимальный объём бакета. Рекомендуется установить значение, соответствующее вашим потребностям (не менее 50 ГБ для рабочей станции), чтобы контролировать расход облачного пространства. Если ограничение не нужно — отметьте **«Без ограничения»**.
* **Доступ** — для всех трёх параметров (Чтение объектов, Чтение списка объектов, Чтение настроек) выберите значение **«С авторизацией»**.&#x20;

После заполнения всех параметров нажмите кнопку **«Создать бакет»**.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FidtBbWd2DONuYYjNBPP9%2FYandexS3bucketParams.png?alt=media&#x26;token=e21e5ce2-0b5a-4c81-83b7-88ffdda157dc" alt=""><figcaption><p>Параметры создаваемого бакета</p></figcaption></figure>

### Создание сервисного аккаунта

1. Перейдите в раздел "**Все сервисы**" -> "**Identity and Access Management**".

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FLgzTmeUORoRi8T59GKiL%2FYandexS3IdentityAccessManagement.png?alt=media&#x26;token=7090c3e8-815c-4911-8151-c5684bde2b26" alt=""><figcaption><p>Раздел "<strong>Identity and Access Management</strong>"</p></figcaption></figure>

2. Нажмите "**Создать сервисный аккаунт**".

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FvLDeWmqnPeJIpaYmUimf%2FYandexS3CreateServiceAccount.png?alt=media&#x26;token=67eb2830-5fea-4b5d-9ae0-384c59e33109" alt=""><figcaption><p>Кнопка "<strong>Создать сервисный аккаунт</strong>"</p></figcaption></figure>

3. Укажите следующие параметры:

* **Имя** — введите название сервисного аккаунта (например, `mikopbx-s3-access`).
* **Роли в каталоге** — нажмите **«Добавить роль»**, в строке поиска введите `storage` и выберите роль **`storage.editor`**. Эта роль даёт необходимые права.

После заполнения параметров нажмите **«Создать»**.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FfzWI11tCIdarLJyQxMZT%2FYandexS3-ServiceAccParams.png?alt=media&#x26;token=c13cffd7-a0b9-4628-a6c2-edf9129e0ea1" alt=""><figcaption><p>Параметры создаваемого сервисного аккаунта</p></figcaption></figure>

4. Перейдите в дашбоард созданного сервисного аккаунта, нажав на его название.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FkyIDOvId2QRygrwD72uA%2FYandexS3CreatedServiceAcc.png?alt=media&#x26;token=fb94aacb-1e16-44a9-bac1-dda91886d518" alt=""><figcaption><p>Созданный сервисный аккаунт</p></figcaption></figure>

5. Нажмите "**Создать новый ключ**" -> "**Создать статический ключ доступа**".

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2F7dsgnoOV5pFzqXceKv4F%2FYandexS3CreateNewKey.png?alt=media&#x26;token=bc247427-bdc5-4b08-88ee-c5a378659c0f" alt=""><figcaption><p>Создание нового ключа для сервисного аккаунта</p></figcaption></figure>

6\. Введите описание для создаваемого ключа и нажмите "Создать".

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FBLX2eyitzLDascswVnNB%2FYandexS3CreateNewKey-Description.png?alt=media&#x26;token=6f5ff73f-dbe9-4d2c-bb88-d830ffde75ba" alt=""><figcaption><p>Описание создаваемого ключа</p></figcaption></figure>

Будут отображены идентифкатор ключа и секретный ключ. Сохраните эти значения, они понадябтся позже для подключения хранилища к MikoPBX.

{% hint style="warning" %}
После закрытия диалога значение ключа будет недоступно.
{% endhint %}

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FCFwmZu69GldS3QojQh1J%2FYandexS3-Keys.png?alt=media&#x26;token=8a3f83bc-9b5b-4833-b748-28fdc599fcfe" alt=""><figcaption><p>Созданный идентификатор и ключ</p></figcaption></figure>

### Подключение к MikoPBX

1. Перейдите во вкладку "**Обслуживание**" -> "**Хранилище**".

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FVh9ckEtlndQrQYo5RgKY%2FMikoPBXstorageSection-cut.png?alt=media&#x26;token=19e1d9f5-252b-4942-a780-33314b3b4490" alt=""><figcaption><p>Раздел "<strong>Хранилище</strong>"</p></figcaption></figure>

2. Перейдите на вкладку "**Облачное хранилище S3**" и заполните следующие поля:

* **Автоматическая загрузка записей в облачное хранилище** — включите переключатель.
* **URL точки доступа S3** — введите `https://storage.yandexcloud.net`
* **Регион S3** — укажите регион Вашего аккаунта в Yandex Cloud, в этой инструкции - `ru-central1`
* **Имя бакета S3** — укажите имя бакета, созданного в Яндекс Cloud (например, `mikopbx-s3-storage` в этой инструкции)
* **Ключ доступа** и **Секретный ключ** — вставьте значения, полученные при создании статического ключа сервисного аккаунта.

Настройте ползунок **«Локальное хранение (режим S3)»** — выберите, как долго записи будут храниться локально до удаления после выгрузки в облако.

{% hint style="info" %}
Более короткое локальное хранение быстрее освобождает дисковое пространство.
{% endhint %}

Нажмите **«Сохранить»**.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FLIUk5JxVF97HIIZWjhva%2FcloudStorageS3Section.png?alt=media&#x26;token=fdf418b5-2b5d-40cb-856a-a26f14670b56" alt=""><figcaption><p>Параметры для подключения S3 Yandex Cloud</p></figcaption></figure>

После сохранения настроек нажмите "Проверить соединение". При успешном подключении появится сообщение «**Подключено к S3**» и начнется синхронизация записей телефонных разговоров.

<figure><img src="https://3704471835-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MPK4TuzRBnP7rt8htho-887967055%2Fuploads%2FYPDV5NRbfPmJ9ZcCmo0t%2FcloudStorageSuccessful.png?alt=media&#x26;token=42041019-efc5-4369-b9b5-465ddbc9a45b" alt=""><figcaption><p>Успешное подключение</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mikopbx.com/mikopbx/manual/maintenance/storage/yandex.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
