Описание: Скопировать один или несколько элементов (с возможной вложенной иерархией) в указанную папку/родителя. Требует право create на целевого родителя (если вызывающий не администратор). Для каждого узла можно независимо управлять тем, что именно копировать: содержимое файла, права доступа, метаданные (прочие поля), дочерние элементы, а также нужно ли по завершении скопировать и связи (references), у которых источник — один из скопированных элементов.
🌐 HTTP-информация
- Метод:
POST - URL:
/api/item/Copy/{parentId} - Headers:
Content-Type: application/jsonAuthorization: <UserSessionToken>
📥 Параметры запроса (URL Path)
| Параметр | Тип | Описание |
|---|---|---|
parentId | Guid | ID папки/родителя, в который копируются элементы |
📦 Тело запроса (Request Body)
Тело — массив узлов копирования.
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
id | Guid | Да | ID копируемого исходного элемента |
isFileCopy | bool | Нет | Копировать содержимое файла (для файловых элементов). По умолчанию true |
isPermissionCopy | bool | Нет | Копировать назначенные права доступа. По умолчанию true |
isMetadataCopy | bool | Нет | Копировать остальные метаданные (поля) элемента. По умолчанию true |
isChildListCopy / isChildListCopyRequired | bool | Нет | Рекурсивно скопировать все дочерние элементы. По умолчанию false |
childNodeList | object[] | Нет | Явный список конкретных дочерних узлов для копирования (используется вместо полного рекурсивного копирования, когда isChildListCopy не установлен) — формат каждого элемента такой же, как у узла верхнего уровня |
isReferenceCopy | bool | Нет | Если у всех узлов запроса установлено true (или не указано — по умолчанию true) — по завершании копирования также копируются ссылки (references), исходящие из скопированных элементов, на новые копии |
Пример JSON-тела:
[
{
"id": "622dddbb-2db2-433d-9d3c-89f31ea22e64",
"isChildListCopy": true
}
]
📤 Тело ответа (Response Body)
Метод ничего не возвращает (void, HTTP 200 OK без тела в случае успеха).