Поделиться через


driveItem: copy

Пространство имен: microsoft.graph

Асинхронно создает копию элемента driveItem (включая все дочерние элементы) в новом родительском элементе или с новым именем.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого 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

Необязательные параметры запросов

Этот метод поддерживает @microsoft.graph.conflictBehavior параметр запроса для настройки поведения при возникновении конфликта.

Значение Описание
сбой По умолчанию сообщается о сбое.
replace Перезаписать существующий элемент на целевом сайте.
rename Переименуйте элемент.

Примечание:Параметр conflictBehavior не поддерживается для потребителя OneDrive.

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

В тексте запроса предоставьте JSON-объект с указанными ниже параметрами.

Имя Значение Описание
parentReference ItemReference Необязательный. Отсылает к родительскому элементу, в котором будет создана копия.
name string Необязательный. Новое имя копии. Если оно не предоставлено, будет использовано такое же имя, как в оригинале.

Примечание. Элемент parentReference должен включать параметры driveId и id для целевой папки.

Отклик

Возвращает сведения о том, как отслеживать ход копирования после принятия запроса.

Пример

В этом примере показано, как копировать файл с идентификатором {item-id} в папку с идентификатором driveId и значением id. У новой копии файла будет имя contoso plan (copy).txt.

Запрос

POST https://graph.microsoft.com/v1.0/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 будет указано только, что операция копирования была принята или отклонена; например, из-за того, что имя целевого файла уже используется.