Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Доступны в регионе
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • AI Studio
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Партнёрская программа
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Истории успеха
  • Документация
  • Блог
Проект Яндекса
© 2025 ТОО «Облачные Сервисы Казахстан»
Yandex Data Transfer
  • Доступные трансферы
  • Начало работы
    • Все инструкции
    • Подготовка к трансферу
      • Управление эндпоинтами
      • Миграция эндпоинтов в другую зону доступности
    • Управление трансфером
    • Работа с базами данных во время трансфера
    • Мониторинг состояния трансфера
  • Решение проблем
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Публичные материалы
  • Обучающие курсы

В этой статье:

  • Получить список эндпоинтов
  • Получить детальную информацию об эндпоинте
  • Создать эндпоинт
  • Изменить эндпоинт
  • Клонировать эндпоинт
  • Удалить эндпоинт
  1. Пошаговые инструкции
  2. Настройка эндпоинтов
  3. Управление эндпоинтами

Управление эндпоинтами

Статья создана
Yandex Cloud
Улучшена
Обновлена 7 мая 2025 г.
  • Получить список эндпоинтов
  • Получить детальную информацию об эндпоинте
  • Создать эндпоинт
  • Изменить эндпоинт
  • Клонировать эндпоинт
  • Удалить эндпоинт

Эндпоинт-источник описывает настройки базы данных, из которой будет передаваться информация с помощью Data Transfer, а эндпоинт-приемник — БД, в которую будет производиться перенос. Вы можете создать, изменить, клонировать или удалить такие эндпоинты.

Получить список эндпоинтовПолучить список эндпоинтов

Консоль управления
CLI
API
  1. Перейдите на страницу каталога и выберите сервис Yandex Data Transfer.
  2. На панели слева выберите Эндпоинты.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Чтобы получить список трансферов в каталоге, выполните команду:

yc datatransfer endpoint list

Воспользуйтесь методом API list.

Получить детальную информацию об эндпоинтеПолучить детальную информацию об эндпоинте

Консоль управления
CLI
API
  1. Перейдите на страницу каталога и выберите сервис Yandex Data Transfer.
  2. На панели слева выберите Эндпоинты.
  3. Нажмите на имя нужного эндпоинта.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Чтобы получить информацию об эндпоинте, выполните команду:

yc datatransfer endpoint get <идентификатор_эндпоинта>

Идентификатор эндпоинта можно получить со списком эндпоинтов в каталоге.

Воспользуйтесь методом API get и передайте значение идентификатора эндпоинта в параметре endpointId запроса.

Чтобы узнать идентификатор эндпоинта, получите список эндпоинтов в каталоге.

Создать эндпоинтСоздать эндпоинт

Важно

Для создания или редактирования эндпоинта управляемой базы данных вам потребуется сервисная или примитивная роль viewer, выданная на каталог кластера этой управляемой базы данных.

Консоль управления
CLI
Terraform
API
  1. Перейдите на страницу каталога и выберите сервис Yandex Data Transfer.

  2. На панели слева выберите Эндпоинты.

  3. Нажмите кнопку Создать эндпоинт.

  4. В поле Направление выберите Источник или Приёмник.

  5. Укажите имя эндпоинта. Используйте строчные латинские буквы и цифры.

  6. (Опционально) Укажите описание эндпоинта.

  7. Выберите нужное значение в поле Тип базы данных. Будет создан эндпоинт соответствующего типа.

  8. Задайте параметры эндпоинта:

    • Источники:

      • Airbyte®:
        • AWS CloudTrail
        • BigQuery
        • MS SQL Server
        • S3
      • Apache Kafka®
      • ClickHouse®
      • Greenplum®
      • MongoDB
      • MySQL®
      • Object Storage
      • Oracle
      • PostgreSQL
    • Приемники:

      • Apache Kafka®
      • ClickHouse®
      • Elasticsearch
      • Greenplum®
      • MongoDB
      • MySQL®
      • Object Storage
      • OpenSearch
      • PostgreSQL
  9. Нажмите кнопку Создать эндпоинт.

Примечание

