Скачивание содержимого ресурса driveItemVersion

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

Получите содержимое определенной версииdriveItem.

Примечание: Получение содержимого текущей версии не поддерживается. Для этого используйте метод Download the contents of a driveItem .

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

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

HTTP-запрос

GET /drives/{drive-id}/items/{item-id}/versions/{version-id}/content
GET /groups/{group-id}/drive/items/{item-id}/versions/{version-id}/content
GET /me/drive/items/{item-id}/versions/{version-id}/content
GET /sites/{site-id}/drive/items/{item-id}/versions/{version-id}/content
GET /users/{user-id}/drive/items/{item-id}/versions/{version-id}/content

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

Отклик

Возвращает ответ, 302 Found перенаправляющийся на URL-адрес скачивания с предварительной проверки подлинности для байтов файла.

Чтобы скачать содержимое файла, приложение должно следовать заголовку Location в ответе. Многие библиотеки клиентов HTTP будут автоматически следовать перенаправлению 302 и немедленно начинать загрузку файла.

URL-адреса загрузки с предварительной проверкой подлинности действительны только в течение короткого периода времени (несколько минут) и не требуют заголовка Authorization для скачивания.

Примеры

Пример 1. Скачивание содержимого предыдущей версии файла

В этом примере показано, как получить версию файла в объекте drive текущего пользователя.

Запрос

GET /me/drive/items/{item-id}/versions/{version-id}/content

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Drives["{drive-id}"].Items["{driveItem-id}"].Versions["{driveItemVersion-id}"].Content.GetAsync();

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Drives().ByDriveId("drive-id").Items().ByDriveItemId("driveItem-id").Versions().ByDriveItemVersionId("driveItemVersion-id").Content().Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.drives().byDriveId("{drive-id}").items().byDriveItemId("{driveItem-id}").versions().byDriveItemVersionId("{driveItemVersion-id}").content().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let stream = await client.api('/me/drive/items/{item-id}/versions/{version-id}/content')
	.get();

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->drives()->byDriveId('drive-id')->items()->byDriveItemId('driveItem-id')->versions()->byDriveItemVersionId('driveItemVersion-id')->content()->get()->wait();

Import-Module Microsoft.Graph.Files

Get-MgDriveItemVersionContent -DriveId $driveId -DriveItemId $driveItemId -DriveItemVersionId $driveItemVersionId

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.drives.by_drive_id('drive-id').items.by_drive_item_id('driveItem-id').versions.by_drive_item_version_id('driveItemVersion-id').content.get()

Отклик

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

HTTP/1.1 302 Found
Location: https://onedrive.com/34FF49D6...

Пример 2. Скачивание частичного диапазона байтов из предыдущей версии файла

Чтобы скачать частичный диапазон байтов из driveItemVersion, приложение может использовать Range заголовок, указанный в RFC 2616. Необходимо добавить Range заголовок при переходе по перенаправлению, а не в запрос для /content.

GET https://onedrive.com/34FF49D6...
Range: bytes=0-1023

Вызов возвращает HTTP 206 Partial Content ответ с диапазоном запросов байтов из файла. Если не удается создать диапазон, заголовок Range может быть проигнорирован, и HTTP 200 будет возвращен ответ с полным содержимым файла.

HTTP/1.1 206 Partial Content
Content-Range: bytes 0-1023/2048

<first 1024 bytes of file>

Примечания

OneDrive не сохраняет полные метаданные для предыдущих версий файла.

Когда приложение получает список доступных версий для файла, возвращается ресурс driveItemVersion , предоставляющий доступные сведения о конкретной версии.