Yandex Cloud
Поиск
Связаться с намиПопробовать бесплатно
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Искусственный интеллект
    • Безопасность
    • Инструменты DevOps
    • Бессерверные вычисления
    • Управление ресурсами
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Калькулятор цен
    • Тарифы
    • Промоакции и free tier
    • Правила тарификации
  • Истории успеха
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Identity Hub
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
    • Аутентификация
      • Overview
        • Overview
          • Overview
          • SetReplicationToken
          • ResetReplicationToken
          • CreateSynchronizationSettings
          • UpdateSynchronizationSettings
          • DeleteSynchronizationSettings
          • GetSynchronizationSettings
          • ListSupportedAttributes
  • Аудитные логи Audit Trails
  • История изменений
  • История изменений Yandex Identity Hub Sync Agent
  • Обучающие курсы

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

  • gRPC request
  • GetSynchronizationSettingsRequest
  • SynchronizationSettings
  • SynchronizationFilter
  • UserAttributeMapping
  • GroupAttributeMapping
  1. Справочник API
  2. gRPC (англ.)
  3. Identity Provider API
  4. Synchronization
  5. GetSynchronizationSettings

Identity Provider API, gRPC: SynchronizationService.GetSynchronizationSettings

Статья создана
Yandex Cloud
Обновлена 15 декабря 2025 г.
  • gRPC request
  • GetSynchronizationSettingsRequest
  • SynchronizationSettings
  • SynchronizationFilter
  • UserAttributeMapping
  • GroupAttributeMapping

Returns synchronization settings for a subject container.

gRPC requestgRPC request

rpc GetSynchronizationSettings (GetSynchronizationSettingsRequest) returns (SynchronizationSettings)

GetSynchronizationSettingsRequestGetSynchronizationSettingsRequest

{
  "subject_container_id": "string"
}

Request to get synchronization settings.

Field

Description

subject_container_id

string

Required field. ID of the subject container.

The maximum string length in characters is 50.

SynchronizationSettingsSynchronizationSettings

{
  "subject_container_id": "string",
  "filter": {
    "domain": "string",
    "groups": [
      "string"
    ],
    "organization_units": [
      "string"
    ]
  },
  "remove_user_behavior": "RemoveUserBehavior",
  "synchronization_interval": "google.protobuf.Duration",
  "allow_to_capture_users": "bool",
  "allow_to_capture_groups": "bool",
  "user_attribute_mappings": [
    {
      "source": "string",
      "target": "UserTargetAttribute",
      "type": "MappingType"
    }
  ],
  "group_attribute_mappings": [
    {
      "source": "string",
      "target": "GroupTargetAttribute",
      "type": "MappingType"
    }
  ],
  "created_at": "google.protobuf.Timestamp",
  "replacement_domain": "string"
}

Synchronization settings for a subject container.

Field

Description

subject_container_id

string

ID of the subject container.

filter

SynchronizationFilter

Filter configuration for synchronization.

remove_user_behavior

enum RemoveUserBehavior

Behavior when removing users.

  • REMOVE: Remove the user.
  • BLOCK: Block the user.

synchronization_interval

google.protobuf.Duration

Interval between synchronization runs.

allow_to_capture_users

bool

Whether users can be captured during synchronization.

allow_to_capture_groups

bool

Whether groups can be captured during synchronization.

user_attribute_mappings[]

UserAttributeMapping

User attribute mappings.

group_attribute_mappings[]

GroupAttributeMapping

Group attribute mappings.

created_at

google.protobuf.Timestamp

Timestamp when the settings were created.

replacement_domain

string

Domain replacement configuration.

SynchronizationFilterSynchronizationFilter

Filter configuration for synchronization.

Field

Description

domain

string

Required field. Domain to synchronize.

The string length in characters must be 1-253.

groups[]

string

List of groups to synchronize.

The string length in characters for each value must be 1-253. The maximum number of elements is 10.

organization_units[]

string

List of organizational units to synchronize.

The string length in characters for each value must be 1-253. The maximum number of elements is 10.

UserAttributeMappingUserAttributeMapping

User attribute mapping configuration.

Field

Description

source

string

Source attribute name.

The string length in characters must be 0-253.

target

enum UserTargetAttribute

Required field. Target attribute to map to.

  • FULL_NAME: Full name attribute.
  • GIVEN_NAME: Given name attribute.
  • FAMILY_NAME: Family name attribute.
  • EMAIL: Email attribute.
  • PHONE_NUMBER: Phone number attribute.
  • USERNAME: Username attribute.

type

enum MappingType

Required field. Type of mapping.

  • DIRECT: Direct mapping from source to target.
  • EMPTY: Empty mapping (no source attribute).

GroupAttributeMappingGroupAttributeMapping

Group attribute mapping configuration.

Field

Description

source

string

Source attribute name.

The string length in characters must be 0-253.

target

enum GroupTargetAttribute

Required field. Target attribute to map to.

  • NAME: Name attribute.
  • DESCRIPTION: Description attribute.

type

enum MappingType

Required field. Type of mapping.

  • DIRECT: Direct mapping from source to target.
  • EMPTY: Empty mapping (no source attribute).

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

Предыдущая
DeleteSynchronizationSettings
Следующая
ListSupportedAttributes
Проект Яндекса
© 2025 ООО «Яндекс.Облако»