Создание эндпоинта с помощью команд CLI поддерживается только для источников и приемников типа ClickHouse®, MongoDB, MySQL® и PostgreSQL.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

  1. Посмотрите описание команды CLI для создания эндпоинта:

    yc datatransfer endpoint create --help
    
  2. Укажите параметры эндпоинта в команде создания (в примере приведены не все параметры):

    yc datatransfer endpoint create <тип_эндпоинта> \
      --name <имя_эндпоинта> \
      --description <описание_эндпоинта> \
      <параметры_эндпоинта>
    

    Тип эндпоинта и его параметры см. в разделе настроек для нужного источника или приемника данных.

Примечание

Создание эндпоинта с помощью Terraform поддерживается только для источников и приемников типа ClickHouse®, MongoDB, MySQL® и PostgreSQL.

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

  1. Создайте конфигурационный файл с описанием эндпоинта.

    Пример структуры конфигурационного файла:

    resource "ycp_datatransfer_endpoint" "<имя_эндпоинта_в_Terraform>" {
      name = "<имя_эндпоинта>"
      settings {
        <тип_эндпоинта> {
          <параметры_эндпоинта>
        }
      }
    }
    

Полную схему ресурсов можно получить, запустив terraform providers schema.

  1. Тип эндпоинта и его параметры см. в разделе настроек для нужного источника или приемника данных.

  2. Проверьте корректность настроек.

    1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.

    2. Выполните команду:

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

  3. Подтвердите изменение ресурсов.

    1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

    2. Если вас устраивают планируемые изменения, внесите их:

      1. Выполните команду:

        terraform apply
        
      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

  4. Подробнее см. в документации провайдера Terraform.

Примечание

Создание эндпоинта с помощью API поддерживается только для источников и приемников типа ClickHouse®, Apache Kafka®, MongoDB, MySQL® и PostgreSQL.

Воспользуйтесь методом API create и передайте в запросе:

  • Идентификатор каталога, в котором должен быть размещен эндпоинт, в параметре folderId.
  • Имя эндпоинта в параметре name.
  • Описание эндпоинта в параметре description.
  • Параметры эндпоинта в параметре settings.

Параметры эндпоинта см. в разделе настроек для нужного источника или приемника данных.

Изменить эндпоинтИзменить эндпоинт

Важно

Для создания или редактирования эндпоинта управляемой базы данных вам потребуется сервисная или примитивная роль viewer, выданная на каталог кластера этой управляемой базы данных.

Примечание

Тип эндпоинта и тип БД нельзя изменить. Для ряда эндпоинтов невозможно также изменить тип подключения.

Консоль управления
CLI
Terraform
API
  1. Перейдите на страницу каталога и выберите сервис Yandex Data Transfer.

  2. На панели слева выберите Эндпоинты.

  3. Выберите эндпоинт и нажмите кнопку Редактировать на панели сверху.

  4. Отредактируйте параметры эндпоинта:

    • Источники:

      • Airbyte®:
        • AWS CloudTrail
        • BigQuery
        • MS SQL Server
        • S3
      • Apache Kafka®
      • ClickHouse®
      • Greenplum®
      • MongoDB
      • MySQL®
      • Object Storage
      • Oracle
      • PostgreSQL
    • Приемники:

      • Apache Kafka®
      • ClickHouse®
      • Elasticsearch
      • Greenplum®
      • MongoDB
      • MySQL®
      • Object Storage
      • OpenSearch
      • PostgreSQL
  5. Нажмите кнопку Применить.

Примечание

Изменение эндпоинта с помощью команд CLI поддерживается только для источников и приемников типа ClickHouse®, MongoDB, MySQL® и PostgreSQL.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Чтобы изменить настройки эндпоинта:

  1. Посмотрите описание команды CLI для изменения трансфера:

    yc datatransfer endpoint update --help
    
  2. Выполните команду, передав список настроек, которые хотите изменить (в примере приведены не все параметры):

    yc datatransfer transfer update <тип_эндпоинта> <идентификатор_эндпоинта> \
      --name <имя_эндпоинта> \
      --description <описание_эндпоинта> \
      <параметры_эндпоинта>
    

    Тип эндпоинта и его параметры см. в разделе настроек для нужного источника или приемника данных. Идентификатор эндпоинта можно получить со списком эндпоинтов в каталоге.

  1. Откройте актуальный конфигурационный файл Terraform с описанием эндпоинта.

    О том, как создать такой файл, см. в подразделе Создать эндпоинт.

  2. Измените значение поля name (имя эндпоинта) и параметры эндпоинта в блоке settings.

  3. Проверьте корректность настроек.

    1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.

    2. Выполните команду:

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

  4. Подтвердите изменение ресурсов.

    1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

    2. Если вас устраивают планируемые изменения, внесите их:

      1. Выполните команду:

        terraform apply
        
      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

