Crear y administrar contenedores

Se aplica a: Desarrollador

Cree y administre contenedores después de que su tipo de contenedor se haya creado, registrado y autorizado. Los contenedores son la unidad de almacenamiento básica en SharePoint Embedded.

Complete la configuración de autenticación y autorización antes de llamar a las API del contenedor.

Descripción de los contenedores

Todos los archivos y documentos de SharePoint Embedded se almacenan en contenedores.

Contenedor:

• Pertenece a un inquilino de Microsoft 365 consumidor.
• Tiene un identificador de tipo de contenedor inmutable.
• Almacena contenido para la aplicación.
• Define un límite para la pertenencia y los permisos.
• Se accede a él a través de Microsoft Graph.

Para obtener información general sobre la arquitectura, consulte Arquitectura de aplicaciones de SharePoint Embedded.

Conocer el ciclo de vida

Un ciclo de vida típico de un contenedor incluye:

1. Crear un contenedor.
2. Agregar o confirmar miembros.
3. Cargar y administrar archivos.
4. Leer o actualizar metadatos del contenedor.
5. Reciclar un contenedor cuando ya no está activo.
6. Restaure un contenedor reciclado cuando sea necesario.
7. Eliminar contenedores de forma permanente durante la limpieza.

Continúe cargando, descargando y administrando archivos para las operaciones de contenido.

Requisitos previos

Antes de crear los contenedores, asegúrese de lo siguiente:

• El tipo de contenedor existe.
• El tipo de contenedor se registra en el inquilino consumidor.
• La aplicación cuenta con el consentimiento de Microsoft Graph FileStorageContainer.Selected .
• La aplicación tiene permisos de tipo de contenedor para la operación.
• La aplicación adquiere su token como cliente confidencial porque la creación del contenedor lo requiere.
• En el caso de las llamadas delegadas, el usuario que ha iniciado sesión puede recibir el rol de contenedor necesario.
• En cuanto a los tipos de contenedores de prueba, está dentro de los límites de la prueba.

Uso de un cliente confidencial para crear contenedores

La creación de un contenedor requiere una aplicación cliente confidencial . Un cliente confidencial tiene una credencial, como un secreto o un certificado de cliente, y adquiere tokens de un componente que mantiene esa credencial privada, como un back-end de una aplicación web o un servicio.

Crear contenedor Las llamadas que usan un token de una aplicación cliente pública producen un error porque los tokens de cliente públicos son accesibles para el usuario final y se pueden reutilizar sin que la aplicación lo sepa. Los clientes públicos incluyen aplicaciones de página única, aplicaciones móviles y aplicaciones de escritorio.

Este requisito se aplica tanto a la creación delegada como a la creación de aplicaciones:

• Para la creación delegada, adquiera el token con el flujo de código de autorización y una credencial de cliente y, a continuación, llame a Microsoft Graph desde el back-end.
• Para la creación de solo aplicaciones, adquiera el token con el flujo de credenciales de cliente, que siempre es confidencial.

Si la aplicación tiene un front-end de cliente público, enrute la creación de contenedores a través de un servicio back-end confidencial en lugar de llamar a Microsoft Graph desde el cliente.

Para obtener más información, vea Aplicaciones cliente públicas y cliente confidencial.

Elija la creación delegada o solo de aplicación

Usar acceso delegado Cuando un usuario inicie la creación, el usuario debe ser responsable o el usuario creador debe convertirse en propietario del contenedor.

Use el acceso de solo aplicación cuando un servicio aprovisiona contenedores, no hay ningún usuario presente y la aplicación tiene permiso para crear contenedores.

Crear un contenedor

Use Microsoft Graph para crear un contenedor de almacenamiento de archivos para su tipo de contenedor registrado.

Para obtener la forma de API canónica, consulte Create fileStorageContainer.

Pasos de implementación:

