RFC: 4511
Оригинал: Lightweight Directory Access Protocol (LDAP): The Protocol
Предыдущие версии: RFC 2251, RFC 2830, RFC 3771
Категория: Предложенный стандарт
Дата публикации:
Автор:
Перевод: Pro-LDAP.ru

4.7. Операция добавления Add

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

AddRequest ::= [APPLICATION 8] SEQUENCE {
     entry           LDAPDN,
     attributes      AttributeList }

AttributeList ::= SEQUENCE OF attribute Attribute

Поля запроса Add:

  • entry:

    Имя добавляемой записи. Серверу не нужно (SHALL NOT) выполнять какие-либо разыменования псевдонимов для определения местоположения записи, которая будет добавлена.

  • attributes:

    Список атрибутов, которые, наряду с атрибутами из RDN, составляют содержимое добавляемой записи. Клиенты могут (MAY) включать, либо могут не (MAY NOT) включать в этот список атрибут (атрибуты) RDN. Клиенты не должны (MUST NOT) предоставлять те атрибуты, которые нельзя модифицировать пользователю (NO-USER-MODIFICATION), такие как атрибуты createTimestamp или creatorsName, поскольку сервер выставляет их автоматически.

Серверы должны (MUST) обеспечить, чтобы записи удовлетворяли правилам пользовательской и системной схемы данных, а также другим ограничениям модели данных. Типы атрибутов, для которых не определено соответствие equality, подчиняются правилам из раздела 2.5.1 [RFC4512] (это относится к атрибуту именования и, кроме того, к любым добавляемым многозначным атрибутам).

Для успешного выполнения запроса AddRequest запись, имя которой указано в поле entry этого запроса, не должна (MUST NOT) существовать. Непосредственно вышестоящая (родительская) запись добавляемой записи объекта или псевдонима должна (MUST) существовать. Например, если клиент пытается добавить <CN=JS,DC=Example,DC=NET>, запись <DC=Example,DC=NET> не существует, а запись <DC=NET> существует, то сервер вернёт результирующий код noSuchObject, а поле matchedDN конструкции LDAPResult будет содержать <DC=NET>.

При получении запроса Add сервер попытается добавить указанную запись. Результат попытки добавления будет возвращён клиенту в ответе Add Response, который определяется следующим образом:

AddResponse ::= [APPLICATION 9] LDAPResult

Ответ с кодом success указывает на то, что новая запись была добавлена в каталог.

2007 - 2017 © Русские переводы RFC, IETF, ISOC.