Копирование ресурса DriveItem
Асинхронно создает копию элемента driveItem (включая все дочерние элементы) в новом родительском элементе или с новым именем.
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения | Разрешения (в порядке повышения привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Files.ReadWrite, Files.ReadWrite.All |
Для приложений | Files.ReadWrite.All, Sites.ReadWrite.All |
HTTP-запрос
POST /drives/{driveId}/items/{itemId}/copy
POST /groups/{groupId}/drive/items/{itemId}/copy
POST /me/drive/items/{item-id}/copy
POST /sites/{siteId}/drive/items/{itemId}/copy
POST /users/{userId}/drive/items/{itemId}/copy
Текст запроса
В тексте запроса предоставьте JSON-объект с указанными ниже параметрами.
Имя | Значение | Описание |
---|---|---|
parentReference | ItemReference | Необязательный. Отсылает к родительскому элементу, в котором будет создана копия. |
name | string | Необязательный. Новое имя копии. Если оно не предоставлено, будет использовано такое же имя, как в оригинале. |
Примечание. Элемент parentReference должен включать параметры driveId
и id
для целевой папки.
Пример
В этом примере показано, как копировать файл с идентификатором {item-id}
в папку с идентификатором driveId
и значением id
.
У новой копии файла будет имя contoso plan (copy).txt
.
POST /me/drive/items/{item-id}/copy
Content-Type: application/json
{
"parentReference": {
"driveId": "6F7D00BF-FC4D-4E62-9769-6AEA81F3A21B",
"id": "DCD0D3AD-8989-4F23-A5A2-2C086050513F"
},
"name": "contoso plan (copy).txt"
}
Отклик
Возвращает сведения о том, как отслеживать ход копирования после принятия запроса.
HTTP/1.1 202 Accepted
Location: https://contoso.sharepoint.com/_api/v2.0/monitor/4A3407B5-88FC-4504-8B21-0AABD3412717
В значении заголовка Location
имеется URL-адрес службы, которая возвращает сведения о текущем состоянии операции копирования.
Вы можете использовать эти сведения, чтобы определить, когда копирование будет завершено.
Замечания
Во многих случаях копирование выполняется асинхронно. Отклик API указывает, что операция копирования принята или отклонена, например из-за использования имени конечного файла.