1. Adquiera un token de Microsoft Graph válido de un cliente confidencial.
2. Incluya la información del tipo de contenedor de destino requerida por la API.
3. Envíe la solicitud de creación.
4. Almacene el identificador de contenedor devuelto.
5. Almacene los metadatos de visualización que necesita la aplicación.
6. Asigne o confirme la pertenencia para escenarios delegados.

Crear un contenedor en Visual Studio Code

Para el desarrollo de prueba, la extensión Visual Studio Code puede crear contenedores.

1. Abrir la vista de SharePoint Embedded.
2. Expande el tipo de contenedor de prueba registrada.
3. Haga clic con el botón derecho en Contenedores.
4. Seleccione Crear contenedor.
5. Escriba un nombre.
6. Confirme que el contenedor aparece debajo del tipo de contenedor.

Consulte Inicio rápido: Crear su primera aplicación con VS Code para el flujo de extensión.

Enumerar contenedores

Enumere los contenedores para mostrar los contenedores disponibles, validar el aprovisionamiento o ejecutar el mantenimiento.

Para obtener la forma de API canónica, consulte Enumerar contenedores.

Al enumerar los contenedores:

• Use el acceso de solo aplicación para escenarios de inventario de servicios.
• Use el acceso delegado solo cuando el contexto de usuario sea adecuado.
• Gestionar paginación.
• Asigne resultados a los datos de la aplicación.

Obtener un contenedor

Obtenga un contenedor cuando necesite los metadatos más recientes antes de actuar.

Use esta operación para confirmar que el contenedor existe, leer las propiedades de pantalla, comprobar el tipo de contenedor, comprobar el estado antes de las operaciones de archivo y confirmar la restauración.

Vincular implementaciones al tipo de recurso fileStorageContainer.

Actualizar metadatos del contenedor

Actualice los metadatos cuando cambien las propiedades admitidas.

Antes de actualizar:

1. Confirma que la aplicación tiene permiso de tipo Write de contenedor.
2. Confirme que el usuario delegado tiene un rol adecuado.
3. Leer el estado actual del contenedor.
4. Aplicar solo los cambios previstos.
5. Valide la respuesta.

Eliminar o reciclar un contenedor

Recicle o elimine un contenedor cuando ya no esté activo.

Antes de la eliminación:

• Confirme que la persona que llama tiene permiso.
• Confirma que tu aplicación tiene referencias empresariales archivadas.
• Decide si el contenedor debe reciclarse primero.
• Indicar a los usuarios cómo pueden restaurar un contenedor reciclado.

La extensión Visual Studio Code incluye funcionalidades de reciclaje y recuperación para el desarrollo de pruebas.

Restaurar un contenedor reciclado

Un flujo de restauración debe:

1. Identifica el contenedor reciclado.
2. Confirme que la persona que llama tiene permiso.
3. Restaure el contenedor.
4. Actualice el estado de la aplicación.
5. Confirme que los archivos y metadatos están disponibles.
6. Notificar al usuario.

Eliminar contenedores de forma permanente

Elimine permanentemente solo cuando esté seguro de que el contenedor ya no es necesario.

Debe quitar todos los contenedores de un tipo de contenedor, incluidos los contenedores eliminados, antes de eliminar el propio tipo de contenedor.

Use la eliminación permanente para la limpieza de prueba, la eliminación de datos de prueba, la retirada de un tipo de contenedor o para cumplir con los requisitos del ciclo de vida.

Validar las operaciones del ciclo de vida

Crear una prueba de humo:

1. Cree un contenedor de prueba.
2. Recuperarlo por identificador.
3. Enumere los contenedores y confirme que aparece.
4. Actualizar un valor de metadatos admitido.
5. Cargue un archivo pequeño.
6. Recicle o elimine el contenedor.
7. Restáurela si es compatible.
8. Elimínelo permanentemente durante la limpieza.

Solucionar problemas del ciclo de vida

Pasos siguientes

Agregue operaciones de archivo en Cargar, descargar y administrar archivos.