Descripción de los tipos de contenedor y los contenedores

Se aplica a: Desarrollador

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

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

Modelo de objetos

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

Objeto	Lo que representa	¿Quién lo administra normalmente?
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.	Propietario del tipo de contenedor o desarrollador.
Contenedor	Límite de almacenamiento y seguridad para archivos y carpetas.	Aplicación a través de Microsoft Graph y administradores para operaciones de gobernanza.

Concepto de tipo de contenedor

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

• La aplicación propietaria.
• Privilegios de acceso entre aplicaciones y contenedores.
• Modelo de responsabilidad de facturación.
• Comportamientos seleccionados que se aplican a contenedores de ese tipo.

Cada tipo de contenedor está fuertemente acoplado con una aplicación de SharePoint Embedded, denominada aplicación propietaria. SharePoint Embedded requiere una relación 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

Planee cuidadosamente el tipo de contenedor. Algunas opciones de creación, como la prueba frente a la producción y la facturación estándar frente a la facturación de paso a través, 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 de consumo mediante Microsoft Graph.

Files, las carpetas, los metadatos, las versiones y el 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 de contenedores son diferentes. El inquilino propietario crea el tipo de contenedor. El inquilino de consumo usa el tipo de contenedor y hospeda contenedores.

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

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 contenedores de ese tipo. Después de la asociación, la aplicación tiene acceso a contenedores de ese tipo según los permisos de 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 con el que está acoplada. El acceso real también depende de si la aplicación usa el acceso delegado o el acceso solo a la aplicación.

Para obtener información sobre el planeamiento de permisos, consulte Planear la autenticación y los permisos.

Tipos de contenedor de prueba

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

Para los tipos de contenedor de prueba:

• El inquilino para desarrolladores es el mismo que el inquilino que consume.
• Cada desarrollador solo puede tener un tipo de contenedor de prueba en su inquilino a la vez.
• La 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 del desarrollador.

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

Para crear un tipo de contenedor de prueba, los desarrolladores pueden usar la extensión Visual Studio Code de SharePoint Embedded 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 a la aplicación. El usuario que realiza la llamada debe ser un miembro no invitado del inquilino propietario (no se requiere ningún rol de administrador) y se asigna automáticamente como propietario del nuevo tipo de contenedor.

Standard tipos de contenedor

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

Cada inquilino puede tener 25 tipos de contenedor a la vez.

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

SharePoint Embedded admite:

• Standard facturación (standardclasificación de facturación).
• Facturación de paso a través (directToCustomer clasificación de facturación).

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

Standard tipo de contenedor de facturación

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 propietario 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 Azure:

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

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

Tipo de contenedor de facturación de paso a través

Con la facturación de paso a través, los cargos se facturan directamente al inquilino de consumo.

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 del desarrollador.

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

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

Administración y la interacción del desarrollador

Los desarrolladores y administradores interactúan con diferentes capas.

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

Configuración del tipo de contenedor

Los desarrolladores pueden configurar los valores de tipo de contenedor seleccionados después de la creación.

Puede configurar estos valores de tipo de contenedor:

• ApplicationRedirectUrl
• DiscoverabilityDisabled
• SharingRestricted

Use el archivo de actualización de Microsoft GraphStorageContainerType API para las actualizaciones de tipo de contenedor admitidas. Para ver la configuración administrativa, consulte Creación de aplicaciones con PowerShell.

Registro

Para crear e interactuar con contenedores en un inquilino de consumo, el tipo de contenedor debe registrarse 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 detalles completos, consulte Registro de permisos de aplicación de tipo contenedor de almacenamiento de archivos.

Lista de comprobación de la planificación

• Elija prueba o estándar.
• Elija facturación estándar o facturación de paso a través para producción.
• Identifique la aplicación propietaria.
• Confirme el nombre del tipo de contenedor.
• Confirme el inquilino o los inquilinos que consumen.
• Planear el registro del tipo de contenedor.
• Planear permisos de aplicación.
• Planee qué configuración de tipo de contenedor es necesaria.
• Planear el ciclo de vida y la eliminación del contenedor.

Pasos siguientes

Planear la autenticación y autorización: planee la autenticación y los permisos.