Grundlegendes zu Containertypen und Containern

Gilt für: Entwickler

Verwenden Sie diesen Artikel, um die beiden wichtigsten Speicherobjekte in SharePoint Embedded zu verstehen: Containertypen und Container.

Die vollständige Referenz zur Erstellung und Verwaltung finden Sie unter SharePoint Embedded-Containertypen.

Objektmodell

SharePoint Embedded speichert Dateien und Dokumente in Containern, die nach Containertyp gruppiert sind. Sie erstellen einen Containertyp, bevor Sie Container für eine Anwendung erstellen können.

Objekt	Was es darstellt	Wer verwaltet es in der Regel?
Containertyp	Beziehung zwischen einer App und einer Gruppe von Containern, einschließlich Zugriff, Verhalten und Abrechnungszuverlässigkeit.	Entwickler- oder Containertypbesitzer.
Container	Die Speicher- und Sicherheitsgrenze für Dateien und Ordner.	Anwendung über Microsoft Graph und Administratoren für Governancevorgänge.

Containertypkonzept

Ein Containertyp ist eine SharePoint Embedded-Ressource. Sie definiert Folgendes:

• Die besitzende Anwendung.
• Die Zugriffsrechte zwischen Anwendungen und Containern.
• Das Abrechnungsmodell für die Verantwortlichkeit.
• Ausgewählte Verhaltensweisen, die für Container dieses Typs gelten.

Jeder Containertyp ist stark mit einer SharePoint Embedded-Anwendung gekoppelt, die als besitzereigene Anwendung bezeichnet wird. SharePoint Embedded erfordert eine 1:1-Beziehung zwischen der besitzenden Anwendung und dem Containertyp. Der zuständige Anwendungsentwickler ist für das Erstellen und Verwalten des Containertyps verantwortlich.

Containertypidentität

Der Containertyp wird in jedem Container als unveränderliche Eigenschaft mit dem Namen ContainerTypeIDdargestellt. Die Eigenschaft wird im gesamten SharePoint Embedded-Ökosystem verwendet. Dies wirkt sich auf Folgendes aus:

• Zugriffsautorisierung.
• Testerkundung.
• Abrechnung.
• Konfigurierbares Verhalten.

Wichtig

Planen Sie den Containertyp sorgfältig. Einige Erstellungsoptionen, z. B. Testversion im Vergleich zur Produktion und Standard- und Pass-Through-Abrechnung, können nach der Erstellung nicht konvertiert werden. Um zu wechseln, müssen Sie den Containertyp löschen und neu erstellen.

Container

Ein Container ist die grundlegende Speichereinheit in SharePoint Embedded und definiert eine Sicherheits- und Compliancegrenze. Anwendungen erstellen Container in der Nutzung von Mandanten mithilfe von Microsoft Graph.

Files, Ordner, Metadaten, Versionen und Papierkorbinhalte werden in Containern gespeichert und unterliegen den aktuellen SharePoint Embedded-Grenzwerten.

Informationen zu Grenzwerten finden Sie unter Grundlegendes zu Grenzwerten und Aufrufmustern.

Besitz

Containertypbesitz und Containerresidenz unterscheiden sich. Der besitzereigene Mandant erstellt den Containertyp. Der verbrauchende Mandant verwendet den Containertyp und hostet Container.

Alle containerbezogenen Inhalte, die über die Anwendung erstellt werden, werden innerhalb der Microsoft 365-Mandantengrenze des Nutzens gespeichert.

Informationen zur Mandantenarchitektur finden Sie unter Grundlegendes zur App- und Mandantenarchitektur.

Zugriffsautorisierung

Eine SharePoint Embedded-Anwendung muss einem Containertyp zugeordnet sein, um auf Container dieses Typs zugreifen zu können. Nach der Zuordnung hat die Anwendung Zugriff auf Container dieses Typs gemäß den Berechtigungen vom Typ application-container. Die besitzende Anwendung verfügt standardmäßig über Vollzugriffsberechtigungen für Container des Containertyps, mit dem sie gekoppelt ist. Der tatsächliche Zugriff hängt auch davon ab, ob die App delegierten Zugriff oder nur App-Zugriff verwendet.

Informationen zur Berechtigungsplanung finden Sie unter Planen von Authentifizierung und Berechtigungen.

Testcontainertypen

Verwenden Sie einen Testcontainertyp, um die SharePoint Embedded-Entwicklung zu erkunden, ohne ein Azure Abrechnungsprofil zu verknüpfen.

Für Testcontainertypen:

• Der Entwicklermandant ist identisch mit dem Nutzen des Mandanten.
• Jeder Entwickler kann jeweils nur einen Testcontainertyp in ihrem Mandanten haben.
• Die Testversion ist bis zu 30 Tage gültig.
• Es können bis zu fünf Container des Containertyps erstellt werden, einschließlich aktiver Container und Container im Papierkorb.
• Jeder Container verfügt über bis zu 1 GB Speicher.
• Der Containertyp ist auf den Entwicklermandanten beschränkt.

