Descripción de los tipos de contenedores y los contenedores

Se aplica a: Desarrollador

Use este artículo para comprender los dos objetos de almacenamiento principales de SharePoint Embedded: tipos de contenedor y contenedores.

Para obtener la referencia completa de creación y administración, consulte Tipos de contenedor de SharePoint Embedded.

Modelo de objetos

SharePoint Embedded almacena los archivos y documentos en contenedores, que se agrupan por tipo de contenedor. Cree un tipo de contenedor antes de poder crear cualquier contenedor para una aplicación.

Objeto Qué representa Quién suele administrarlo
Tipo de contenedor Relación entre una aplicación y un conjunto de contenedores, incluido el acceso, el comportamiento y la responsabilidad de facturación. Desarrollador o propietario del tipo de contenedor.
Contenedor El límite de almacenamiento y seguridad para archivos y carpetas. a través de Microsoft Graph y administradores para las operaciones de gobernanza.

Concepto de tipo de contenedor

Un tipo de contenedor es un recurso de SharePoint Embedded. Define:

  • La aplicación propietaria.
  • Los privilegios de acceso entre aplicaciones y contenedores.
  • El modelo de responsabilidad de facturación.
  • Comportamientos seleccionados que se aplican a los contenedores de ese tipo.

Cada tipo de contenedor está fuertemente acoplado a una aplicación de SharePoint Embedded, denominada aplicación propietaria. SharePoint Embedded requiere una relación de 1:1 entre la aplicación propietaria y el tipo de contenedor. El desarrollador de la aplicación propietaria es responsable de crear y administrar el tipo de contenedor.

Identidad del tipo de contenedor

El tipo de contenedor se representa en cada contenedor como una propiedad inmutable denominada ContainerTypeID. La propiedad se usa en todo el ecosistema de SharePoint Embedded. Afecta a:

  • Autorización de acceso.
  • Exploración de prueba.
  • Facturación.
  • Comportamiento configurable.

Importante

Planifique cuidadosamente el tipo de contenedor. Algunas opciones de creación, como la facturación de prueba frente a la de producción y la facturación estándar frente a la transferida, no se pueden convertir después de la creación. Para cambiar, debe eliminar y volver a crear el tipo de contenedor.

Contenedores

Un contenedor es la unidad de almacenamiento básica en SharePoint Embedded y define un límite de seguridad y cumplimiento. Las aplicaciones crean contenedores en inquilinos consumidores mediante Microsoft Graph. La creación de contenedores requiere una aplicación cliente confidencial, así que planee un componente que contenga un secreto o certificado de cliente. Para obtener más información, consulte Planificar autenticación y permisos.

Los Files, carpetas, metadatos, versiones y contenido de la papelera de reciclaje se almacenan en contenedores y están sujetos a los límites actuales de SharePoint Embedded.

Para conocer los límites, consulte Descripción de los límites y los patrones de llamada.

Ownership

La propiedad del tipo de contenedor y la residencia del contenedor son diferentes. El inquilino desarrollador crea el tipo de contenedor. El inquilino consumidor usa el tipo de contenedor y hospeda contenedores.

Todo el contenido del contenedor creado a través de la aplicación se almacena dentro del límite del inquilino de Microsoft 365 del inquilino consumidor.

Para la arquitectura de inquilinos, consulte Descripción de la arquitectura de aplicaciones e inquilinos.

Autorización de acceso

Una aplicación de SharePoint Embedded debe estar asociada a un tipo de contenedor para tener acceso a los contenedores de ese tipo. Después de la asociación, la aplicación tiene acceso a los contenedores de ese tipo en función de los permisos del tipo de contenedor de aplicación. La aplicación propietaria tiene privilegios de acceso completo de forma predeterminada a los contenedores del tipo de contenedor al que está asociada. El acceso real también depende de si la aplicación usa acceso delegado o acceso solo de aplicación.

Para la planificación de permisos, consulte Planificar autenticación y permisos.

Tipos de contenedores de prueba

Use un tipo de contenedor de prueba para explorar el desarrollo de SharePoint Embedded sin vincular un perfil de facturación de Azure.

Para los tipos de contenedores de prueba:

  • El inquilino desarrollador es el mismo que el inquilino consumidor.
  • Cada desarrollador puede tener un solo tipo de contenedor de prueba en su inquilino a la vez.
  • La versión de prueba es válida durante un máximo de 30 días.
  • Se pueden crear hasta cinco contenedores del tipo de contenedor, incluidos los contenedores activos y los contenedores de la papelera de reciclaje.
  • Cada contenedor tiene hasta 1 GB de almacenamiento.
  • El tipo de contenedor está restringido al inquilino de desarrollador.

