Creación y configuración de un tipo de contenedor

Se aplica a: Desarrollador

Cree un tipo de contenedor de SharePoint Embedded para que la aplicación cree contenedores o almacene archivos. Un tipo de contenedor define el acceso, la responsabilidad de facturación y los comportamientos seleccionados para los contenedores creados por la aplicación.

Si acaba de empezar, complete Inicio rápido: Compilación de la primera aplicación con VS Code. A continuación, use este artículo para tomar decisiones de prueba, estándar y paso a través.

Para decidir primero entre modelos de inquilino único y multiinquilino, consulte Elegir un modelo de aplicación.

Descripción de la relación de tipo de contenedor

Un tipo de contenedor está fuertemente acoplado con una aplicación Microsoft Entra ID, denominada aplicación propietaria.

SharePoint Embedded requiere una relación uno a uno entre una aplicación propietaria y un tipo de contenedor.

El identificador de tipo de contenedor se almacena en cada contenedor como una propiedad inmutable.

El identificador se usa para la autorización de acceso, la exploración de prueba, la facturación y los comportamientos configurables.

Nota:

El Graph API de Microsoft, Create fileStorageContainerType, es de solo delegado y cualquier usuario que no sea propietario del inquilino puede llamar a él. El autor de la llamada no necesita un rol de administrador y se asigna automáticamente como propietario del nuevo tipo de contenedor.

Elección de prueba o producción

Elija el propósito del tipo de contenedor al crearlo.

No se puede convertir un tipo de contenedor de prueba en producción más adelante.

No puede convertir un tipo de facturación estándar en facturación de paso a través más adelante.

Caso de uso	Tipo de contenedor
Prueba de concepto local	Tipo de contenedor de prueba
El propietario de la aplicación paga	Standard tipo de contenedor con perfil de facturación
El inquilino del cliente paga	Standard tipo de contenedor con facturación de paso a través

Importante

Si elige el modelo de facturación o propósito incorrecto, debe volver a crear el tipo de contenedor.

Requisitos previos

Antes de crear un tipo de contenedor, asegúrese de que tiene:

• Un inquilino de Microsoft 365 con SharePoint disponible.
• Un registro de aplicación Microsoft Entra ID para la aplicación propietaria.
• Una cuenta de miembro no invitado en el inquilino propietario.
• Para la facturación estándar, una suscripción Azure y un grupo de recursos.
• Para la configuración de facturación estándar, permisos de propietario o colaborador en la suscripción de Azure.

Nota:

• La creación de un tipo de contenedor a través de Microsoft Graph solo requiere el FileStorageContainerType.Manage.All permiso delegado. Cualquier usuario no invitado del inquilino propietario puede crear uno y se asigna automáticamente como propietario de ese tipo de contenedor. Para las operaciones administrativas en todo el inquilino, consulte Creación de aplicaciones con PowerShell.

• Los usuarios que se autentican en contenedores deben existir en Microsoft Entra ID como miembros o invitados. No se requiere una licencia de Office para colaborar en documentos de Office almacenados en un contenedor, excepto para experiencias excepcionales documentadas, como menciones.

Creación de un tipo de contenedor de prueba

Use un tipo de contenedor de prueba para la evaluación.

Puede crear uno con la extensión de Visual Studio Code de SharePoint Embedded o Microsoft Graph.

La ruta de acceso Visual Studio Code es más rápida para una primera aplicación. Consulte Inicio rápido: Compilación de la primera aplicación con VS Code.

Para Microsoft Graph, cree el tipo de contenedor con la clasificación de trial facturación.

Las restricciones siguientes se aplican a los tipos de contenedor de prueba:

• El inquilino puede tener hasta cinco contenedores del tipo de contenedor. Esto incluye los contenedores activos y los de la papelera de reciclaje.
• Cada contenedor tiene hasta 1 GB de espacio de almacenamiento.
• El tipo de contenedor expira después de 30 días y, a continuación, se quita el acceso a los contenedores existentes de ese tipo de contenedor.
• El desarrollador debe eliminar permanentemente todos los contenedores de un tipo de contenedor existente en estado de prueba para crear un nuevo tipo de contenedor para la prueba. Esto incluye los contenedores de la colección de contenedores eliminada.
• El tipo de contenedor está restringido para trabajar en el inquilino para desarrolladores. No se puede implementar en otros inquilinos de consumo.

Creación de un tipo de contenedor estándar con facturación del propietario de la aplicación

Use la facturación estándar cuando el inquilino del desarrollador o propietario de la aplicación pague por el consumo.

Cada inquilino puede tener hasta 25 tipos de contenedor estándar a la vez.

1. Cree o identifique la aplicación Microsoft Entra ID propietaria.
2. Cree el tipo de contenedor con la clasificación de standard facturación.
3. Adjunte un perfil de facturación de Azure con la extensión de Visual Studio Code de SharePoint Embedded o un flujo de facturación administrado por el administrador.
4. Registre el identificador de tipo de contenedor.
5. Continúe con el registro en el inquilino de consumo.

Nota:

Si se produce un error en la configuración de facturación con SubscriptionNotRegistered, espere varios minutos y vuelva a intentarlo. El Microsoft.Syntex registro del proveedor de recursos puede tardar tiempo.

Creación de un tipo de contenedor de facturación de paso a través

