Cargar o reemplazar el contenido de un driveItem

Espacio de nombres: microsoft.graph

Proporcione el contenido de un nuevo archivo o actualice el contenido de un archivo existente en una sola llamada API. Este método solo admite archivos de hasta 250 MB.

Para cargar archivos grandes, consulte Carga de archivos grandes con una sesión de carga.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Solicitud HTTP

Para reemplazar un elemento existente

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

Para cargar un archivo nuevo

PUT /drives/{drive-id}/items/{parent-id}:/{filename}:/content
PUT /groups/{group-id}/drive/items/{parent-id}:/{filename}:/content
PUT /me/drive/items/{parent-id}:/{filename}:/content
PUT /sites/{site-id}/drive/items/{parent-id}:/{filename}:/content
PUT /users/{user-id}/drive/items/{parent-id}:/{filename}:/content

Cuerpo de solicitud

El contenido del cuerpo de la solicitud debe ser la secuencia binaria del archivo que se cargará.

Respuesta

Si se ejecuta correctamente, este método devuelve un objeto driveItem en el cuerpo de la respuesta del archivo que se ha creado o actualizado.

Ejemplo (se carga un nuevo archivo)

En este ejemplo se carga la cadena "El contenido del archivo va aquí" en un archivo de la unidad del usuario que ha iniciado sesión en FolderA denominado FileB.txt.

PUT https://graph.microsoft.com/beta/me/drive/root:/FolderA/FileB.txt:/content
Content-Type: text/plain

The contents of the file goes here.

Respuesta

Si se ejecuta correctamente, este método devuelve un recurso driveItem en el cuerpo de la respuesta para el archivo recién creado o actualizado.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

Ejemplo (actualizar un archivo existente)

Este ejemplo reemplaza el contenido de un archivo con un identificador conocido.

PUT https://graph.microsoft.com/beta/me/drive/items/{item-id}/content
Content-Type: text/plain

The contents of the file goes here.

mgc-beta drives items content put --drive-id {drive-id} --drive-item-id {driveItem-id} --body 'The contents of the file goes here.\
'

const options = {
	authProvider,
};

const client = Client.init(options);

const stream = The contents of the file goes here.;

await client.api('/me/drive/items/{item-id}/content')
	.version('beta')
	.put(stream);

Import-Module Microsoft.Graph.Beta.Files

$params = The contents of the file goes here.


Set-MgBetaDriveItemContent -DriveId $driveId -DriveItemId $driveItemId -BodyParameter $params

Respuesta

Si se ejecuta correctamente, este método devuelve un recurso driveItem en el cuerpo de la respuesta del archivo que se ha creado.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "0123456789abc",
  "name": "FileB.txt",
  "size": 35,
  "file": { }
}

Respuestas de error

Vea Respuestas de error para obtener los detalles sobre la manera en que se devuelven los errores.