Un tipo de contenedor de prueba no se puede convertir a producción.

Para crear un tipo de contenedor de prueba, los desarrolladores pueden usar la extensión de SharePoint Embedded Visual Studio Code o la API de tipo de contenedor de Microsoft Graph.

Los tipos de contenedor se crean con el punto de conexión de Microsoft Graph POST /v1.0/storage/fileStorage/containerTypes , mediante la clasificación de trial facturación. Esta llamada requiere el permiso delegado; no se admite el FileStorageContainerType.Manage.All acceso solo de aplicación. El usuario que llama debe ser un miembro no invitado del inquilino de desarrollador (no se requiere ningún rol de administrador) y se asigna automáticamente como propietario del nuevo tipo de contenedor.

Tipos de contenedores Standard

Se usa un tipo de contenedor estándar para escenarios que no son de prueba.

De forma predeterminada, cada inquilino puede tener 25 tipos de contenedor a la vez; Uno puede ser un tipo de contenedor de prueba gratuita y el resto son tipos de contenedores estándar. Puede solicitar un aumento a través del soporte técnico de Microsoft o su contacto de incorporación de SharePoint Embedded.

Los tipos de contenedor Standard son facturables y deben usar un modelo de facturación.

SharePoint Embedded admite:

  • Facturación Standard (standardclasificación de facturación).
  • Facturación transferida (directToCustomer clasificación de facturación).

Para la selección de facturación, consulte Elegir un modelo de facturación.

Tipo de contenedor de facturación Standard

Con la facturación estándar, los cargos basados en el consumo se facturan al inquilino que posee o desarrolla la aplicación.

El inquilino desarrollador adjunta un perfil de facturación después de crear el tipo de contenedor estándar.

Cree el tipo de contenedor con el punto de conexión de Microsoft Graph POST /v1.0/storage/fileStorage/containerTypes mediante la standard clasificación de facturación y, a continuación, adjunte un perfil de facturación de Azure:

POST https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypes

{
  "name": "{ContainerTypeName}",
  "owningAppId": "{OwningApplicationId}",
  "billingClassification": "standard"
}

Tipo de contenedor de facturación transferida

Con la facturación transferida, los cargos se facturan directamente al inquilino consumidor.

El desarrollador crea el tipo de contenedor con la directToCustomer clasificación de facturación y no adjunta un perfil de facturación en el inquilino de desarrollador.

{
  "name": "{ContainerTypeName}",
  "owningAppId": "{OwningApplicationId}",
  "billingClassification": "directToCustomer"
}

Después del registro, un administrador global del inquilino consumidor configura la facturación en el inquilino consumidor.

Interacción entre Administración y desarrollador

Los desarrolladores y los administradores interactúan con diferentes capas.

Actividad Tipo de contenedor Contenedor
Crear la familia de almacenamiento de la aplicación Sí No
Configurar la relación de la aplicación propietaria Sí No
Configurar la responsabilidad de facturación Sí No
Crear instancias de almacenamiento de aplicaciones No Sí
Almacenar archivos y carpetas No Sí
Aplicación de la gobernanza específica del contenedor No Sí
Eliminar la familia de almacenamiento Sí, después de quitar los contenedores No

Configuración del tipo de contenedor

Los desarrolladores pueden configurar las opciones de tipo de contenedor seleccionadas después de la creación.

Puede configurar estas opciones de tipo de contenedor:

  • ApplicationRedirectUrl
  • DiscoverabilityDisabled
  • SharingRestricted

Uso de la API fileStorageContainerType de Microsoft Graph Update para actualizaciones de tipos de contenedor compatibles. Para obtener la configuración administrativa, consulte Crear aplicaciones con PowerShell.

Registro

Para crear e interactuar con contenedores en un inquilino consumidor, el tipo de contenedor debe estar registrado en ese inquilino.

La aplicación propietaria invoca la API de registro para definir los permisos de aplicación para el tipo de contenedor.

Para obtener más información, consulte Registro de permisos de aplicación de tipo contenedor de almacenamiento de archivos.

Lista de comprobación de la planificación

  • Elige prueba o estándar.
  • Elija la facturación estándar o la facturación transferida para producción.
  • Identifique la aplicación propietaria.
  • Confirme el nombre del tipo de contenedor.
  • Confirme el inquilino o inquilinos consumidores.
  • Planear el registro del tipo de contenedor.
  • Planear permisos de aplicación.
  • Planifique qué opciones de configuración de tipo de contenedor son obligatorias.
  • Planificar el ciclo de vida y la eliminación del contenedor.

Pasos siguientes

Planificar autenticación y autorización: autenticación y permisos del plan.

  • Last updated on