Cargar o reemplazar el contenido de un elemento de unidad

Espacio de nombres: microsoft.graph

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

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

Esta API está disponible en las siguientes implementaciones en la nube nacional.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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í" a un archivo de la unidad del usuario que ha iniciado sesión en la carpeta A denominada 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 realiza 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.

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.