Примечание

Изменение эндпоинта с помощью API поддерживается только для источников и приемников типа ClickHouse®, Apache Kafka®, MongoDB, MySQL® и PostgreSQL.

Воспользуйтесь методом API update и передайте в запросе:

  • Идентификатор эндпоинта в параметре endpointId
  • Имя эндпоинта в параметре name.
  • Описание эндпоинта в параметре description.
  • Параметры эндпоинта в параметре settings.

Идентификатор эндпоинта можно получить со списком эндпоинтов в каталоге.

Изменение настроек эндпоинта для трансфера с типом Репликация в статусе Реплицируется приведет к перезапуску трансфера.

Клонировать эндпоинтКлонировать эндпоинт

Примечание

При клонировании нельзя изменить тип эндпоинта и тип БД.

Консоль управления
  1. Перейдите на страницу каталога и выберите сервис Yandex Data Transfer.

  2. На панели слева выберите Эндпоинты.

  3. Выберите эндпоинт, который нужно клонировать.

  4. Нажмите кнопку Клонировать на панели сверху.

  5. Задайте имя нового эндпоинта и при необходимости отредактируйте остальные параметры:

    • Источники:

      • Airbyte®:
        • AWS CloudTrail
        • BigQuery
        • MS SQL Server
        • S3
      • Apache Kafka®
      • ClickHouse®
      • Greenplum®
      • MongoDB
      • MySQL®
      • Object Storage
      • Oracle
      • PostgreSQL
    • Приемники:

      • Apache Kafka®
      • ClickHouse®
      • Elasticsearch
      • Greenplum®
      • MongoDB
      • MySQL®
      • Object Storage
      • OpenSearch
      • PostgreSQL
  6. Нажмите кнопку Создать эндпоинт.

Удалить эндпоинтУдалить эндпоинт

Важно

Перед удалением эндпоинта удалите все трансферы, в которые он входит.

Чтобы удалить эндпоинт:

Консоль управления
CLI
Terraform
API
  1. Перейдите на страницу каталога и выберите сервис Yandex Data Transfer.
  2. На панели слева выберите Эндпоинты.
  3. Выберите эндпоинт, который нужно удалить.
  4. Нажмите кнопку Удалить на панели сверху.
  5. В открывшемся окне нажмите кнопку Удалить.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Чтобы удалить эндпоинт, выполните команду:

yc datatransfer endpoint delete <идентификатор_эндпоинта>

Идентификатор эндпоинта можно получить со списком эндпоинтов в каталоге.

Чтобы удалить эндпоинт, созданный с помощью Terraform:

  1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

    О том, как создать такой файл, см. в разделе Создать эндпоинт.

  2. Убедитесь, что удаляемый эндпоинт не привязан ни к какому трансферу.

  3. Удалите описание эндпоинта.

  4. Проверьте корректность настроек.

    1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.

    2. Выполните команду:

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

  5. Введите слово yes и нажмите Enter.

    1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

    2. Если вас устраивают планируемые изменения, внесите их:

      1. Выполните команду:

        terraform apply
        
      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

Подробнее см. в документации провайдера Terraform.

Воспользуйтесь методом API delete и передайте идентификатор нужного эндпоинта в параметре endpointId запроса.

Идентификатор эндпоинта можно получить со списком эндпоинтов в каталоге.

Greenplum® и Greenplum Database® являются зарегистрированными товарными знаками или товарными знаками Broadcom Inc в США и/или других странах.

ClickHouse® является зарегистрированным товарным знаком ClickHouse, Inc.

Была ли статья полезна?

Предыдущая
Подготовка к трансферу
Следующая
Миграция эндпоинтов в другую зону доступности
Проект Яндекса
© 2025 ТОО «Облачные Сервисы Казахстан»