Creación y administración de contenedores

Se aplica a: Desarrollador

Cree y administre contenedores una vez creado, registrado y autorizado el tipo de contenedor. Los contenedores son la unidad de almacenamiento básica en SharePoint Embedded.

Complete Configure authentication and authorization before you call container API (Configurar autenticación y autorización antes de llamar a las API de contenedor).

Descripción de los contenedores

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

Un contenedor:

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

Para obtener información general sobre la arquitectura, vea Arquitectura de aplicaciones incrustadas de SharePoint.

Conocer el ciclo de vida

Un ciclo de vida de contenedor típico incluye:

  1. Cree un contenedor.
  2. Agregar o confirmar miembros.
  3. Carga y administración de archivos.
  4. Leer o actualizar los metadatos del contenedor.
  5. Recicle un contenedor cuando ya no esté activo.
  6. Restaure un contenedor reciclado cuando sea necesario.
  7. Elimine permanentemente los contenedores durante la limpieza.

Continúe con La carga, descarga y administración de archivos para las operaciones de contenido.

Requisitos previos

Antes de crear contenedores, asegúrese de:

  • El tipo de contenedor existe.
  • El tipo de contenedor se registra en el inquilino de consumo.
  • La aplicación tiene el consentimiento de Microsoft Graph FileStorageContainer.Selected .
  • La aplicación tiene permisos de tipo de contenedor para la operación.
  • En el caso de las llamadas delegadas, el usuario que ha iniciado sesión puede recibir el rol de contenedor necesario.
  • En el caso de los tipos de contenedor de prueba, está dentro de los límites de prueba.

Importante

Los tipos de contenedor de prueba pueden crear hasta cinco contenedores, incluidos los contenedores activos y los contenedores en la papelera de reciclaje.

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

Use el acceso delegado cuando un usuario inicia la creación, el usuario debe ser responsable o el usuario que lo crea debe convertirse en propietario del contenedor.

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

Nota:

A un usuario que crea un nuevo contenedor mediante llamadas delegadas se le asigna automáticamente el rol Propietario.

Creación de un contenedor

Use Microsoft Graph para crear un contenedor de almacenamiento de archivos para el 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.
  2. Incluya la información de 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. Almacenar los metadatos de visualización que necesita la aplicación.
  6. Asigne o confirme la pertenencia a escenarios delegados.

Sugerencia

Almacene el identificador de contenedor en la base de datos de la aplicación como el vínculo duradero entre el objeto empresarial y el contenedor de SharePoint Embedded.

Creación de un contenedor en Visual Studio Code

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

  1. Abra la vista De SharePoint Embedded.

  2. Expanda el tipo de contenedor de prueba registrado.

  3. Haga clic con el botón derecho en Contenedores.

  4. Seleccione Crear contenedor.

  5. Escriba un nombre.

  6. Confirme que el contenedor aparece en el tipo de contenedor.

Consulte Inicio rápido: Compilación de la primera aplicación con VS Code para obtener el flujo de extensión.

Enumerar contenedores

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

Para ver la forma de API canónica, consulte Lista de contenedores.

Al enumerar contenedores:

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

Nota:

Actualmente, los contenedores de lista delegados se devuelven 403 Forbidden si el usuario no tiene OneDrive. Esta dependencia no se aplica a las llamadas de lista de solo aplicación.

Obtención de 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 visualización, comprobar el tipo de contenedor, comprobar el estado antes de las operaciones de archivo y confirmar la restauración.

Vincule las implementaciones al tipo de recurso fileStorageContainer.

Actualización de metadatos de contenedor

Actualice los metadatos cuando cambien las propiedades admitidas.

Antes de actualizar:

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

Eliminación o reciclaje de un contenedor

Use el comportamiento de eliminación cuando un contenedor ya no esté activo.

Antes de la eliminación:

  • Confirme que el autor de la llamada tiene permiso.
  • Confirme que la aplicación tiene referencias empresariales archivadas.
  • Decida si el contenedor debe reciclarse primero.
  • Explicar las opciones de restauración.

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

Restauración de un contenedor reciclado

Un flujo de restauración debe:

  1. Identifique el contenedor reciclado.
  2. Confirme que el autor de la llamada tiene permiso.
  3. Restaure el contenedor.
  4. Actualizar el estado de la aplicación.
  5. Confirme que los archivos y los metadatos están disponibles.
  6. Notificar al usuario.

Importante

En el caso de los tipos de contenedor de prueba, los contenedores de la papelera de reciclaje siguen contando para el límite de cinco contenedores.

Eliminación permanente de contenedores

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 el cumplimiento de los requisitos de ciclo de vida.

Validación de operaciones de ciclo de vida

Cree una prueba de humo:

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

Solución de problemas de ciclo de vida

Síntoma Cheque
Se produce un error en la creación Registro y Create permiso.
Se produce un error en la creación delegada Comportamiento de asignación de roles y consentimiento del usuario.
Se produce un error en la lista para el usuario delegado Dependencia de OneDrive indicada en el artículo de autenticación.
Se produce un error en la eliminación Delete permiso y rol de propietario de usuario.
Se produce un error en la creación de la prueba Es posible que los contenedores activos y reciclados hayan alcanzado el límite.
Error en la eliminación del tipo de contenedor Primero se deben quitar todos los contenedores activos y eliminados.

Pasos siguientes

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

  • Last updated on