Compartilhar via


Obter arquivo por contentStream

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Baixar o conteúdo do fluxo principal (arquivo) de um driveItem. Somente objetos driveItem com a propriedade do arquivo podem ser baixados.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante) Files.Read Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft) Files.Read Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Application Files.Read.All Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Solicitação HTTP

GET /drives/{drive-id}/items/{item-id}/contentStream
GET /groups/{group-id}/drive/items/{item-id}/contentStream
GET /me/drive/root:/{item-path}:/contentStream
GET /me/drive/items/{item-id}/contentStream
GET /shares/{shareIdOrEncodedSharingUrl}/driveItem/contentStream
GET /sites/{siteId}/drive/items/{item-id}/contentStream
GET /users/{userId}/drive/items/{item-id}/contentStream

Parâmetros de consulta opcionais

Esse método não dá suporte a métodos de consulta.

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Intervalo bytes={range-start}-{range-end}/{size}. Opcional. Use para baixar um intervalo parcial de bytes do arquivo. Especificado no RFC 2616.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedido, esse método retornará um 200 OK código de resposta HTTP.

Exemplos

Exemplo 1: Baixar conteúdo de arquivo

O exemplo a seguir mostra como baixar um arquivo.

Solicitação

GET https://graph.microsoft.com/beta/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4uGj5HgEi4guyuYp4W5SbH4dPfXTbCF/items/014Y52UITTNSVUQI43PZBJMKLAY6LJBUVE/contentStream

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 OK
Content-Type: text/plain

<File Content>

Exemplo 2: baixar um intervalo parcial de bytes

Para baixar um intervalo parcial de bytes do arquivo, seu aplicativo pode usar o Range cabeçalho, conforme especificado no RFC 2616.

Solicitação

GET https://graph.microsoft.com/beta/drives/b!fMInbiL5dkK51VbATG0ddrCg6AJpEj9Lm4uGj5HgEi4guyuYp4W5SbH4dPfXTbCF/items/014Y52UITTNSVUQI43PZBJMKLAY6LJBUVE/contentStream
Range: bytes=0-1023

Resposta

A chamada retorna uma 206 Partial Content resposta HTTP com o intervalo solicitado de bytes do arquivo. Se o intervalo não puder ser gerado, o Range cabeçalho será ignorado e uma 200 OK resposta HTTP será retornada com o conteúdo completo do arquivo.

HTTP/1.1 206 Partial Content
Content-Type: text/plain

<First 1024 bytes of the file>