Crear y configurar un tipo de contenedor

Se aplica a: Desarrollador

Agregue el servidor de SharePoint Embedded MCP a un agente de codificación con un solo clic:

Agregar a Visual Studio Code

¿Está usando la compilación de la versión preliminar? Agregue el servidor a los participantes de Visual Studio Code Insiders.

Para otros clientes MCP, registre el servidor con el mismo npx comando:

# Claude Code
claude mcp add spe -- npx -y @microsoft/spe-mcp start

# OpenAI Codex CLI
codex mcp add spe -- npx -y @microsoft/spe-mcp start

Instalar la extensión SharePoint Embedded para Visual Studio Code Para crear un tipo de contenedor, configurar la aplicación propietaria y la facturación, registrar el tipo de contenedor, crear contenedores y cargar una aplicación de ejemplo desde una vista guiada en el editor:

Obtenga la extensión desde Visual Studio Marketplace

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

Si está empezando, complete Inicio rápido: Crear su primera aplicación con VS Code. A continuación, use este artículo para tomar decisiones de prueba, estándar y de transferencia.

Para decidir primero entre el modelo de inquilino único y el de varios inquilinos, consulte Elegir un modelo de aplicación.

Descripción de la relación entre los tipos de contenedor

Un tipo de contenedor está fuertemente acoplado a una aplicación de 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 id. de tipo de contenedor se almacena en cada contenedor como una propiedad inmutable.

SharePoint Embedded usa el identificador para la autorización de acceso, la exploración de pruebas, la facturación y los comportamientos configurables.

Nota:

La API de Microsoft Graph API (Create fileStorageContainerType) es de solo delegado y puede ser llamada por cualquier usuario que no sea propietario de un invitado o inquilino. El autor de la llamada no necesita un rol de administrador y se asigna automáticamente como propietario del nuevo tipo de contenedor.

Elija una prueba o producción

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

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

No se puede cambiar un tipo de contenedor de facturación estándar a facturación transferida más adelante.

Caso de uso Tipo de contenedor
Prueba de concepto local Tipo de contenedor de prueba
El inquilino desarrollador paga Tipo de contenedor con facturación estándar
El inquilino consumidor paga Tipo de contenedor con facturación transferida

Importante

Si elige el propósito o el modelo de facturación incorrectos, 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 la aplicación de 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 de Azure y un grupo de recursos.
  • Para administrar la facturación de un tipo de contenedor estándar existente como no administrador, sea propietario de ese tipo de contenedor. Los administradores de SharePoint Embedded y los administradores globales pueden administrar cualquier tipo de contenedor de factura estándar en el inquilino para desarrolladores.
  • Para la configuración de facturación estándar, el acceso de propietario o colaborador a 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 que no sea invitado en el inquilino propietario puede crear uno y se asigna automáticamente como propietario de ese tipo de contenedor. Para las operaciones administrativas de 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.

Crear un tipo de contenedor de prueba

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

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

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

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

Las siguientes restricciones se aplican a los tipos de contenedores 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 cualquier contenedor existente de ese tipo de contenedor.
  • Para crear un nuevo tipo de contenedor de prueba, el desarrollador debe eliminar permanentemente todos los contenedores de un tipo de contenedor existente en estado de prueba. Esto incluye los contenedores de la colección de contenedores eliminada.
  • El tipo de contenedor está restringido a trabajar en el inquilino de desarrollador. No se puede implementar en otros inquilinos consumidores.

Creación de un tipo de contenedor con facturación estándar

Use la facturación estándar cuando el inquilino desarrollador pague por el consumo.

Cada inquilino puede crear hasta 25 tipos de contenedores en total. Uno de estos puede ser un tipo de contenedor de prueba gratuita; El resto son tipos de contenedores estándar (facturados).

  1. Cree o identifique la aplicación de Microsoft Entra ID propietaria.
  2. Cree el tipo de contenedor con la clasificación de standard facturación.
  3. Administrar la facturación en el tipo de contenedor. La extensión SharePoint Embedded Visual Studio Code y el servidor SharePoint Embedded Model Context Protocol (MCP) permiten la administración de facturación para los tipos de contenedor de factura estándar. Los administradores de SharePoint Embedded y los administradores globales también pueden usar PowerShell para administrar la facturación.
  4. Registre el identificador de tipo de contenedor.
  5. Continuar con el registro en el inquilino consumidor.