Use la facturación de paso a través cuando el inquilino de consumo pague por el consumo.

1. Cree o identifique la aplicación Microsoft Entra ID propietaria.
2. Cree el tipo de contenedor con la clasificación de directToCustomer facturación.
3. Registre el tipo de contenedor en el inquilino de consumo.
4. Haga que el administrador de inquilinos que consume active los servicios de pago por uso.

Importante

El inquilino de consumo debe completar la configuración de facturación antes de que una aplicación de paso a través se pueda usar correctamente.

El administrador de inquilinos de consumo activa los servicios de pago por uso en el Centro de administración de Microsoft 365. En Configurar>facturación y licencias, seleccione Activar servicios de pago por uso.

En Servicios de Syntex para, seleccione Aplicaciones y, a continuación, seleccione SharePoint Embedded para habilitar la facturación de la aplicación.

Configuración de la aplicación de Entra propietaria

Configure la aplicación para que pueda poseer exactamente un tipo de contenedor.

Solicitar permisos de Microsoft Graph para el acceso a SharePoint Embedded.

Solicite el permiso de aplicación de Microsoft Graph FileStorageContainerTypeReg.Selected para el registro de tipos de contenedor en inquilinos de consumo.

Use URI de redireccionamiento que coincidan con los clientes de desarrollo y producción.

Use las credenciales adecuadas para flujos delegados o solo de aplicación.

Para obtener más información sobre la autenticación, consulte Configuración de la autenticación y autorización.

Establecimiento de propiedades básicas

Propiedad	Instrucciones
Nombre del tipo de contenedor	Use un nombre duradero que se asigne a la carga de trabajo.
Identificador de la aplicación propietaria	Use el registro de la aplicación que posee este tipo.
Dirección URL de redireccionamiento de la aplicación	Use la dirección URL a la que deben redirigirse los archivos de esta aplicación.
Modelo de facturación	Elija prueba, estándar o paso a través en el momento de la creación.

Precaución

El identificador de tipo de contenedor y el identificador de aplicación propietario no se pueden actualizar más adelante.

Configuración del comportamiento del tipo de contenedor

Los desarrolladores pueden configurar los comportamientos seleccionados después de la creación.

Entre las opciones de configuración disponibles se encuentran:

• ApplicationRedirectUrl
• DiscoverabilityDisabled
• SharingRestricted

Use el archivo de actualización de Microsoft GraphStorageContainerType API para las actualizaciones de tipo de contenedor admitidas. Para obtener información sobre la configuración administrativa en todo el inquilino, consulte Creación de aplicaciones con PowerShell.

Importante

La actualización de la configuración en un tipo de contenedor puede tardar hasta 24 horas en replicarse en todos los inquilinos que consumen. Si se invalida la configuración aplicada a un inquilino consumidor, esas invalidaciones permanecen en su lugar. Algunas configuraciones solo se aplican al contenido nuevo, no al contenido existente.

Visualización y actualización de tipos de contenedor

Use Microsoft Graph para enumerar y actualizar los tipos de contenedor.

Un propietario de tipo de contenedor que no sea administrador puede actualizar los tipos de contenedor que poseen.

Necesita acceso de propietario o colaborador a las suscripciones de facturación para los cambios de facturación.

Administración de tipos de contenedor con Microsoft Graph

También puede administrar los tipos de contenedor con las API de fileStorageContainerType Microsoft Graph.

Operación	API
Creación de un tipo de contenedor	Creación de fileStorageContainerType
Enumerar tipos de contenedor	Archivo de listaStorageContainerType
Actualización de un tipo de contenedor	Actualizar archivoStorageContainerType
Eliminación de un tipo de contenedor	Eliminar archivoStorageContainerType

Los resultados de la lista se filtran por propiedad. Los usuarios que no son administradores ven solo los tipos de contenedor en los que se les ha concedido permiso, mientras que los administradores de SharePoint Embedded y los administradores globales ven cada tipo de contenedor en el inquilino. Para obtener la configuración que puede configurar, consulte fileStorageContainerTypeSettings.

Solo puede eliminar tipos de contenedor de prueba; Todavía no se admite la eliminación de tipos de contenedor estándar. Antes de eliminar un tipo de contenedor, quite todos los contenedores de ese tipo, incluidos los contenedores de la colección de contenedores eliminada.

Descripción de la dependencia de facturación

Para la facturación del propietario de la aplicación, el inquilino del desarrollador adjunta una suscripción Azure y un grupo de recursos.

Para la facturación de paso a través, el inquilino que consume activa los servicios de pago por uso.

Para obtener más información, vea Medidores de SharePoint Embedded y Administración de facturación de SharePoint Embedded.

Vinculación a la incorporación multiinquilino

Una aplicación multiinquilino suele tener un inquilino propietario y uno o varios inquilinos que consumen.

Use esta secuencia para cada inquilino que consume:

1. Cree el tipo de contenedor en el inquilino propietario.
2. Pida al administrador de inquilinos que consume que conceda el consentimiento del administrador.
3. Registrar permisos de aplicación de tipo contenedor.
4. Configure la facturación de paso a través cuando el inquilino de consumo pague.
5. Valide la creación y el acceso del contenedor.

Pasos siguientes

Registrar permisos en Registro de permisos de aplicación.