driveItem: copy

名前空間: microsoft.graph

新しい親アイテムの下に、または新しい名前を指定して、driveItem (すべての子を含む) のコピーを非同期に作成します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) Files.ReadWrite Files.ReadWrite.All、Sites.ReadWrite.All
委任 (個人用 Microsoft アカウント) 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 発生した場合の動作をカスタマイズするためのクエリ パラメーターをサポートします。

説明
fail 既定の動作は、エラーを報告することです。
replace ターゲット サイトの既存のアイテムを上書きします。
rename アイテムの名前を変更します。

メモ:conflictBehavior は、OneDrive コンシューマーではサポートされていません。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。

名前 説明
parentReference ItemReference 省略可能。 コピーが作成される親アイテムへの参照。
name string 省略可能。 コピーの新しい名前。 これを指定しない場合は、元の名前と同じ名前が使用されます。

注:parentReference には、ターゲット フォルダーの driveIdid パラメーターを含める必要があります。

応答

要求の受け入れ時に、コピーの進行状況を監視する方法についての詳細を返します。

この例では、{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 からの応答は、コピー操作が受け入れられたか拒否されたことを示すだけです。たとえば、コピー先のファイル名が既に使用されているためです。