Ein Testcontainertyp kann nicht in die Produktion konvertiert werden.

Um einen Testcontainertyp zu erstellen, können Entwickler die SharePoint Embedded Visual Studio Code-Erweiterung oder die Microsoft Graph-Containertyp-API verwenden.

Containertypen werden mit dem Microsoft Graph-Endpunkt POST /v1.0/storage/fileStorage/containerTypes unter Verwendung der trial Abrechnungsklassifizierung erstellt. Für diesen Aufruf ist die FileStorageContainerType.Manage.All delegierte Berechtigung erforderlich. Nur-App-Zugriff wird nicht unterstützt. Der aufrufende Benutzer muss ein Nicht-Gastmitglied des besitzenden Mandanten sein (keine Administratorrolle erforderlich) und wird automatisch als Besitzer des neuen Containertyps zugewiesen.

Standard Containertypen

Ein Standardcontainertyp wird für Szenarien ohne Testversion verwendet.

Jeder Mandant kann über 25 Containertypen gleichzeitig verfügen.

Standard Containertypen sind abrechenbar und müssen ein Abrechnungsmodell verwenden.

SharePoint Embedded unterstützt:

• Standard Abrechnung (standardAbrechnungsklassifizierung).
• Passthrough-Abrechnung (directToCustomer Abrechnungsklassifizierung).

Informationen zur Abrechnungsauswahl finden Sie unter Auswählen eines Abrechnungsmodells.

Standard Abrechnungscontainertyp

Bei der Standardabrechnung werden verbrauchsbasierte Gebühren dem Mandanten in Rechnung gestellt, der die Anwendung besitzt oder entwickelt.

Der besitzende Mandant fügt nach dem Erstellen des Standardcontainertyps ein Abrechnungsprofil an.

Erstellen Sie den Containertyp mit dem Microsoft Graph-Endpunkt POST /v1.0/storage/fileStorage/containerTypes mithilfe der standard Abrechnungsklassifizierung, und fügen Sie dann ein Azure Abrechnungsprofil an:

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

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

Passthrough-Abrechnungscontainertyp

Bei der Passthrough-Abrechnung werden Gebühren direkt dem nutzenden Mandanten in Rechnung gestellt.

Der Entwickler erstellt den Containertyp mit der directToCustomer Abrechnungsklassifizierung und fügt kein Abrechnungsprofil im Entwicklermandanten an.

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

Nach der Registrierung richtet ein globaler Administrator im verbrauchenden Mandanten die Abrechnung im verbrauchenden Mandanten ein.

Admin und Entwicklerinteraktion

Entwickler und Administratoren interagieren mit verschiedenen Ebenen.

Aktivität	Containertyp	Container
Erstellen der Speicherfamilie der App	Ja	Nein
Konfigurieren einer eigenen App-Beziehung	Ja	Nein
Konfigurieren der Abrechnungs-Verantwortlichkeit	Ja	Nein
Erstellen von App-Speicherinstanzen	Nein	Ja
Speichern von Dateien und Ordnern	Nein	Ja
Anwenden einer containerspezifischen Governance	Nein	Ja
Löschen der Speicherfamilie	Ja, nach dem Entfernen von Containern	Nein

Konfiguration des Containertyps

Entwickler können ausgewählte Containertypeinstellungen nach der Erstellung konfigurieren.

Sie können die folgenden Containertypeinstellungen konfigurieren:

• ApplicationRedirectUrl
• DiscoverabilityDisabled
• SharingRestricted

Verwenden Sie die Microsoft Graph-UpdatedateiStorageContainerType-API für unterstützte Containertypupdates. Administrative Einstellungen finden Sie unter Erstellen von Apps mit PowerShell.

Registrierung

Um Container in einem nutzenden Mandanten zu erstellen und mit ihnen zu interagieren, muss der Containertyp in diesem Mandanten registriert sein.

Die besitzende Anwendung ruft die Registrierungs-API auf, um Anwendungsberechtigungen für den Containertyp zu definieren.

Ausführliche Informationen finden Sie unter Registrieren von Anwendungsberechtigungen für Den Dateispeichercontainertyp.

Planungscheckliste

• Wählen Sie Testversion oder Standard aus.
• Wählen Sie Standardabrechnung oder Passthroughabrechnung für die Produktion aus.
• Identifizieren Sie die besitzende Anwendung.
• Bestätigen Sie den Containertypnamen.
• Bestätigen Sie, dass der bzw. die verarbeitende Mandant bzw. die Mandanten verwendet werden.
• Planen der Containertypregistrierung.
• Planen von Anwendungsberechtigungen.
• Planen Sie, welche Containertypeinstellungen erforderlich sind.
• Planen des Lebenszyklus und Löschens von Containern.

Nächste Schritte

Planen der Authentifizierung und Autorisierung: Planen Sie die Authentifizierung und Berechtigungen.