DriveItem をコピーするCopy a DriveItem

新しい親アイテムの下に、または新しい名前を指定して、driveItem (すべての子を含む) のコピーを非同期に作成します。Asynchronously creates a copy of an driveItem (including any children), under a new parent item or with a new name.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Files.ReadWrite、Files.ReadWrite.All、Sites.ReadWrite.AllFiles.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) Files.ReadWrite、Files.ReadWrite.AllFiles.ReadWrite, Files.ReadWrite.All
アプリケーションApplication Files.ReadWrite.All、Sites.ReadWrite.AllFiles.ReadWrite.All, Sites.ReadWrite.All

HTTP 要求HTTP request

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

要求本文Request body

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。In the request body, provide a JSON object with the following parameters.

名前Name Value 説明Description
parentReferenceparentReference ItemReferenceItemReference 省略可能。コピーが作成される親アイテムへの参照。Optional. Reference to the parent item the copy will be created in.
namename stringstring 省略可能。コピーの新しい名前。これを指定しない場合は、元の名前と同じ名前が使用されます。Optional. The new name for the copy. If this isn't provided, the same name will be used as the original.

注: parentReference には、ターゲット フォルダーの driveIdid パラメーターを含める必要があります。Note: The parentReference should include the driveId and id parameters for the target folder.

Example

この例では、{item-id} で識別されるファイルを driveId および id の値で識別されるフォルダーにコピーします。This example copies a file identified by {item-id} into a folder identified with a driveId and id value. ファイルの新しいコピーの名前は contoso plan (copy).txt になります。The new copy of the file will be named 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"
}

応答Response

要求の受け入れ時に、コピーの進行状況を監視する方法についての詳細を返します。Returns details about how to monitor the progress of the copy, upon accepting the request.

HTTP/1.1 202 Accepted
Location: https://contoso.sharepoint.com/_api/v2.0/monitor/4A3407B5-88FC-4504-8B21-0AABD3412717

Location ヘッダーの値は、コピー操作の現在の状況を返すサービスの URL を提供します。 この情報を使用して、コピーがいつ終了したかを判断することができます。The value of the Location header provides a URL for a service that will return the current state of the copy operation. You can use this info to determine when the copy has finished.

備考Remarks

多くの場合、コピー操作は非同期で実行されます。API からの応答は、コピー操作が受け入れられたか、コピー先のファイル名が既に使用中のためという理由で拒否されたことのみを示します。In many cases the copy action is performed asynchronously. The response from the API will only indicate that the copy operation was accepted or rejected, say due to the destination filename already being in use.