Nota:

Si se produce un error en la configuración de facturación , SubscriptionNotRegisteredespere varios minutos e inténtelo de nuevo. El Microsoft.Syntex registro del proveedor de recursos puede llevar tiempo.

Crear un tipo de contenedor de facturación de transferencia

Use la facturación transferida cuando el inquilino consumidor pague por el consumo.

  1. Cree o identifique la aplicación de 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 consumidor.
  4. Tener un administrador de facturación o un administrador global en el inquilino consumidor que active los servicios de pago por uso.

Importante

El inquilino consumidor debe completar la configuración de facturación antes de que se pueda usar correctamente una aplicación de transferencia.

Un administrador de facturación o un administrador global del inquilino consumidor activa los servicios de pago por uso en el Centro de administración de Microsoft 365. En Configuración>de facturación y licencias, seleccione Activar servicios de pago por uso.

Sección de licencias y facturación del Centro de administración de Microsoft 365 con la opción 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.

Panel Aplicaciones del Centro de administración de Microsoft 365 con SharePoint Embedded seleccionado para activar la facturación de pago por uso.

Configurar la aplicación de Microsoft Entra ID propietaria

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

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

Solicitar permiso de aplicación de Microsoft Graph FileStorageContainerTypeReg.Selected para el registro del tipo de contenedor en los inquilinos consumidores.

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

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

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

Establecer propiedades básicas

Propiedad Instrucciones
Nombre del tipo de contenedor Usa un nombre duradero que se asigne a tu carga de trabajo.
Id. de aplicación propietario Use el registro de la aplicación que posee este tipo.
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 trial, facturación estándar o facturación transferida en el momento de la creación.

Precaución

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

Configurar el comportamiento del tipo de contenedor

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

Entre las opciones de configuración disponibles se encuentran:

  • urlTemplate
  • isDiscoverabilityEnabled
  • isSharingRestricted

Uso de la API fileStorageContainerType de Microsoft Graph Update para actualizaciones de tipos de contenedor compatibles. Para obtener información sobre la configuración administrativa de todo el inquilino, consulte Creación de aplicaciones con PowerShell.

Importante

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

Ver y actualizar tipos de contenedores

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

El propietario de un tipo de contenedor que no sea administrador puede actualizar los tipos de contenedor de su propiedad. También pueden crear y administrar el perfil de facturación estándar.

El propietario necesita acceso de propietario o colaborador a la suscripción de Azure para los cambios de facturación.

Administración de tipos de contenedores con Microsoft Graph

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

Operación API
Crear un tipo de contenedor Crear fileStorageContainerType
Lista de tipos de contenedores List fileStorageContainerType
Actualizar un tipo de contenedor Actualizar fileStorageContainerType
Eliminar un tipo de contenedor Eliminar fileStorageContainerType

Los resultados de la lista se filtran por propiedad. Los usuarios que no son administradores solo ven los tipos de contenedor para los que se les ha concedido permiso, mientras que los administradores de SharePoint Embedded y los administradores globales ven todos los tipos de contenedor del inquilino. Para conocer las opciones que puede configurar, consulte fileStorageContainerTypeSettings.

Solo puede eliminar tipos de contenedores 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 estándar, el inquilino desarrollador adjunta una suscripción de Azure y un grupo de recursos.

Para la facturación transferida, el inquilino consumidor activa los servicios de pago por uso.

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

Una aplicación multiinquilino suele tener un inquilino propietario y uno o más inquilinos consumidores.

Use esta secuencia para cada inquilino consumidor:

  1. Cree el tipo de contenedor en el inquilino propietario.
  2. Pida al administrador del inquilino consumidor que conceda el consentimiento del administrador.
  3. Registrar los permisos de aplicación de tipo de contenedor.
  4. Configure la facturación transferida cuando pague el inquilino consumidor.
  5. Valide la creación y el acceso a los contenedores.

Pasos siguientes

Registrar permisos en Registrar permisos de aplicación.

  • Last updated on