[Документация Yandex Cloud](../../../index.md) > [Yandex API Gateway](../../index.md) > [Пошаговые инструкции](../index.md) > [Конструктор спецификаций](index.md) > Managed Service for YDB

# Добавить расширение x-yc-apigateway-integration:cloud_ydb

{% list tabs %}

- Консоль управления

    1. В [консоли управления](https://kz.console.yandex.cloud) выберите [каталог](../../../resource-manager/concepts/resources-hierarchy.md#folder), в котором создали или хотите создать [API-шлюз](../../concepts/index.md).
    1. Перейдите в сервис **API Gateway**.
    1. Выберите API-шлюз или нажмите кнопку **Создать API-шлюз**, чтобы создать новый.
    1. Нажмите кнопку ![image](../../../_assets/console-icons/pencil.svg) **Редактировать**.
    1. В поле **Спецификация** нажмите значок ![image](../../../_assets/api-gateway/spec-constructor/cloud-ydb.svg).
    1. Укажите в поле:

        * **Путь** — относительный путь к интеграции, который будет добавлен к URL-адресу API Gateway. Переменные указывайте в фигурных скобках, например `/static/{function_id}`. Подробнее в спецификации [OpenAPI 3.0](https://github.com/OAI/OpenAPI-Specification).
        * **HTTP-метод** — метод, который будет использоваться для взаимодействия с интеграцией.

        * **Сервисный аккаунт** — сервисный аккаунт для авторизации при обращении к [базе данных](../../../ydb/concepts/resources.md#database). Если у вас нет сервисного аккаунта, [создайте](../../../iam/operations/sa/create.md) его.
        * **База данных** — имя базы данных.
        * **Таблица** — название таблицы, с которой будет выполняться операция.
        * **Операция** — [тип операции](../../concepts/extensions/ydb.md#podderzhivaemye-operacii) и параметры, соответствующие этому типу операции:

            * `PutItem`.
            * `GetItem`:

                * **Ключ** — первичный ключ элемента, с которым будет выполняться операция.

            * `UpdateItem`:

                * **Ключ** — первичный ключ элемента, с которым будет выполняться операция.
                * **Выражение для обновления** — выражение, которое будет определять, как и какие атрибуты нужно обновить.
                * (Опционально) **Алиас** — алиас, который можно использовать в выражении для обновления вместо значения атрибута. Алиас должен начинаться с символа двоеточия `:`.

            * `DeleteItem`:

                * **Ключ** — первичный ключ элемента, с которым будет выполняться операция.

            * `Scan`:

                * (Опционально) **Лимит** — максимальное количество прочитанных элементов.
                * (Опционально) **Первичный ключ элемента** — первичный ключ элемента, с которого должен начинаться поиск.

    1. Нажмите кнопку **Добавить**.

{% endlist %}

В поле **Спецификация** отобразится OpenAPI-спецификация с указанными значениями параметров.

## Полезные ссылки {#see-also}

* [Расширение x-yc-apigateway-integration:cloud_ydb](../../concepts/extensions/ydb.md)